创建定制附加安装程序

HCL Expeditor框架使您可以创建和使用附加组件安装程序以作为将第三方功能部件或插件部署到现有 Notes® 安装的备用方法。例如，可以创建和使用附加组件安装程序，而不用作为 Notes® 安装工具包的组成部分将定制功能部件部署到用户，也不用使用窗口小部件将定制功能部件部署到现有 Notes® 运行时。

关于此任务

Notes® 附加组件安装程序工具包提供了创建 MSI 安装程序的简洁过程，以将有效 Eclipse 功能部件或插件部署到现有 Notes® 运行时。

定制附加组件安装程序工具在 Expeditor 6.2.1 中提供，并且在 Notes® 安装工具包中以实用程序目录工具包的方式提供。包含 CustomizeAddon.exe 和 AddonConfig.ini 的 notes.addon.installer.toolkit.zip 工具包可在 Notes® 安装工具包的实用程序子目录中找到。

过程

  1. 将提供 notes.addon.installer.toolkit.zip 工具包解压到本地临时目录。
  2. 浏览本地临时目录并打开提供的 AddonConfig.ini 文件。
  3. 添加以下 AddonConfig.ini 属性，预设定的 TARGETUPGRADE 和 TARGETVERSIONS 属性除外。\
    • MSIFileName -- 新 msi 文件名
    • ProductName -- 设置为附加组件的显示名称和版本（仅用于某些面板中的显示目的）
    • ProductNameNoVersion -- 设置为附加组件的显示名称
    • ProductVersion -- 设置为附加组件的版本（格式为：major.minor.build，最大值为 255.255.65535）
    • TargetProductName -- 设置为要安装附加组件的产品的名称（仅用于某些面板中的显示目的）
    • TARGETUPGRADECODE1 -- 此项设置为 Notes® Allclient 工具包值。
    • TARGETUPGRADECODE2 -- 此项设置为 Notes® Notesclient 工具包值。
    • TARGETUPGRADECODE3 -- 此项设置为 Notes® 客户机值。
    • TARGETVERSIONS1 - 预设此值。
    • TARGETVERSIONS2 - 此值为预设值。
    • TARGETVERSIONS3 - 此值为预设值。
    • EMBEDDED -- 如果希望将组件设置为嵌入式附加组件，则设置为“true”；如果希望将组件设置为外部附加组件，则设置为“false”（缺省值）
    • NOLICENSE -- 如果不希望使用 LAP 面板或制定许可证，则设置为“true”；如果希望显示/要求许可证接受并制定许可证文件，则设置为“false”（缺省值）。
    • LicenseDir -- 仅当 NOLICENSE =false 时需要。替换 MSI 中“目录”表格中的缺省 ADDON_~1|ADDON_NAME DefaultDir 值。它还会更新用于许可证的外部目录名称 ( /license/)。这是安装期间放置在磁盘上的许可证文件的目标目录名称 ( /rcp/license/)。

      LicenseDir 值的格式应为 <short name>|<long name> -- 其中 first_six_characters_of_longname~1，示例：Sameti~1|Sametime Advanced

    • UpgradeCode -- 将其修改为唯一代码。缺省情况下，在工具执行后自动生成唯一代码并保存到 AddonConfig.ini 文件中。在附加组件 MSI 的任何未来定制中，此新值必须用于此属性（例如，一旦设置了 UpgradeCode，就不得更改附加组件的 UpgradeCode）。该工具还会修改 Upgrade 表中的 UpgradeCode 条目。
    • XPD_WizardImage -- 指定新位图图像的位置。在 Binary 表中修改后，它使用新位图作为对话框背景图。图像显示在对话框的左侧。或者，您也可以将文件名为“wizard.bmp”的图像放在 <addon source dir> 位置。位图图像大小应为 160 x 314。
    • ARPProduction.exe -- 指定新图标图像的位置。在“图标”表中修改后，它以新图标的形式在“添加/删除程序”中显示。或者，您也可以将文件名为“arpicon.ico”的图像放在 <addon source dir> 位置。
    • LauncherName -- 在 Setup.in 文件中设置 LauncherName 值，并重新命名 setup.exe 文件。
    • EnableLangDlg -- 在 Setup.ini 文件中设置 EnableLangDlg 值。如果希望在安装开始前显示初始语言选择对话框，请将值设置为“Y”。
  4. 将已解压的 CustomizeAddon.exe 工具上移一个目录级别。
  5. 按照此文章中所述，运行 CustomizeAddon.exe。
  6. 在附加安装程序工具包中替换许可证目录中的许可证（如果需要）。
  7. 将部署目录和 updatesite.zip（针对附加组件安装程序将部署的已签名功能部件）添加到附加组件安装程序工具包。
    注： 如果正在使用 deploy.nsf，请将其包含在工具包的 deploy\extras 子目录中。有关信息，请参阅相关任务中的定制安装工具包以设置验证者和信任缺省值。
  8. 确保 Notes® 未在运行。
  9. 运行附加安装工具包的 setup.exe 安装可执行文件，并对所有提示作出回应。