开发和部署Pocket Pc 安装程序

开发和部署Pocket Pc 安装程序 原作者: Ralph Arvesen Vertigo Software, Inc. 发表于2003年3月MSDN 翻译者：liu_sir 应用: Microsoft® .NET Compact Framework 1.0 Microsoft Visual Studio® .NET 2003 概要: 了解如何创建一个独立的.msi文件，通过运行台式机上该Msi文件在不同的Pocket Pc设备上安装应用程序。 开发部署过程自动化，因此可以很容易的创建和打包所有必要的组件生成一个.msi文件。示例代码以C#和VB.Net语言提供。（共21印刷页） 这里下载范例代码Deployment.msi 内容： 概述 部署 卸载 开发 开发过程自动化 概述 下面所列为开发和部署Pocket Pc应用程序的要点： ● Pocket Pc设备有不同的处理器类型（如ARM，SH3，MIPS等）。 ● 安装程序用.Cab格式部署。 ● Cab向导（cabwiz.Exe）生成特定处理器的.cab文件。 ● WinCE应用程序管理器部署和安装桌面系统上的.cab文件到Pocket Pc设备上。 我们首先论述部署和卸载过程，然后是开发和开发过程的自动化。 部署 用户可以拷贝和运行合适的.cab文件到他们的设备上，但是一个更好的解决方案是通过运行桌面上的一个.msi文件把应用程序装载到设备上。 .msi安装文件检测设备的型号，拷贝正确的.cab文件到设备上，然后运行这个.cab文件安装应用程序。所有的过程都对用户透明； 用户只要运行他们桌面系统上的一个.msi文件，应用程序就可以被自动的安装到Pocket PC上。 下面是关于基于.msi文件部署的步骤： ● 用户在他们的桌面上运行.msi文件。 ● msi文件解包成特定处理器的.cab文件，setup.ini和一个自定义安装组件。 ● 在安装过程中被调用安装组件，由安装组件运行WinCE应用程序管理器（WinCE Application Manager）部署和安装正确的.cab文件到设备上。 ● Setup.ini文件向WinCE应用程序管理器提供应用程序的描述信息。 下面的图说明与部署过程相关的各部分，接着是每个部分的描述信息。 图1.包含在部署过程中的各模块 .msi 文件 .msi文件是可以从桌面上安装你的Pocket Pc应用程序的独立文件。用户运行.msi文件，它 解包成特定处理器的.cab文件，一个自定义安装组件，和一个setup.ini文件。 .cab文件 通过运行.cab文件把Pocket PC应用程序安装在设备上。这些文件是自解压文件，包含有安装指令和应用程序所需的所有文件。这些文件是针对不同的处理器的，所以对于每一种应用程序支持的处理器需要单独的.cab文件。 安装组件 这是一个在安装过程中被调用的自定义组件。它运行WinCE应用程序管理器，通过它拷贝和安装正确的.cab文件到设备上。 Setup.ini文件 向WinCE应用程序管理器描述应用程序信息的初始化文件，在WinCE应用程序管理器安装应用程序的过程中是必不可少的。 WinCE应用程序管理器 WinCE应用程序管理器位于用户的桌面系统上，用于在Pocket PC设备上安装和卸载应用程序。下图显示应用程序管理器提示用户将要安装示例应用程序在Pocket Pc设备上。 图2.从桌面上安装一个Pocket PC应用程序 卸载 .cab文件在Pocket PC上存储安装信息，因此应用程序可以被卸载。用户可以在Pocket PC上直接卸载应用程序，或者从桌面上卸载。用Pocket PC卸载应用程序，用户可以选择应如下图所示的应用程序设置中的删除应用程序。 图3.使用Pocket PC卸载一个应用程序 就象安装时一样，用户也可以从他们的桌面上卸载应用程序。从控制面板应用程序下的添加删除程序选择要卸载的程序，点击删除按钮。这个过程调用自定义安装组件，由它使WinCE应用程序管理器运行在卸载模式（不需要指定一个Setup.Ini文件）。用户去掉应用程序上的对勾，点击OK去卸载Pocket PC上的应用程序。 图4.从桌面系统上卸载一个PocketPc程序 开发安装程序 开发安装程序的目标是用最小的工作量生成一个.msi文件（如果可能的话，点一下鼠标）。首先让我们看一下开发安装程序过程所涉及的各部分： ● BuildCab.bat通过运行cab向导启动安装过程。 ● 信息文件（.inf）向cab向导提供应用程序描述。 ● cab向导根据.inf文件所指出的处理器类型生成不同的.cab文件。 ● .cab文件，一个自定义安装组件和一个Setup.ini文件被打包成一个.msi文件。 下面的图表说明与安装开发过程相关的各部分，接下来是每个部分的描述信息。 图5.与安装开发过程的相关部分 BuildCab.bat文件通过运行Cab向导工具生成特定处理器的.cab文件。当你从生成菜单上选择生成cab文件时， Visual Studio生成一个模板BuildCab.Bat文件。让Microsoft® Visual Studio®生成这个文件，然后拷贝它到一个不同的路径，然后做一些更改是一个好办法。很有可能，仅有的改变是为.cab和log文件指定一个新的路径。示例中的BuildCab.Bat如下所示。 C:/Program Files/Microsoft Visual Studio .NET 2003/CompactFrameworkSDK/v1.0.5000/Windows CE/../bin/../bin/cabwiz.exe" "c:/program files/pocketpc deploy sample/Source/CS/PocketApp/BuildCabs/PocketApp_PPC.inf" /dest "c:/program files/pocketpc deploy sample/Source/CS/PocketApp/BuildCabs/Cabs" /err CabWiz.PPC.log /cpu ARMV4 ARM SH3 MIPS X86 WCE420X86 信息文件（.inf） Microsoft Windows® CE .NET .inf文件向cab向导指定了安装设置和应用程序文件。如buildcab.bat文件，当生成cab文件被选择时，Visual Studio生成一个模板.inf文件。你应该首先用Visual Studio生成这个文件，然后拷贝到另外的路径去做一些更改。这个文件通常需要很小的修改；通常修改Provider的名称就可以了。 Visual Studio生成一个.inf文件包含对vsd_setup.dll的引用。这个dll是用于版本检查以及假如Pocket PC没有正确的安装.Net精简板，报告这个信息。把它包含在你的应用程序中是一个好注意，但为了更清晰，我们把它从示例代码中移除了。 例子程序中的.inf如下所示。你可以访问Microsoft Windows CE .NET: Creating an .inf File获取多信息。 Signature="$Windows NT___FCKpd___1quot; Provider="Sample Company" CESignature="$Windows CE___FCKpd___1quot; [CEStrings] AppName="PocketApp" InstallDir=%CE1%/%AppName% [CEDevice] VersionMin=3.00 VersionMax=4.99 [DefaultInstall] CEShortcuts=Shortcuts CopyFiles=Files.Common [SourceDisksNames] 1=,"Common1",,"C:/Code/Microsoft/Pocket PC Whitepapers/Deployment/Code/CS/PocketApp/obj/Release/" [SourceDisksFiles] PocketApp.exe=1 [DestinationDirs] Files.Common=0,%InstallDir% Shortcuts=0,%CE2%/Start Menu [Files.Common] PocketApp.exe,,,0 [Shortcuts] PocketApp,0,PocketApp.exe,%CE11% Cab向导 Cab向导（cabwiz.exe）生成.cab文件，该文件可以被安装在不同的Pocket PC设备上。一个.inf文件作为命令行的第一个参数传递,用于向向导描述应用程序。其它可选参数为目的路径，错误日志文件，和CPU类型。你可以访问You can visit Microsoft Windows CE .NET: CAB Wizard Syntax获取更多的信息。 安装组件 自定义安装组件通过处理AfterInstall和AferUnInstall事件以及运行WinCE应用程序管理器实现部署过程自动化。WinCE应用程序管理器的路径存储在注册表HKLM/software/Microsoft/Windows/CurrentVersion/App Paths/CEAppMgr.exe健值下。下面是AfterInstall和AferUnInstall事件的代码。 C# private void Installer_AfterInstall(object sender, System.Configuration.Install.InstallEventArgs e) { // get fullpath to .ini file string arg = Path.Combine( Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location), "Setup.ini"); // run WinCE App Manager to install .cab file on device RunAppManager(arg); } private void Installer_AfterUninstall(object sender, System.Configuration.Install.InstallEventArgs e) { // run app manager in uninstall mode (without any arguments) RunAppManager(null); } private void RunAppManager(string arg) { // get path to the app manager const string RegPath = @"Software/Microsoft/Windows/" + @"CurrentVersion/App Paths/CEAppMgr.exe"; RegistryKey key = Registry.LocalMachine.OpenSubKey(RegPath); string appManager = key.GetValue("") as string; if (appManager != null) { // launch the app Process.Start( string.Format("/"{0}/"", appManager), (arg == null) ? "" : string.Format("/"{0}/"", arg)); } else { // could not locate app manager MessageBox.Show("Could not launch the WinCE Application Manager."); } } VB.Net Private Sub Installer_AfterInstall(ByVal sender As Object, _ ByVal e As System.Configuration.Install.InstallEventArgs) _ Handles MyBase.AfterInstall ' get fullpath to .ini file Dim arg As String = Path.Combine(Path.GetDirectoryName( _ System.Reflection.Assembly.GetExecutingAssembly().Location), _ "Setup.ini") ' run WinCE App Manager to install .cab file on device RunAppManager(arg) End Sub Private Sub Installer_AfterUninstall(ByVal sender As Object, _ ByVal e As System.Configuration.Install.InstallEventArgs) _ Handles MyBase.AfterUninstall ' run app manager in uninstall mode (without any arguments) RunAppManager(Nothing) End Sub Private Sub RunAppManager(ByVal arg As String) ' get path to the app manager Const RegPath As String = "Software/Microsoft/Windows/" & _ "CurrentVersion/App Paths/CEAppMgr.exe" Dim key As RegistryKey = Registry.LocalMachine.OpenSubKey(RegPath) Dim appManager As String = CStr(key.GetValue("")) If Not (appManager Is Nothing) Then If arg Is Nothing Then Process.Start(String.Format("""{0}""", appManager)) Else ' launch the app Process.Start( _ String.Format("""{0}""", appManager), _ String.Format("""{0}""", arg)) End If Else ' could not locate app manager MessageBox.Show("Could not find app manager") End If End Sub Setup.ini文件 .ini文件用于在WinCE应用程序管理器向Pocket PC设备部署应用程序时，描述应用程序信息。下面所示的是Setup.ini的例子。你应该在你的应用程序中设置Version,Description和CabFiles属性。你可以访问Microsoft Windows CE 3.0: Creating an .ini File for the Application Manager 去获取更多的关于.ini文件的信息。 [CEAppManager] Version      = 1.0 Component    = App [App] Description  = Sample Pocket PC application. CabFiles     =    PocketApp_PPC.X86.CAB,PocketApp_PPC.ARM.CAB,PocketApp_PPC.ARMV4.CAB,   PocketApp_PPC.MIPS.CAB,PocketApp_PPC.SH3.CAB,PocketApp_PPC.WCE420X86.CAB .msi文件 这是分发给用户的文件。它包含了从桌面向不同的Pocket PC部署Pocket PC应用程序所必要的模块。 安装过程自动化 现在你已经熟悉了与安装开发过程相关的所有模块。让我们看一下生成过程如何自动化。要点如下： ● 创建一个包含多工程的解决方案（Pocket PC app, customer installer, 和 setup）。 ● 把自定义的安装组件加入安装过程的安装和卸载自定义动作中。 ● 用一个预生成事件去调用BuildCab.bat文件去生成.cab文件。 ● 指定项目的依赖性以使项目按正确的顺序生成。 ● 用配置管理器设置生成Pocket PC程序的Debug配置和Release配置。 下面的部分更加详细的描述了C#和VB.Net例子解决方案。C#解决方案点一下鼠标就生成所有的项目（Pocket PC应用程序，自定义安装组件和.msi文件）。VB.Net版本需要更多步骤，由于VB.Net缺少这两个属性： 1. 一个解决方案不能包括不同平台的VB.Net项目（Pocket PC应用程序不能和自定义安装组件在同一个解决方案中）。 2. 预生成和后生成命令事件在任何VB.Net工程中都是不支持的。 VB.Net方案仍就可以实现自动化的，只是比不上C#版本便捷而已。 解决方案和项目 C#解决方案包含三个项目：PocketPC App, Custom Installer 和 Setup。PocketPC App项目是一个基于Pocket PC的智能设备应用程序。Custom Installer项目是一个自定义安装组件。安装项目把所有的项目打包成一个.msi文件。下面显示的是C#解决方案。 图6.包含PocketPC App, Custom Installer 和 Setup项目 VB.Net需要两个解决方案。第一个包括智能设备项目PocketApp。第二个解决方案生成一个.msi文件，包括CustomInstaller, Pre-Build 和 Setup项目。CustomInstaller和Setup项目与C#中的项目相同，预生成项目是一个C++ Makefile项目；预生成项目并不包括任何C++代码，仅仅用于指定一个预编译事件。VB解决方案如下图。 图 7. 包含Pocket PC, installer component, pre-build and setup projects的VB.Net解决方案 PocketApp项目 PocketApp是一个简单的智能设备项目，“Hello World”应用程序；一个PocketPC简单程序。BuildCab.bat和PocketApp_PPC.inf文件用于生成.cab文件，Setup.ini文件用于部署应用程序。 文件app.ico是一个应用程序图标文件，显示在Pocket Pc的程序工作组中。下面显示的是在C#和VB.Net中指定应用程序图标。 图8.在C#中指定应用程序图标 图9.在VB.Net中指定应用程序图标 图10.显示在Pocket PC应用程序组中的图标 CustomInstaller项目 这个组件运行WinCE应用程序管理器，让其部署.cab文件到Pocket PC设备上。C#和VB.Net的代码已经早在上文中说明了。 Setup项目 安装项目生成一个.msi文件包括特定处理器的.cab文件，CustomerInstaller安装组件和setup.ini文件。CustomerInstaller组件添加进来作为Install和UnInstall自定义动作的响应，如下图所示 图11.添加Install和UnInstall自定义动作的响应 预生成事件 在PocketApp项目生成后，你需要运行BuildCab.bat生成.cab文件。Visual Studio不允许你为C#智能设备项目指定生成后命令事件。所以我们最好为CustomerInstaller项目指定一个预生成命令事件。 图 12.用一个预生成命令事件去在C#中生成.cab文件 Visual Studio不允许VB.Net项目有任何生成事件，所以我们用一个C++ Makefile工程去定义预生成事件，如下图所示。 图 13.用一个C++预生成事件作为VB.Net的解决方法 项目依赖 由于解决方案包含许多工程，所以设置正确的生成顺序是很重要的。对于C#，生成顺序设置为PocketApp,CustomeInstaller 和 Setup,如下图所示。 图 14.为C#解决方案设置生成顺序 VB.Net版本包含有两个解决方案；PocketApp解决方案应首先生成，接下来是PocketPCSetup解决方按。Setup解决方案的生成顺序如下图所示。 图 15.指定VB.Net解决方案的生成顺序 配置管理器 配置管理器用于生成Pocket PC项目在Debug模式和所有的程序在Release模式。就是说，仅为调试应用程序Pocket PC应用程序，你不用经历整个生成过程。C#版本的配置图示如下。 这个配置在VB.Net中不需要，因为其中的一个解决方案是对于Pocket PC的，另外一个解决方案用于生成.msi文件。 图 16.仅生成Pocket PC项目在Debug模式 图 17.生成所有的项目于Release模式 安装和生成示例解决方案 下面是安装和生成示例解决方案的注意点。 ● 运行PocketPC部署程序Sample.msi文件，安装C#和VB.Net到你的系统中。指向Visual Studio解决方案文件的链结添加在开始菜单中的PocketPC Deploy Sample组下面。 ● 在BuildCab.bat和PocketApp_PPC.inf文件中的硬编码被更新以与你的系统匹配（例子安装文件夹和Visual Studio的路径）。你应该多检查这些文件的路径信息，如果你生成示例程序的时候遇到困难。 ● 选择Release模式生成所有的项目（Debug模式只生成Pocket PC应用程序）。 ● .msi文件命名为PocketApp Setup.msi，在Setup/Release文件夹下创建。