开发准备环境

在开发的过程中请满足如下环境要求。

创建工程

1. 打开Visual Studio 2015，单击菜单栏的“File > New > Project”，打开“New Project”窗口，如图所示。

    

   图1 新建项目 
   

    

2. 在左侧项目类型中选择“Visual C++ > MFC”，并在右侧模板中选择“MFC Application”，“Name”输入工程名称“eSDK_EC”，“Location”单击“Browse”按钮，选择“D:\Demo”，完成后单击“OK”。

    

   说明： 

   在该HelloWorld中，工程名称必须命名为“eSDK_EC”，不可随意更改，否则可能会导致运行不通过。

    

3. 单击“下一步”，进入“MFC应用程序向导”，选择“Application Type”为“Dialog based”，如图2所示。其余设置均保持默认值即可。

    

   图2 应用程序类型 
   

    

4. 单击“Finish”，完成新工程的创建。

引入头文件和lib文件

1. 获取eSDK CloudEC 的SDK开发包，将开发包拷贝至工程目录下。

    

   将解压缩后的开发包拷贝至“${path}\eSDK_EC\eSDK_EC”目录下，与eSDK_EC.vcproj同一级目录。${path}为创建工程时所设置的工程所在位置路径，此处为“D:\Demo”，如图3所示。

   图3 目标路径 
    
   

    

2. 配置工程Debug编译环境。

    

   1. 输出目录配置。

      打开“Solution Explorer”窗口，选中“eSDK_EC”工程，右击选择最后“Porperties”项，如图4所示。

      图4 项目属性 
      

      打开“eSDK_EC Property Pages”，左侧列表中选择“Configuration Properties > General”， “ Output Directory”值修改为“..\debug”，点击“Apply”按钮，如图5所示。

      图5 输出目录配置 
      
   2. 头文件引用目录配置

      在“eSDK_EC Property Pages”左侧选择“Configuration Properties > C/C++ > General”，将“Additional Include Directories”的值修改为“.\SDK\include”， 点击“Apply”按钮，如图6所示。

      图6 附加包含目录配置 
      
   3. lib文件附加库目录配置

      在“eSDK_EC Property Pages”左侧选择“Configuration Properties > Linker > General”，将“Additional Library Directories”的值修改为“.\SDK\lib\”， 点击“Apply”按钮，如图7所示。

      图7 附加库目录配置 
      
   4. lib文件引入配置

      在“eSDK_EC Property Pages”左侧选择“Configuration Properties > Linker > Input”，将“Additional Dependencies”的值修改为“tsdk_service.lib”， 点击“OK”按钮，如图8所示。

      图8 附加依赖项配置 
      

    

设计页面布局

1. 双击“Resource View > eSDK_EC.rc > Dialog > IDD_ESDK_EC_DIALOG”，打开工程对应的Dialog页面，如图9所示。

    

   图9 打开对话框 
   

    

2. 删除原有控件：CTRL+A组合键选中页面上原有全部控件，按Delete键删除；如图10所示。

    

   图10 删除控件 
   

    

3. 添加服务器地址控件和服务器地址注释控件

    

   1. 添加服务器地址控件：打开“Toolbox”页面，直接选中“IP Address Control”控件，拖至右边页面上；如图11所示。
      图11 添加服务器地址 
      
   2. 为服务器地址控件绑定变量：选中服务器地址控件，右击选择 “Add Variable”，打开“Add Member Variable Wizard-eSDK_EC”页面，如图12所示。
      图12 服务器地址添加变量 
      
   3. “Variable name”填写“m_ipCtrlServerIP”，其它默认设置保持不变，点击完成，如图13所示。
      图13 服务器地址绑定变量 
      
   4. 添加服务器地址注释控件：打开“Toolbox”页面，直接选中“Static Text”控件，拖至右边页面上，如图14所示。
      图14 添加服务器地址注释 
      
   5. 修改服务器地址注释控件：选中服务器地址注释控件，右击选择“Properties”，如图15所示。
      图15 打开服务器地址注释 
      
   6. 在对应的属性页上，找到“Caption”项，将值修改为“Server Address”， 按下回车键，如图16所示。
      图16 设置服务器地址注释 
      

    

4. 添加服务器端口控件和服务器端口注释控件添加服务器端口控件：

    

   1. 打开“Toolbox”页面，直接选中“Edit Control”控件，拖至页面上，如图17所示。
      图17 添加服务器端口 
      
   2. 为服务器端口控件绑定变量：选中服务器端口控件，右击选择 “Add Variable”，打开“Add Member Variable Wizard-eSDK_EC”页面；如图18所示。
      图18 服务器端口添加变量 
      
   3. “Variable name”填写“m_edtServerPort”，其它默认值保持不变，点击“Finish”，如图19所示。
      图19 服务器端口绑定变量 
      
   4. 添加服务器端口注释控件：打开“Toolbox”页面，直接选中“Static Text”控件，拖至右边页面上,如图20所示。
      图20 添加服务器端口注释 
      
   5. 修改服务器端口注释控件：选中服务器端口注释控件，右击选择“Properties”，如图21所示。
      图21 打开服务器端口注释 
      
   6. 在对应的属性页上，找到“Caption”项，将值修改为“Server Port”， 按下回车键，如图20所示。
      图22 服务器端口注释 
      

    

5. 添加登录帐号控件和登录帐号注释控件。

    

   同步骤4，添加登录帐号控件和登录帐号注释控件，并把登录帐号控件绑定变量m_edtLoginAccount。

    

6. 添加登录密码控件和登录密码注释控件。

    

   同步骤4，添加登录密码控件和登录密码注释控件，并把登录密码控件绑定变量m_edtPWD。

    

7. 添加登录按钮控件。

    

   1. 添加登录按钮控件：打开“Toolbox”页面，选中“Button”控件，拖至右边页面上，如图23所示。
      图23 添加登录按钮 
      
   2. 修改登录按钮上面的注释：选中登录密码注释控件，右击选择“Properties”，如图24所示。
      图24 打开登录按钮属性 
      
   3. 在对应的属性页上，找到“Caption”项，将值修改为“Login”， 按下回车键，如图25所示。
      图25 设置登录按钮属性 
      

    

8. 页面完成效果如图26所示。

    

   图26 最终页面效果 
   

    

9. 为登录按钮添加事件：

    

   双击“Login”控件，如图27所示。

   图27 登录按钮位置 
   

   系统会自动在eSDK_ECDlg.cpp中添加登录按钮事件方法OnBnClickedButton1()。CTRL+S键保存现有工程，如图28所示。

   图28 登录按钮事件 
   

    

10. 填充代码，见Hello World源码文件，如图29所示。

     

    图29 填充代码 
    
    1. 用eSDK_ECDlg.cpp文件源码内容替换工程中原eSDK_ECDlg.cpp文件内容；
    2. 用eSDK_EC.cpp文件源码内容替换工程中原eSDK_EC.cpp文件内容；
    3. 用eSDK_ECDlg.h文件源码内容替换工程中原eSDK_ECDlg.h文件内容；
    4. 用eSDK_EC.h文件源码内容替换工程中原eSDK_EC.h文件内容；
    5. 保存现有工程：点击菜单栏“全部保存”快捷图标。

     

编译及调试

1. 选中工程，右键选择“Rebuild”，进行编译，如图30所示。

    

   图30 编译工程 
   
   观察“Output”窗口，出现信息“Rebuild All:1 succeeded, 0 failed, 0 skipped”，代表编译成功，如 图31所示。

   图31 编译结果 
   

    

2. 编译成功后，工程文件夹中会生成一个debug文件夹，debug文件夹中就是刚编译生成的可执行程序eSDK_EC.exe，如图图32所示。

    

   说明： 

   此处.exe可执行程序所在路径为${path}\eSDK_EC\debug，而非${path}\eSDK_EC\eSDK_EC\debug。

   图32 可执行程序路径 
   

    

3. 将“${path}\eSDK_EC\eSDK_EC\SDK\dll”文件夹下的所有文件及文件夹全部拷贝至步骤2中的可执行程序文件夹里，用于可执行程序eSDK_EC.exe的调用，如图33所示。

    

   图33 源DLL位置 
   

   拷贝至如图34所示。

   图34 目的DLL位置 
   

    

4. 进入到eSDK_EC > debug文件夹中，双击eSDK_EC.exe运行工程，在页面上输入如下信息：

    

   • Server Address：eSDK EC服务地址
   • Server Port：eSDK EC服务端口号
   • Account：eSDK EC登录帐号
   • Password：eSDK EC登录密码

   以上信息均可通过华为远程实验室申请获得。

   输入正确信息如图35所示。

   图35 输入信息 
   

    

5. 点击“Login”按钮，如果弹出以下对话框，表示登录成功，如图36所示。

    

   图36 效果图