2018第一发:记一次【Advanced Installer】打包之旅

本文涉及的产品
云数据库 RDS SQL Server,基础系列 2核4GB
简介: 原文:2018第一发:记一次【Advanced Installer】打包之旅一、前言 2017年最后几天,你们都高高兴兴的跨年,博主还在加班制作.net安装包。因为年前要出来第一版的安装包,所以博主是加班加点啊。
原文: 2018第一发:记一次【Advanced Installer】打包之旅

一、前言

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/

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

目录
相关文章
|
小程序 JavaScript 开发者
微信小程序-强大的block标签
微信小程序可有意思了
1831 0
|
5月前
|
存储 文字识别 自然语言处理
通义大模型在文档自动化处理中的高效部署指南(OCR集成与批量处理优化)
本文深入探讨了通义大模型在文档自动化处理中的应用,重点解决传统OCR识别精度低、效率瓶颈等问题。通过多模态编码与跨模态融合技术,通义大模型实现了高精度的文本检测与版面分析。文章详细介绍了OCR集成流程、批量处理优化策略及实战案例,展示了动态批处理和分布式架构带来的性能提升。实验结果表明,优化后系统处理速度可达210页/分钟,准确率达96.8%,单文档延迟降至0.3秒,为文档处理领域提供了高效解决方案。
526 0
|
8月前
|
存储 人工智能 自然语言处理
知识库管理:全流程智能化中枢,驱动企业信息资产高效流转
智能系统的知识库管理技术可以深度融合AI技术与精细化流程控制,提供从内容创建到版本追溯的全生命周期管理。支持多模态数据统一存储(文本、语音、图像等),实现自动化审核、智能分类与语义检索,确保企业知识资产的安全存储与高效利用,助力业务持续优化。核心功能包括多角色协作编辑、动态标签管理、历史版本追溯及毫秒级语义检索,大幅提升信息管理效率与准确性。
337 9
|
8月前
|
弹性计算
【已解决】Matomo本地SMTP配置可以发邮件,但部署到阿里云ECS就发不了邮件
在阿里云ECS上使用Matomo和PHPMailer发送邮件时遇到问题,邮件无法发出且接口调用Pending。经过排查,发现是ECS安全组未开放25/465端口,导致SMTP请求无法正常通信。解决方法为在安全组中配置并开放25/465端口,从而恢复邮件发送功能。
147 2
|
10月前
|
数据采集 人工智能 自然语言处理
Riona-AI-Agent:自媒体 AI 代理!自动点赞、评论、个性化内容生成和发布等交互任务
Riona-AI-Agent 是一款基于 Node.js 和 TypeScript 的 AI 自动化工具,支持 Instagram、Twitter 等平台的自动化交互,生成高质量内容,提升社交媒体管理效率。
690 13
Riona-AI-Agent:自媒体 AI 代理!自动点赞、评论、个性化内容生成和发布等交互任务
【科研技巧】解决WPS中插入mathtype选项卡为灰色不能使用
解决WPS中Mathtype插件选项卡显示为灰色且无法使用的问题的步骤,包括安装宏组件VBA WPS,复制特定的文件到WPS安装目录和启动目录,并在完成这些步骤后重新打开WPS以使选项卡可用。
2633 0
|
存储 自然语言处理 小程序
微信小程序多语言切换神器:简繁体切换功能完全指南
随着全球化的发展,支持多种语言的应用程序愈发重要。本文介绍了如何在微信小程序中实现简体与繁体字体之间的切换功能,以满足不同地区用户的需求。通过创建utils文件夹并编写相应的转换函数,开发者可以方便地实现语言切换,从而提升用户体验。文章中还附带了示例代码和效果图,帮助读者更好地理解和应用这一功能。
669 0
微信小程序多语言切换神器:简繁体切换功能完全指南
|
Web App开发 缓存 JavaScript
如何排查 Electron V8 引发的内存 OOM 问题(中)
如何排查 Electron V8 引发的内存 OOM 问题(中)
1782 0
|
机器学习/深度学习 编解码 算法
ASF-YOLO开源 | YOLOv5范式永不言败,SSFF融合+TPE编码+CPAM注意力,再战精度巅峰!
ASF-YOLO开源 | YOLOv5范式永不言败,SSFF融合+TPE编码+CPAM注意力,再战精度巅峰!
851 0
setup facatory9.0打包详细教程(含静默安装和卸载)
setup facatory9.0打包详细教程(含静默安装和卸载)
833 0