为C#应用程序创建Visual Studio安装项目生成MSI包安装程序

介绍

微软提供了很多为Windows程序创建安装文件的方法.

在我打算创建安装文件时，不知如何下手。我在网络上找到很多文章介绍如何创建安装项目，可是行不通，有些也没有实例可以参考。

我的 QC 团队促使我写下这篇文章.

本文中我将一步步介绍创建一个Windows程序和安装文件的流程。

开始行动

首先，创建一个只有一个窗体的应用程序，包含一个文本框和一个按钮，真的很简单。

我将程序命名为 CreatingInstaller，当然你可以命名其它名字。

创建好的窗体如下：

写一些简单的代码，点击按钮显示文本框内容：

主要任务

Windows程序完成了，我们为其添加一个安装项目:

在解决方案上点击右键选择添加新项目，在弹出的创建项目窗口选择 "Other Project Types" -> "Setup and Deployment" -> "Visual Studio Installer"：

项目添加之后，在项目上点击右键，选择查看->文件系统。打开如下界面，你可以看到应用程序文件夹、用户桌面和用户程序菜单。

右键点击Application Folder并选择添加->项目输出；选择要创建安装文件的项目：

选择"CreatingInstaller",即 "Add Output Project Group" 窗口选择要做安装文件的项目,将其作为主输出，然后点击 "Ok".

添加结果如下图：

现在将Windows程序的功能扩展一下，点击按钮后读取一个文件，将文件内容显示出来。在 "bin\debug\Input" 添加名为Sample.txt的文件夹，其中Input文件夹是用来放txt文件的。

完成功能代码：

运行程序。

在安装程序中添加文件夹和文件，以便满足程序的要求。

右键点击Application Folder，添加一个文件夹。此文件夹将创建到Application Folder，将其命名为Input。

右键点击文件夹，在属性中，将 Always Create属性设为True. 这样在安装程序时将创建此文件夹。

创建快捷方式

为Windows程序设置一个图标:

右键点击 Input选择添加文件，浏览到 Sample.txt后将其添加进来.

在主输出上点击右键，选择 "Create Shortcut to Primary Output", 将其命名为 CreatingInstaller.

在其属性面板为Icon属性选择一个图标。此图标将创建到桌面，下图演示如何添加图标：

将Application Folder 中的快捷方式剪切出来，粘贴到 User's Desktop文件。这样为程序在桌面创建快捷方式的工作就完成了.

在程序菜单创建快捷方式的流程和上面类似，如下图所示:

创建程序文件夹 CreatingInstaller.

创建新的快捷方式

添加图标

右键点击 Application folder选择属性，设定安装位置:

卸载

在程序菜单添加卸载功能，这样无需到控制面板卸载软件了.

Step 1

右键点击File System on the target Machine 选择"Add Special Folder" -> "System Folder" ：

Step 2

右键点击创建的system folder将 msiexec.exe文件（在System.Windows32 文件夹下）添加进来..

将此文件的属性设置为如下图所示:

Step 4

为此文件在程序菜单创建快捷方式，命名为 "Uninstall".

Step 5

查看setup project的属性。可以自定义如产品名称、作者、安装位置等属性。

J选择 product code。我们需要它作为msiexec的参数来实现卸载功能。

Step 6

右键点击Uninstall 快捷方式，设置其 arguments属性如下:
/x {product code} /qr
/x的意思是卸载.
具体内容请查看 http://technet.microsoft.com/en-us/library/cc759262(v=ws.10).aspx,

Step 7

保存并重新编译 setup project.

任务完成 !

运行生成的安装文件：

在桌面和程序菜单可看到我们创建的快捷方式

浏览程序文件夹，可看到 Input 文件夹和 Sample.txt 文件.运行程序，结果和在VS中运行时是一样的。

点击卸载，执行卸载操作:

Custom Actions

Custom actions 是在安装或卸载过程中执行自定义操作。比如当程序运行时，执行了卸载，由于程序已经在内存运行，因此卸载完成，而程序还在运行。我们可以在卸载时判断程序是否在运行，如果运行可先将其关闭然后再卸载。

1. 在Windows程序中添加Installer类，其中为 Installation, Uninstallation, Rollback,Commit指定了自定义行为事件.

我们需要为uninstallation写一些代码。
代码中的逻辑是找到正在运行的程序，将其关闭。这里不做具体解释，只是为了演示如何使用自定义行为。

using System;

using System.Collections;

using System.Collections.Generic;

using System.ComponentModel;

using System.Configuration.Install;

using System.Diagnostics;

using System.Linq;

namespace CreatingInstaller

{

[RunInstaller(true)]

public partial class Installer1 : System.Configuration.Install.Installer

{

public override void Install(IDictionary savedState)

{

base.Install(savedState);

//Add custom code here

}

public override void Rollback(IDictionary savedState)

{

base.Rollback(savedState);

//Add custom code here

}

public override void Commit(IDictionary savedState)

{

base.Commit(savedState);

//Add custom code here

}

public override void Uninstall(IDictionary savedState)

{

Process application = null;

foreach (var process in Process.GetProcesses())

{

if (!process.ProcessName.ToLower().Contains("creatinginstaller")) continue;

application = process;

break;

}

if (application != null && application.Responding)

{

application.Kill();

base.Uninstall(savedState);

}

2. 在CreatingInstallerSetup项目上选择 Custom Actions Editor.

3. 右键点击，选择添加自定义行为，然后选择Application Folder中的主输出

4. 任务完成了。

.Net Framework

如果按照软件的电脑上没有 .Net Framework怎么办? 我们可以选择自己的包，这样程序无需依赖客户电脑的 .Net Framework。

打开安装程序的属性窗口.

点击 Prerequisites 按钮，在弹出的窗口中选择需要的.Net Framework，然后选择第二个单选按钮，点击确定。

浏览安装程序的Debug文件夹，多了两个子文件夹.

需要的文件都包含进来了.

结论

此指南给出了创建安装程序的基本步骤，没有深入解释如注册表、 license agreements . 还有很多需要继续深入的，不过有了这些已经可以完成基本的任务了！