使用 addToKit (Macintosh),新增功能至 Notes® 安裝套件

如果您要在 Macintosh 上安裝 Notes® 用戶端,您可以在安裝或升級 Notes® 之前,使用 addToKit 工具,將已簽署的功能新增至 Notes® 安裝套件中。

執行這項作業的原因和時機

您可以使用 addToKit 工具,在安裝或升級 Notes® 之前,將已簽署的自訂並壓縮的更新網站內容(功能子目錄、外掛程式子目錄及 site.xml 檔案)及自訂的安裝資訊清單 (install.xml),複製到 Notes® 安裝套件結構中,來自訂適用於 Macintosh 的 Notes® 安裝套件。有關所需的檔案結構和簽署資訊,請參閱相關主題。

addToKit 工具會以 addToKit_Mac.pl 形式提供。

addToKit 工具是隨附於 Notes® 安裝套件的 Apps 名錄工具箱的一部分。

在更新壓縮的更新網路目錄的內容之後,請將它放置在與 Notes® 安裝套件結構相同的層次,並使用 addToKit 工具將來源檔案複製至安裝套件的結構中。

使用 addToKit 工具之前,請執行下列作業:

  • 建立並簽署您要新增到 Notes® 安裝套件的任何新 Eclipse 功能。
  • 將新功能和外掛程式 JAR 檔放置到功能和外掛程式更新網站子目錄(updateSite.zip\featuresupdateSite.zip\plugins)中。
  • 建立並驗證新的 site.xml 網站資訊清單檔 (updateSite.zip\site.xml)。
  • 在 deploy 名錄中建立並驗證新的 install.xml 安裝資訊清單 (deploy\install.xml)。

下列資訊在使用 addToKit 工具時非常有用:

  • 因為沒有 AddToKit tool 工具驗證功能,所以請確定您的 XML 經過驗證,且您的 "installfeature" ID 屬性值是唯一的。
  • 您可以執行含或不含引數的 addToKit 工具。
  • addTokitPath 必須包含符合 Notes® 安裝套件格式的 deploy 名錄及已壓縮的 updateSite 名錄。
  • updatesSite.zip\site.xmldeploy\install.xml 資訊會從 addTokitPath 合併到 destKit 路徑,並會覆寫外掛程式及功能。addTokitPath 中的檔案會新增至現有的套件;它們會加在目的地 site.xmlinstall.xml 檔案的最後。
  • 執行沒有引數的工具會將檔案複製至暫存目錄中。如果您未在指令行中指定來源路徑 .\addTokitPath,則預設來源路徑為 .\addToKit。如果您沒有指定目的地路徑 destKit,則預設目的地路徑為現行工作目錄。.\addToKit 值應為預設來源路徑。
  • 執行此工具之前,請將已簽署的功能和外掛程式正確放置在更新網路目錄下,並更新其正確目錄下的 site.xmlinstall.xml 檔案。請壓縮更新網路目錄。

程序

  1. addToKit.zip 解壓縮至您檔案所在的暫存目錄,例如 c:\temp\notes8abx.mac。此 zip 檔包含 AddToKit 名錄,其中含有已壓縮的更新網路目錄 (updateSite.zip) 及部署 (deploy) 名錄。
  2. addToKit_Mac.pl 複製到相同的暫存目錄。
  3. 使用下列指令行執行該工具:
    sudo perl addToKit_Mac.pl [-dhnV] kitPath installPath

    此指令會將 kitPath 的資訊合併到 installPath 中。

    kitPath 識別含有協力廠商 updateSite.zipsite.xml 的資料夾,並預設為「addToKit」。

    installPath 識別 Notes® 安裝 Meta 套件,並預設為 HCL Notes Installer.mpkg

    指令行參數如下所示:
    sudo perl addToKit_Mac.pl -h
    • -d 開啟偵錯功能
    • -h 列印指令行選項用法
    • -n 執行公用程式作為測試 (dry run)
    • -V 列印版本資訊