カスタマイズされたアドオンインストーラーの作成

HCL Expeditorフレームワークを使用すると、サードパーティの機能またはプラグインを既存のNotes ®インストールに導入するための代替方法として、アドオン インストーラーを作成して使用することができます。たとえば、 Notes ®インストール キットの一部としてカスタム機能をユーザーに展開したり、ウィジェットを使用してカスタム機能を既存のNotes ®ランタイムに展開したりする代わりに、アドオン インストーラを作成して使用することができます。

このタスクについて

Notes ®アドオン インストーラー ツールキットは、有効な Eclipse 機能またはプラグインを既存のNotes ®ランタイムに導入するための MSI インストーラーを作成するための合理化されたプロセスを提供します。

カスタマイズされたアドオン インストーラー ツールは、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. 事前に設定されている TARGETUPGRADE プロパティと TARGETVERSIONS プロパティを除く、次のAddonConfig.iniプロパティを追加します。\
    • MSIFileName -- 新しい msi ファイル名
    • ProductName -- アドオンの表示名とバージョンに設定します (一部のパネルでのみ表示目的で使用されます)
    • ProductNameNoVersion -- アドオンの表示名に設定します
    • ProductVersion -- アドオンのバージョンに設定します (major.minor.build 形式で。
    • 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/)。これは、インストール中にディスク上に配置されるライセンス ファイルの保存先として使用されるディレクトリ名です (/rcp/license/)。

      LicenseDirの値は次の形式である必要があります。<short name> |<long name> -- 長い名前の最初の 6 文字は ~1 です。例: Sameti~1|Sametime Advanced

    • UpgradeCode -- 変更して一意のコードにします。デフォルトでは、ツールを実行すると、一意のコードが自動的に生成されて AddonConfig.ini ファイルに保存されます。この新しい値は、アドオン MSI の今後のカスタマイズでこのプロパティに使用する必要があります (たとえば、アドオンの UpgradeCode は、一度設定すると変更してはなりません)。このツールは、アップグレード テーブルの UpgradeCode エントリも変更します。
    • XPD_WizardImage -- 新しいビットマップイメージの場所を指定します。バイナリテーブルで変更され、この新しいビットマップがダイアログの背景イメージとして使用されます。このイメージは、ダイアログの左側に表示されます。あるいは、「wizard.bmp」というファイル名の画像を<addon source dir>。ビットマップイメージのサイズは 160 x 314 である必要があります。
    • ARPProduction.exe -- 新しいアイコンイメージの場所を指定します。アイコンテーブルで変更され、この新しいアイコンを使用して [プログラムの追加と削除] に表示されます。あるいは、「arpicon.ico」というファイル名の画像を<addon source dir>。
    • LauncherName -- Setup.ini ファイルに LauncherName 値を設定し、setup.exe ファイルの名前を変更します。
    • EnableLangDlg -- Setup.ini ファイルに EnableLangDlg 値を設定します。インストール開始前に初期言語選択ダイアログを表示する場合は、値を「Y」に設定します。
  4. 解凍した CustomizeAddon.exe ツールを 1 階層上のディレクトリーに移動します。
  5. 記事の説明に従って CustomizeAddon.exe を実行します。
  6. アドオン・インストーラー・キットのライセンスディレクトリーでライセンスを置き換えます (必要な場合)。
  7. (アドオン・インストーラーによってデプロイされる署名付きフィーチャーの) deploy ディレクトリーと updatesite.zip をアドオン・インストーラー・キットに追加します。
    注: deploy.nsfを使用している場合は、キットのdeploy\extrasサブディレクトリに含めます。詳しくは、関連タスクの「インストールキットをカスタマイズして認証者および認証のデフォルトを設定する」を参照してください。
  8. Notes ®が実行されていないことを確認してください。
  9. アドオンインストールキットの setup.exe インストールファイルを実行し、画面の指示に従います。