2018第一发：记一次Advanced Installer打包之旅

Posted 2020-10-19 NaYoung

一、前言

2017年最后几天，你们都高高兴兴的跨年，博主还在加班制作.net安装包。因为年前要出来第一版的安装包，所以博主是加班加点啊。本来想用VS自带的制作工具，不过用过的人都知道，真是非常好（tong）用（ku），各种包需要单独下载不说，界面也不美观，所以决定弃用之。同事推荐用Advanced Installer，不过同事也是很久不用了，记不起来具体用法。所以博主是边摸索边前进，所以不免跳进坑里，为了避免后来人跳进同样的坑里，作文以记之。

好了，不说废话，正文开始！

二、画流程图

俗话说的好，“磨刀不误砍柴工”！

首先强调一点，我们要先弄清楚我们每一步要做什么，这样接下来在制作安装包时才能条理清晰，有条不紊，不容易犯错。

比如我们要判断客户机器上是否安装.net framework3.5及以上版本，是否安装IIS,是否安装SQL Server2005及以上版本数据库等等。

我这个项目的流程图如下：

Tips1:开始之前最好先画流程图

三、开始制作

有了流程图，只需按部就班！关于Advanced Installer的基础用法，网上有很多的资料，官网也有帮助文档，这里就不赘述了。由于要用到自定义安装包的过程，需要新建对话框，博主用了企业模板，Advanced Installer的版本是14.5.2，也是最新的版本。

1、选择模板

首先新建模板里面选择Enterprise，并选择语言（默认为中文），然后创建项目：

Tips2:如果安装包中需要自定义对话框，则需要选择Enterprise版。

2、设置基本信息

Name即为该安装包的名称，公司就是你所在的公司啦，还有版本信息等等，这个很简单。

3、设置默认安装路径

点击Package Definition->Install Parameters，填写默认安装路径。

Application folder默认的内容是这样：“[ProgramFilesFolder][Manufacturer]\\[ProductName]”， 这个内容表示安装时默认的安装路径：

[ProgramFilesFolder]表示文件夹，这里为D:\\Program Files(x86)。

[Manufacturer]表示公司名称，这里为Landsoft。

[ProductName]表示产品名称，这里为LandaV9。

 

4、设置安装条件

点击Requirements->Launch Conditions->Software，勾选相应的条件。这里根据流程图所示，我应该勾选.Net Framework、IIS以及SQL Server。注意这里的条件指的是最低条件，比如我这里SQL Server选的是2005，即客户机器上应该装有2005及以上版本的SQL Server，如果没有装，则会提示没有安装SQL2005。

这里还有系统条件即要求客户机器是win7还是winxp等等。如果还有更多的条件，Custom里面可以自定义。

 

5、添加文件或文件夹

点击Resources->Files and Folders,在Application Folders上右键，选择Add Folder或者Add Files，这里我添加了5个文件夹，用于后续操作。

6、自定义对话框（Dialog）

新建对话框之前可以在Themes中选择主题和样式。

点击User Interface->Dialogs，在FolderDlg上右键，选择Add Dialog是添加Advanced Installer中自定义的对话框，选择New Dialog是新增一个空的对话框，

然后我们可自行在上面定义内容：

新建对话框后，可以拖出安装过程中dialog的外观，这个对于我们.Net开发人员来说，应该是小Case吧，看一下效果：

可以对文本框设置默认值：

Tips3:文本框中的属性名，不要修改。如果修改会有大问题，至于什么问题，后面再说！

由于我们需要设置连接字符串，所以需要客户设置数据库的相关信息：

选择Add Dialog后，在弹出框中选择SQLServerConnentionDlg

效果如下:

最后再新建一个对话框，用于部署项目到IIS所需要的条件：

同样可以设置网站名称和端口号：根据流程图，这里的默认值需要分别设置为Mango和8001，用户可以自行修改。

到这里新建对话框告一段落。

7、设置必填验证

就拿上面这个对话框为例，虽然我们设置的有默认值，但是客户在安装过程中不小心给删掉了，又没有填写，恰巧又点了下一步，这样的话，安装过程中会有问题。所以我们要做必填验证，即文本框中没有值，则“下一步”按钮不可用，有值才可用。

所以选择“下一步”，关注下方的“Control Conditions”：

 

点击New按钮在新弹出的界面中在Condition中填写“NOT EDIT_1_DROP OR NOT EDIT_1_DROP_1”，在Action中选择Disable。

EDIT_1_DROP和EDIT_1_DROP_1就是网站名称和端口号，前面加NOT的意思就是，如果这两个文本框中任意一个没有填写，则按钮不可用（Disable）。

同理再添加一个“EDIT_1_DROP AND EDIT_1_DROP_1”，在Action中选择Enable。即都填内容了，则按钮可用。这样就对控件做了必填验证。是不是很简单呢！

 

8、设置桌面快捷方式

根据流程图所示，安装结束后，需要在桌面生成快捷防方式。所以接下来，我们就来做这件事：

首先来到Files and Folders选项卡，在Application Shortcut Folder上面右键 选择“New Shortcut”，弹出如下界面：

 

在这个框里主要设置快捷方式的Name和描述以及图标（这个图标，可以选择.exe文件）。点击OK，就会在Application Shortcut Folder中显示这样一条信息。

但是先别急，如果仅仅是这样的话，快捷方式是不起作用的。因为我们还没有设置快捷方式对应的可执行文件。

双击这条信息，在弹出的对话框中设置Shortcut Target。

看到这，肯定有人有疑问？既然这样为什么不在新增快捷方式的时候一起设置呢？

因为在新增的时候，Shortcut target这个文本框中的内容不能修改。这个很坑爹，博主也试了好久才试出来的。

最后，将这个信息拖到Desktop里面即可，安装完毕后，就会在桌面显示这个快捷方式。

四、设置IIS网站的网站名、端口号

在上面对话框的最后一步中，我们记住网站名称的和端口号的文本框的属性名，然后来到IIS选项卡中：

首先新增一个应用程序池，名称即为网站名称文本框的属性名，这里为EDIT_1_PROP,在Advanced Installer里面，使用中括号[]将控件的属性名括起来表示变量的概念。

在Basic Pool Settings中设置程序池的启动模式为总是启动，勾选立即启动程序池复选框，framework版本选择为4.0，托管模式选择为集成。

在Identity中设置应用程序池表示为ApplicationPoolIdentity。

应用程序池设置好之后，再来设置站点：

新建一个站点名称同样为EDIT_1_PROP，在Basic Site Setting中设置Name和文件路径。

 

在Bindings/SSL中设置端口号，IP地址选择全部未分配。

 

在Application Pool中选择刚刚新建的应用程序池。

到这里IIS这一块就设置好了。

安装过程中，Advanced Installer就会自动的将网站部署好。这个真的是很牛很强大！不得不佩服人家做的就是好！

五、两种方式设置config文件

1、直接在Advanced Installer中设置

在添加文件的时候，如果有xml类型的文件，会有这样的提示：

这时候我们勾选需要修改配置的文件，点击ok，这样就可以直接在Advanced Installer中修改。

找到需要修改的节点，直接有文本框的属性替换掉就可以：

这样，在安装过程中就会将config文件中的相应的节点替换为客户输入的值。

还记得Tips3吗?我们说过如果修改文本框的属性名之后，那么这样设置之后，config中的值不会设置为客户输入的值，会始终是文本框中设置的默认值。

切记切记！！！重要的事情三个叹号！

2、使用自定义的dll文件

关于这点请见第六小节。

六、自定义dll

点击Custome Behavior->Custom Actions,选择.Net Installer Class action。这时会让你选择文件中的dll文件。

当然了，在此之前，请打开你的Visual Studio，新建一个类库项目，这里命名为InstallLandaV9ServiceT，然后新建一个安装程序类，重写Install方法。

到这里，我们先暂停一下，问一下自己：在程序中怎么接收从Advanced Installer传过来的参数呢？

假如此时我们已经将这个dll加入到Advanced Installer中，在Installer Class Paramters中可以添加参数。

比如将文件路径传到后台，可以这样添加：Name为FilePath，Value为[APPDIR]\\。

这里有地方需要注意，传递文件路径时，Value为[APPDIR]\\，这个"\\"请不要漏掉了。

Tips4:传递文件路径时，Value为[APPDIR]\\，这个"\\"请不要漏掉了。

其他参数的Value，需要设置为对应文本框的属性名称，格式为：[属性名]。

下面来看一看代码：

public override void Install(IDictionary stateSaver)
{
    Parameters configParms = new Parameters();
    configParms.FilePath = Context.Parameters["FilePath"];
    configParms.ServerPath = Context.Parameters["ServerPath"];
    configParms.ClientPath = Context.Parameters["ClientPath"];
    configParms.DataSource = Context.Parameters["DataSource"];
    configParms.UserId = Context.Parameters["UserId"];
    configParms.Password = Context.Parameters["Password"];
    new Operators().UpdateLandaV9Config(configParms);
    base.Install(stateSaver);
}

这里主要接收从Advanced Installer中传过来的参数，接着在Operators类中更新配置文件。

还记得Tips3吗？如果在那里修改的属性名，那么这里接收的参数也是文本框的默认值。

这里面主要干了三件事，获取连接字符串，更新连接字符串，安装服务

public void UpdateLandaV9Config(Parameters configParms)
{
    string filePath = Path.Combine(configParms.FilePath, "LandaV9Service", "LandaEntryInfoService.exe.config");
    string connectionString = this.GetConnectionString(configParms);
    this.UpdateConnections(filePath, connectionString);this.InstallService(Path.Combine(configParms.FilePath, "LandaV9Service"));
}

还记得Tips4吗?如果在传递文件路径的时候只是写[APPDIR]，而不是[APPDIR]\\，那么程序运行到这里的时候，会抛“FileNotFound”异常！

下来来看一下具体的代码：

/// <summary>
/// 获取连接字符串
/// </summary>
/// <param name="op"></param>
/// <returns></returns>
public string GetConnectionString(Parameters op)
{
    return string.Format("Data Source={0};Initial Catalog=LandaEntryManager;Persist Security Info=True;User ID={1};Password={2}", op.DataSource, op.UserId, op.Password);
}

/// <summary>
/// 更新连接字符串
/// </summary>
/// <param name="filePath"></param>
/// <param name="conn"></param>
public void UpdateConnections(string filePath, string conn)
{
    XmlDocument xmlDocument = new XmlDocument();
    xmlDocument.Load(filePath);
    XmlElement xmlElement = (XmlElement)xmlDocument.SelectSingleNode("/configuration/connectionStrings/add[@name=\'LandaEntryManager\']");
    if (xmlElement != null)
        xmlElement.SetAttribute("connectionString", conn);
    xmlDocument.Save(filePath);
}

再来看安装服务：

/// <summary>
/// 安装服务
/// </summary>
/// <param name="filePath"></param>
public void InstallService(string filePath)
{
    Environment.CurrentDirectory = filePath;
    Process process = new Process();
    process.StartInfo.UseShellExecute = false;
    process.StartInfo.FileName = "Install.bat";
    process.StartInfo.CreateNoWindow = true;
    process.StartInfo.Verb = "runas";  //主要设置为以管理员启动
    process.Start();
}

有安装就有启动，可是如果紧跟其后写启动服务，会提示找不到服务，安装程序就会出错。

博主想了一个办法，重写OnAfterInstall方法，在这个方法里面写启动服务：

/// <summary>
/// 重启服务
/// </summary>
/// <param name="savedState"></param>
protected override void OnAfterInstall(IDictionary savedState)
{
    ServiceController serviceController = new ServiceController("LandaInformationServiceV9");
    serviceController.Start();
    base.OnAfterInstall(savedState);
}

这样就没问题了！

在这个程序集里面可以自定义你想做的其他事情，比如，还原数据库等等。

七、后记

本次教程到此结束，这也是博主在这几天假期摸索出来的，如果有不当之处，尽请指正！

附上Advanced Installer的官网地址：https://www.advancedinstaller.com/。

希望本文对你有所帮助。如果你觉得本文能够帮助你，就点个赞吧。你的支持是博主继续坚持的不懈动力。