演练:使用合并模块安装共享组件

合并模块 (.msm) 用于安装多个应用程序共享的组件,例如,开发人员在应用程序中使用的组件(如 DLL、控件、资源)。 相反,Windows installer (.msi) 用于安装应用程序和文件(如可执行文件、文档、HTML 页),并通常由应用程序的最终用户使用。

通过使用合并模块,可以帮助确保打包并提供共享组件,以实现部署的一致性。 可以使用模块的可重定目标文件夹将文件放入应用程序所在的目录中,不过也可以选择将文件放入其他目录中,如“开始”菜单。

本演练演示如何将组件打包到合并模块中以及如何在安装项目中使用该合并模块。

提示

对于在以下说明中使用的某些 Visual Studio 用户界面元素,您的计算机可能会显示不同的名称或位置。这些元素取决于您所使用的 Visual Studio 版本和您所使用的设置。有关更多信息,请参见 Visual Studio 设置

创建组件

  1. 在**“文件”菜单上指向“新建”,然后选择“项目”。**

  2. 在**“新建项目”对话框中,选择“项目类型”窗格中的“Visual C# 项目”,然后选择“模板”窗格中的“类库”。 在“名称”**框中键入 MyComponent。

  3. 单击**“确定”**关闭对话框。

  4. 在**“生成”菜单上选择“生成 MyComponent”**以生成类库。

创建合并模块项目

  1. 在**“文件”菜单上指向“添加”,然后选择“新建项目”**。

  2. 在**“添加新项目”对话框中,选择“其他项目类型”,选择“项目类型”窗格中的“安装和部署项目”,选择“Visual Studio Installer”,再选择“模板”窗格中的“合并模块项目”。 在“名称”**框中键入 Sample。

  3. 单击**“确定”**关闭对话框。

  4. 在**“文件系统编辑器”中,选择“Module Retargetable 文件夹”。 在“操作”菜单上指向“添加”,然后选择“项目输出”**。

  5. 在**“添加项目输出组”对话框中,选择“MyComponent”项目的“主输出”。 单击“确定”**关闭对话框。

  6. 在**“生成”菜单上选择“生成 Sample”**以生成合并模块。

添加使用合并模块的安装项目

  1. 在**“文件”菜单上指向“添加”,然后单击“新建项目”**。

  2. 在**“添加新项目”对话框中,选择“项目类型”窗格中的“安装和部署项目”,然后选择“模板”窗格中的“安装项目”。 在“名称”**框中,键入“合并模块安装程序”。

  3. 单击**“确定”**关闭对话框。

  4. 在**“文件系统编辑器”中,选择“应用程序文件夹”。 在“操作”菜单上指向“添加”,然后选择“项目输出”**。

  5. 在**“添加项目输出组”对话框中,选择“Sample”项目,然后选择“合并模块”**。

  6. 单击**“确定”**关闭对话框。

    请注意,合并模块(“合并模块来自 Sample (活动)”)不添加到文件夹中, 而是添加到**“解决方案资源管理器”“合并模块安装程序”**项目中。 这是因为合并模块不能直接安装,而必须合并到安装程序中。

  7. 在**“解决方案资源管理器”中选择合并模块。 在“属性”窗口中,展开“KeyOutput”节点,再展开“(Merge Module Properties)”节点,然后选择“Module Retargetable Folder”**属性。

    提示

    “KeyOutput”属性下面的属性是动态属性,它们只有在合并模块生成后才会显示出来。

  8. 单击**“Module Retargetable 文件夹”属性的下拉列表,然后选择“(浏览...)”以显示“选择文件夹”**对话框。

  9. 在**“选择文件夹”对话框中选择“应用程序文件夹”。 单击“确定”**关闭对话框。

  10. 在**“生成”菜单上选择“生成合并模块安装程序”**。

在开发计算机上安装

  • 在**“解决方案资源管理器”中选择“合并模块安装程序”项目。 在“项目”菜单上选择“安装”**。

    这将在开发计算机上运行安装程序并安装**“合并模块安装程序”**。 此安装程序将把合并模块中包含的组件安装到应用程序目录中。

    提示

    您必须在计算机上拥有安装权限才能运行该安装程序。

部署到其他计算机

  1. 在**“Windows 资源管理器”中,定位到项目目录并找到生成的安装程序。 默认项目配置为“调试”“发布”**。

  2. 将此目录中的“Merge Module Installer.msi”、Setup.exe 以及其他所有文件和子目录复制到另一台计算机上。

    提示

    若要在未联网的计算机上安装,请将文件复制到诸如 CD-ROM 的传统媒体中。

    在目标计算机上双击 Setup.exe 文件运行安装程序。

    提示

    您必须在目标计算机上拥有安装权限才能运行该安装程序。

卸载应用程序

  1. 在 Windows**“控制面板”中,双击“添加/删除程序”**。

  2. 在**“添加/删除程序”对话框中,选择“合并模块安装程序”,然后单击“删除”**。

  3. 单击**“确定”**关闭对话框。

    提示

    若要从开发计算机上卸载,请在 Visual Studio 的“项目”菜单上选择“卸载”

请参见

参考

合并模块的动态属性

其他资源

Visual Studio Installer 部署

自定义 Windows Installer 包