InstallShield2010学习笔记 - 编译调试构建.doc

1 InstallShield 学习笔记学习笔记 调试项目调试项目 Revision History DATEREVISIONAUTHORDESCRIPTION Table of Contents 1前言前言 1 2编译 编译 COMPILE 2 2 1编译选项设置 2 2 2编译功能导航 3 2 3编译信息输出 3 3调试 调试 DEBUG 4 3 1调试选项设置 4 3 2调试功能导航 5 3 3调试功能介绍 6 3 4调试信息输出 7 3 5在客户终端机上调试 7 4构建 构建 BUILD 8 4 1构建单个 EXE 文件 8 4 2批处理构建 8 5版本 版本 RELEASE 9 5 1版本向导 RELEASE WIZARD 9 1 前言前言 本文档是笔者在学习 InstallShield IDE 的过程中 查阅 InstallShield 2009 IDE的联机帮助 结合个人学习心得 体会 写出的学习笔记 鉴于篇幅有限 本文仅就 InstallShield IDE提供的编译 调试 和构建功能作了一些基本 介绍 仅供新手入门作参考之用 若读者有意深入研究高级进阶内容 请参考 InstallScript IDE 集成开发环境 自带的联机帮助 或者在网上搜 寻参考资料 附 InstallShield 社区论坛 2 2 编译 编译 Compile 2 1编译选项设置编译选项设置 用户可以先在 InstallShield IDE中定义编译相关设置 请注意这些设置仅对当前被打开的项目有效 用户从 Build 菜单列表中选择 Settings 菜单项 然后在弹出的对话框里打开 Compile Link 标签页 如下图所示 对于上面对话框中各设置项的作用 下表作了详细说明 属性名属性名属性值属性值 例子 使用说明使用说明 Preprocessor Defines USAGE Internal 设置预处理常量 此例中定义了名为 USAGE 的常量 可以在编译时直接被脚本文件使用 比如在主脚本中可以这样用 ifdef USAGE 执行一些代码 endif Include Pathes Script C IS Projects AA Script Files 指定上面的预定义值的使用范围 在这里指定的路径下面的所有 script 文件 都可以引用该值 注 多路径用逗号隔开 允许嵌入 路径相关的变量 Maximum Warnings 50指定最多显示的警告 warning 的条 数 此例中设为 50 条 Warning Level选择以下列表项目之一 None Level 1 Level 2 或 Level 3 默认 None 不显示警告消息 Level 1 显示 InstallShield 不能处 理的任何系统警告 3 Level 2 显示 Level 1 消息 如果字 符串长度超过限制则追加另一 条消息 Level 3 默认 显示所有警告消息 Maximum Errors50指定最多显示的错误 error 的条数 此例中设为 50 条 Compile before build 选中 或不选中该复选框若选中 在 build release 之前会自 动编译脚本 Warnings as errors选中 或不选中该复选框若选中 会把警告 warning 当成错 误 error 来处理 那么当 script 编译 时有警告时 InstallShield 不会继续 执行下去 Generate inline debugging information 选中 或不选中该复选框若选中 安装脚本中创建的对象的调 试信息将在编译时被打包进安装程序 中 一般仅用于开发阶段 Libraries obl 后缀为 obj 文件的路径指定编译时需要链接的对象库文件 obl 的完整路径 允许嵌入路径相关 的变量 若有多个路径则用逗号隔开 2 2编译功能导航编译功能导航 当开发者改动了项目的 setup script 后 可以先编译此项目 以及早发现脚本语法错误及其它的配置问题 在项目已经打开的情况下 开发者可以从 Build 菜单列表中选择 Compile 菜单 或者在工具条上点击 Compile 按钮 从而启动编译当前项目 如下图所示 2 3编译信息输出编译信息输出 当编译完成后 InstallShield IDE下面的输出窗口 Output Window 中的 Compile 标签页会打开 显示编译输出的文本信息 成功或者失败 如下图所示的 Compile 窗口输出 4 当本次编译失败时 毗邻的 Tasks 标签页会列出出错的代码行号和源头 当用户可以双击其中某一行时 脚本编辑窗口 Script Editor 自动跳转定位到脚本中的该行 如下图所示的 Tasks 窗口输出 3 调试 调试 Debug 3 1调试选项设置调试选项设置 用户可以先在 InstallShield IDE中定义调试相关设置 请注意这些设置仅对当前被打开的项目有效 用户从 Build 菜单列表中选择 Settings 菜单项 然后在弹出的对话框里打开 Run Debug 标签页 如下图所示 5 下表详细说明了该对话框中各设置项的作用 属性名属性名属性值属性值 例子 使用说明使用说明 Setup Command Line Arguments 其值可以是任何一个字符串 比如此例中输入的是自定义的 一串选项值 这里输入的字符串会保存在系统变量 CMDLINE 中 通过 InstallShield 运 行的安装可以直接调用其值 开发者 一般用它来定义一些开关类选项 控 制 setup script 的行为 Generate MIF File选中 或不选中该复选框若选中 通过 InstallShield 运行安装 时 会生成一个管理信息格式 mif 的文件 注 当此复选框选中时 后面两个 文本框会被激活 MIF FilenameMIF 文件的文件名这里输入的文件名 mif 会在 InstallShiled 运行安装的时候产生 若留为空 默认文件名为 Setup mif Product Serial Number 产品序列号这里输入的序列号会写入上面生成 的 mif 文件中 3 2调试功能导航调试功能导航 InstallShield IDE提供了一个代码级别的调试器 可以供开发者深入脚本代码内部 去定位错误或 者输出调试信息 开发者可以从 Build 菜单列表选择 Debug 菜单 或者按下键盘上的 F5 按键 从而启动脚本调试器 6 3 3调试功能介绍调试功能介绍 当开发者点击了 Debug 菜单或者按钮后 见 3 1 调试功能导航所示图片 InstallShield IDE首先会 build 出安装 程序 然后弹出调试器窗口供开发者使用 其界面如下 调试器窗口工具栏上有一些用于调试的功能按钮 在Debug菜单列表中也可以找到对应的菜单项 各功能按钮的用途详见下表 按钮图标按钮图标按钮名称按钮名称按钮功能按钮功能 Open 点击按钮 选择并打开本地磁盘文件 浏 览其内容 Toggle Breakpoint 点击按钮 在光标所在行添加断点 若该行已有断点 点击此按钮将取消它 Go 点击按钮 调试器会运行脚本代码到下一 断点处停止 Break 点击按钮取消正在运行的调试 此按钮跟上一按钮是互斥操作 Step Into 点击按钮执行下一行语句 如果该行调用了用户自义函数 调试器也会 步入该函数体逐步执行 Step Over 点击按钮执行下一行语句 如果该行调用了用户自义函数 调试器不会 步入该函数体 而是在该函数被调用完之后 的一行继续执行 Step Out 点击按钮从当前被调用的函数体中内部跳 7 出 比如开发者先使用 Step Into 按钮 步 入了一个函数体内部 然后可以点击此 Step Out 按钮从该函数体内部跳出到外面 调用行 继续执行 Show Next Statement 点击按钮显示当前脚本中下一处声明当前脚本中下一处声明 我们在Degger窗口中滚屏浏览代码后 可点击此按钮快速定位到当前脚本的执行处 3 4调试信息输出调试信息输出 调试器窗口下部有两个窗口 在脚本被执行期间 它们会实时显示相关输出信息 Local 窗口实时输出当前被执行函数 自定义 内部的所有局部变量 local variables 的值 该窗口里面的信息只可读 不可修改 见下面左图 Watch 窗口实时输出用户自行添加的监控项 watch 的值 观测项可以是变量名或常量名 用户可以通过右键菜单添加或者在表格中直接输入 见下面右图 3 5在客户终端机上调试在客户终端机上调试 前面的四小节 3 1 3 4 我们讨论的是在开发者本机上利用 InstallShield IDE 的调试方法 在现实情况下 我们编译出来的的安装程序在本机上测试正常 然而发布给客户后 在客户的终端机器上却出现各种问题 因为客户机器上面一般没有安装 InstallShield IDE 开发环境 我们也不可能用开发者常规的方式来进行调试 这时候我们就要使用下面的步骤进行在客户机器上进行现场调试 1 从开发者本机上 InstallShield 安装目录 System 下面 找到名为 ISDbg exe 程序 拷贝到将要执行调试的客户 机器上面的任一文件夹 注 在该目录下有其帮助文档ISdbg chm 可以一并拷贝过去 以便客户参考 2 接着在客户机器上面 打开一个命令行窗口 敲入下面的命令来注册这个 exe 程序 假设其目录为C debug 8 C debug ISDbg exe REGSERVER 3 在开发者本机上编译并构建安装程序 若以前已经构建过 此步可以省略 4 从开发者本机上找该项目构建出来的文件夹 包括Disk Images子文件夹 拷贝到将要执行调试的 客户机器上的任一文件夹 例如 假设开发者本机上该项目的根目录是 C IS Projects AGIS 那么要拷贝的文件夹是 C IS Projects AGIS Media SINGLE EXE IMAGE Disk Images Disk1 注 以上路径中最后一层Disk1 在实际情况下可能是Disk2 Disk3等等 请酌情选择 另外 如果开发者机器上的目录可以共享给将要执行调试的客户机器 这一步可以省略 5 在客户机器上 打开一个命令行窗口 使用 d 参数调用安装程序 比如 Setup exe 该参数后面紧跟将要生成的 log 文件的路径 比如下面的命令行例子 C debug Setup exe d C debug 此时安装程序界面会照常弹出 供客户操作完成安装 同时 InstallShield 的 Debugger 窗口也会显示 并随着 客户在安装程序界面上的操作 该窗口会实时显示当前执行的代码 并输出当前的局部变量 当然客户也可以 自己添加的监控项 参见3 4 调试信息输出 4 构建 构建 Build 4 1构建单个构建单个 EXE 文件文件 在项目编译没有错误发生的情况下 我们可以构建出最终的可执行型安装程序 exe 这个操作非常简单 用户可以在 Build 菜单列表中选择 Build 或 Refresh Build 然后等待项目编译和构 建完毕 在项目的 Media SINGLE EXE IMAGE Package目录下会看到生成的 EXE 文件 见下图 注 Build会执行完整的构建 而Refresh Build只会重建上次build之后被修改的部分 4 2批处理构建批处理构建 用户也可以使用批构建 Batch Build 方式 一次构建预先定义的各个版本 release 和单个的 EXE 程序文件 在 InstallShield IDE中 打开 Build 菜单列表 选择 Batch Build 菜单项 然后会看到如下左图所示的对话框 勾选之后 点击 Build 按钮 即开始了批构建 完毕后 在项目的 Media 文件夹下面可以看到各自生成的 子文件夹 如下右图所示 9 5 版本 版本 Release 在安装程序被发布给测试人员或者最终用户之前 开发者应该创建一个对应的版本 release 一个版本配置了一些安装相关的信息 也包含了将被发布到软盘 光盘 文件夹 或者其它媒介载体上的 文件 创建版本最常见的方式是使用 InstallShield IDE 自带的版本向导 Release Wizard 5 1版本向导版本向导 Release Wizard 版本向导 Release Wizard 是 InstallShield 提供的一个辅助功能 它提供了十五个连续的配置页面 引导用户逐步填入各类配置信息 最后根据收集的配置信息生成该版本所包含的数据文件和执行文件 这些文件可以被直接打包发送给最终用户 或者烧录到光盘等媒介载体作为安装盘 在 InstallShield IDE界面上 点击菜单栏上的 Build 菜单 然后在其展开的列表中点击菜单 或在工具栏上 点击按钮 此时版本向导对话框会弹出 下面我们对它的十五个配置页面逐一说明 注 某些配置页面仅在某些特定类型的安装项目才出现 1 第一个页面 是 Welcome 页面 请直接点击 Next 按钮进入下一页面 2 第二个页面 是 Specify a Release 页面 可以输入一个新 release name 或者选择现有的某个 release 3 第三个页面 是 Media Type 页面 可以选择 CD ROM Custom Network Image 等作为此版本发布使用的 媒介载体 注 如果选择的类型是Custom 页面下面的Format Size文本框会激活 供用户输入 4 第四个页面 是 General Options 页面 配置安装程序的一些属性信息 5 第五个页面 是 Password 页面 允许设置一个密码 在安装程序运行之前会要求用户输入该密码并验证 6 第六个页面 是 Platforms 页面 选择安装程序支持的所有操作系统平台 注 如果安装程序中的某个component关联的平台 没有在这个页面选中 那么该component不会被打包 到这个release中 7 第七个页面 是 Setup Languages 页面 选择安装程序支持的所有语言 从而最终用