Ligg.EasyWinApp-101-Ligg.EasyWinForm: Application--启动，传入参数、读取Application级别配置文件、验证密码、软件封面、启动登录、StartForm

首先请在VS里打开下面的文件，我们将对源码分段进行说明：

步骤1：读取debug.ini文件

首先读取当前文件夹（.\Clients\Form）的debug.ini文件，该文件的args用于调试时传参，这样就不用每次都要到[Project/Properties]去设置[Commamd line argument]。在debug阶段设置debug=true；在release阶段设置debug=false,或者直接把该文件删除。如果运行.\Clients\Form\Run.exe没有带参数，传递参数就采用debug.ini文件的args。

步骤2：实例化BootStrap

    这段代码逻辑：先从授权证书读取数据，再把Key赋值给EncryptionHelper。

GlobalConfiguration（位于Ligg.EasyWinApp.ImplInterface \GlobalConfiguration.cs ）是Ligg.EasyWinForm项目和Ligg.EasyWinApp.Impl.xxxxCblp项目都可以访问的一个静态类。

EncryptionHelper（位于Ligg.Winform\Base\Helpers\ EncryptionHelper.cs）是一个加密解密的静态类。

 

步骤3：传参分解

传参arg[0]之间以@分隔，arg[1] 即passedCultureName表示起始的Culture，下面是对传参的解释：

//##passedArg0 format

//###formTypeStr=0，multiple view      

//invisibleStr@formTypeStr=0/multipleview@startAppStr@startFuncStr   @startViewMenuIdStr@startParams@startActionsStr@passwordStr@formTitle@usrCode@usrToken  passedCultureName

//###formTypeStr=1，single view

//invisibleStr@formTypeStr=1/singleviewk@startAppStr@startZoneLocStr@inputZoneVars      @startParams@startActionsStr@passwordStr@formTitle@usrCode@usrToken  passedCultureName

formTypeStr=0 表示mutiple view，指用单窗体模拟多窗体的情况；formTypeStr=1，表示single view，指单个Zone组成一个窗体（这个在以后的章节里会详细介绍）。2种情况的传参有所区别。

2种情况的公用的传参：

invisibleStr=0或为空值表示窗体可见，否则不可见。这个暂时没有实现。

startAppStr=xxxx表示开始的应用（Application）。每个应用，对应一个Ligg.EasyWinApp.Impl.xxxxCblp项目,即对应一个xxxxCblp.dll（为了方便叙述，我们暂且把它称为后台），核心业务逻辑的处理都会放在这个dll里。每个应用都对应一整套配置放在.\Applications\xxxx(application name)文件夹下

startParams：应用级别参数，用‘,‘符号相隔。既会传给前台的StartForm，也会传给后台。满足需求的各种可选性。

startActionsStr：启始动作，只传给前台，在StartForm初始化完成后，会运行 StartForm里的Act方法一次。如弹出一个提示框或运行后台的某个服务的方法等。

passwordStr：启始密码，如果应用的配置要求输入密码，该参数如果不为空值且验证通过，则不会弹出弹窗。

formTitle：StartForm的Text; 如果为空值，StartForm的Text将会去abbrevAnnexes.xml按Function/Zone的Name读取。

usrCode ：启动时传递的用户登录名。登录后会存储在GlobalConfiguration.UserCode里,由前台读取显示。

usrToken：启动时传递的用户登录令牌，登录时由后台的UserServic.Logon()产生并存储在GlobalConfiguration.UserToken里。由一个应用跳转到另（同）一个应用时会带这个参数，如验证通过，就不用再弹出登录窗口。这样可实现各应用间的SSO(单点登录)。

multiple view情况下：

startFuncStr: 开始的功能(Function)，就是指一个Form,一套界面。如一个应用有管理员界面和用户界面，所以有2个Function。Function的配置在 .\Application\xxxx(application)\Clients\Form\Functions\yyyy(function name)下。

startViewMenuIdStr:开始时的展示的View的菜单Id。如果为空，就会使用默认的展示View。

single view情况下：

startZoneLocStr: 开始的Zone的位置，zone会加入Public View,形成一个独立的Function。Zone的配置在 .\Application\xxxx(application)\Clients\Form\Zones\zzzz(Zone)下。

inputZoneVars: Zone级别参数，用‘,‘符号相隔。会传给前台的StartForm，在Zone 初始化时传入Zone，如果需求的可选项多的话，通过这个参数，不用定义很多Zone，只在Zone里配置选项就行了。

步骤4：设置路径，读取和设置应用启动参数

在BootStrap的SetPaths方法里，当前路径已经被设置到执行文件的祖父目录。

然后从配置文件.\Applications\xxxx(application)\ApplicationStartParamSet.xml 读取并设置ApplicationStartParamSet的各属性。

ImplementationDllPath， AdapterFullClassName用于加载应用的Cblp的Dll；下面会介绍。

SupportMultiCultures是否支持多文化，如果为false的话，界面上右上角不会显示文化/语言切换的部分。所有控件的显示不会从各个Annexes.xml读取，前台界面也不用配置各个Annexes.xml。

VerifyPasswordAtStart/ShowSoftwareCoverAtStart/LogonAtStart既在ApplicationStartParamSet里配置，也可以在FunctionStartParamSet里配置，以ApplicationStartParamSet的配置为主。就是说，如果在 ApplicationStartParamSet配置为 true, FunctionStartParamSet里的配置不生效；如果在 ApplicationStartParamSet配置为false的话，可以在FunctionStartParamSet配置为true。假如每个 Function,每个Zone的配置由不同的人协作完成，在事关安全验证的配置上面，如果不必须验证，可以由参与人员根据需要来设置，如果必须验证，则总体控制。

其他属性都是起始验证的一些设置，大家可以根据软件需要来补充或扩展代码，这里不多赘述。

步骤5：设置Culture

读取配置文件.\Applications\xxxx(Aplication)\Cultures\ Cultures.xml，设置静态类CultureHelper的缺省、当前的Culture；CultureHelper位于Ligg.Winform\Base\Helpers\ CultureHelper.cs。

步骤6：验证起始密码

大家可以追踪代码，这段代码就是弹出一个对话框验证起始密码。验证规则在ApplicationStartParamSet.PasswordVerificationRule里配置。

步骤7：设置功能（Function）起始参数，作为StartForm的属性

//##set funcInitParamSet下的部分。大家可以自行查看。

步骤8：初始化应用的核心业务处理动态链接库 (CBLP.Dll)

首先bootStrap.InitGlobalConfiguration把各参数传递给GlobalConfiguration供前台后台使用。

然后CblpDllAdapter.Init初始化应用的CBLP.dll。详见上面代码，如果是调试阶段是直接实例化一个CBLP.dll的接口实施类Apdaper,这样就可以方便debug；如果是发布阶段，是加载CBLP.dll的接口实施类Adapter。

    加载CBLP.dll的接口实施类Adapter的优点：由于界面是由配置文件来决定的，所有应用共用一套启动和前台的代码，这些代码可以做到千年不变；由于基本过程控制和功能也是由配置文件来决定，所以后台cblp.dll可以只包括核心业务逻辑处理的代码，可以写的非常简单，写成函数式的就行了，如果有变动，修改后直接覆盖各cblp.dll就行了。按我多年的实施经验（不是代码经验），需求变更和多样化不大会体现在核心业务逻辑处理的代码修改，往往体现在界面/选项/流程上，这些如果可以通过配置来满足的话，那么这套框架就的价值就体现出来了。

步骤9：展示软件封面

实际上就是实例化一个single view的StartForm，这个看了后面章节的介绍就明白了。

步骤10：验证用户登录令牌和登录

为什么启动时会有用户登录令牌呢？这是由已启动的本应用或其他应用的实例通过System.Diagnostics.Process转过来的。如果前面的应用已登录，启动本应用时，用户登录令牌经过验证OK,那么就不用再登陆了,这也算实现单点登录吧。如果做成和Windows域帐号集成，只要从域的机器上启动本应用都不用登录就更完善了。

登录也是实例化一个single view的StartForm。比显示软件封面稍微复杂的地方，是它要与后台的Userservice互动 ，验证登录密码，同时把USerCode和UserToken存储到GlobalConfiguration。这些都是通过配置实现的。看了后面章节的介绍就明白了。

步骤11：实例化StartForm

最后就是用funcInitParamSet参数实例化StartForm。

    请在VS里打开下面的文件StartForm.cs

下面是代码， 首先在构造函数里把CblpDllAdapter.Adapter赋值给_Adapter，然后后台的各服务的方法全部通过各重载方法调用。

各重载方法：

请至 https://github.com/Liggin2019/Ligg.EasyWinApp/blob/master/demo/demo.rar下载，运行Form-MutiView-ITSmaoa-AdmKt2和Form-MutiView-ITSmaoa-AdmKt3相关执行文件，查看其启动的配置。

StartForm布局（Layout）的各组成元素、样式怎么配合配置文件生成和变化，请看下一章节文档。

Ligg.EasyWinApp-102-Ligg.EasyWinForm：Function--ControlBox、Tray、Resize、Menu