從指令行工作 | Extension Manager CS6

在 CS4 和更新版本中,您可以使用指令行來執行通常在 Extension Manager 工作區中執行的各種作業。

Extension Manager 指令行基礎知識

您可以從指令行使用特定語法、指令和屬性來管理擴充功能。

  1. 在 Windows 中,可以透過選取「開始 > 程式集 > 附屬應用程式 > 命令提示字元」來開啟指令提示。在 Mac OS 中,可以透過在 Applications/Utilities 檔案夾中按兩下 Terminal 的圖示來將其開啟。
  2. 導覽至以下資料夾:

    • Windows: C:\Program Files\Adobe\Adobe Extension Manager CSx\
    • Mac OS: /Applications/Adobe Extension Manager CSx/Adobe Extension Manager CSx.app/Contents/MacOS

    其中 CSx 代表 Extension Manager 版本號碼 (如 CS6)。

  3. 在指令行中,輸入以下可執行程式 (包括雙引號):
    • Windows (CS5 和更新版本): XManCommand.exe
    • Windows (CS4): "Adobe Extension Manager CS4.exe"
    • Mac OS: “./Adobe Extension Manager CSx

    其中 CSx 代表 Extension Manager 版本號碼 (如 CS6)。

  4. 在可執行程式後面輸入需要的指令。

    下表說明可用指令:

    -package

    封裝擴充功能。必要屬性: mxi、mxp (CS5.5 和較舊版本) 或 zxp。

    -install

    安裝擴充功能。必要屬性:mxp 或 zxp。選用屬性: suppresseula (CS5.5 和更新版本)、forallusers (CS6 和更新版本) 及 timeout (CS5 和更新版本)。

    -remove

    移除擴充功能。必要屬性:product、extension。選用屬性 (CS5 和更新版本): timeout。

    -enable

    啟用擴充功能。必要屬性:product、extension。選用屬性 (CS5 和更新版本): timeout。

    -disable

    停用擴充功能。必要屬性:product、extension。選用屬性 (CS5 和更新版本): timeout。

    -activate

    (CS6 和更新版本) 啟用單點產品適用的集合。必要屬性: product、set。

    -import

    (CS6 和更新版本) 從 XML 檔案匯入集合設定。必要屬性: setcfg。

    -convert

    (CS6 和更新版本) 將 mxp 擴充功能轉換為 zxp 擴充功能。必要屬性: mxp 和 zxp。

    -locate

    尋找 Extension Manager 工作區中的單點產品。必要屬性:product。

    -from

    (CS5 和更新版本) 在透過 BridgeTalk 傳遞指令行參數時,指定指令發出者。在執行指令後,Extension Manager 會將結果傳送回指定的發出者。必要屬性: product 或 pcdentry。

    -EMBT

    僅適用於透過 BridgeTalk 傳遞指令行參數時。"-EMBT" 應出現在其他所有指令之前。屬性: 無。

    -suppress

    隱藏 Extension Manager 使用者介面。必須位在其他所有指令 (-EMBT 除外) 之前。屬性: 無。

    -locale

    指定 Extension Manager 啟動時的區域。必要屬性:lang。

    -quit

    (CS5 和更新版本) 結束 Extension Manager。此指令應單獨使用。

    下表說明可用屬性:

    mxi

    指定擴充功能安裝檔的名稱和位置。

    mxp

    指定 MXP 格式封裝檔案的名稱和位置。

    zxp

    指定 ZXP 格式封裝檔案的名稱和位置。

    product

    指定使用擴充功能的產品。值應與顯示在 Extension Manager 視窗左側面板中的產品名稱相同。

    extension

    指定擴充功能的名稱 (如 MXI 檔案中所指定)。

    pcdentry

    (CS5 和更新版本) 指定指令發出者的 BridgeTalk 識別碼。

    suppresseula

    (CS5.5 和更新版本) 指定在安裝擴充功能時是否隱藏 EULA 對話框。有效值為 “y” (隱藏) 或 “n” (不隱藏)。預設值為 “n”。

    forallusers

    (CS6 和更新版本) 如果值為 "y" 且擴充功能是以個別使用者為基礎,則指定應為所有使用者安裝擴充功能。以個別使用者為基礎的擴充功能是一種在安裝時會將檔案複製到使用者專屬資料夾內的擴充功能。預設值為 "n"。

    lang

    指定區域語言代碼,例如 en_US。

    timeout

    (CS5 和更新版本) 指定 Extension Manager 在執行下一個指令前,需等候產品結束的秒數。必須放在 install/enable/disable/remove 指令後面,且需為 0 至 1000 的正整數。

    set

    (CS6 和更新版本) 指定要啟用的集合名稱。

    setcfg

    (CS6 和更新版本) 指定匯出之集合設定檔的名稱和位置。

從指令行封裝擴充功能

  1. 導覽至 Extension Manager 應用程式資料夾。
  2. (Windows) 輸入以下命令,指定您自己的屬性值:
    • (CS4): "Adobe Extension Manager CS4.exe" -package mxi="c:\myfile.mxi" mxp="c:\myfile.mxp"
    • (CS5 和 CS5.5,MXP 格式): "XManCommand.exe" -package mxi="c:\myfile.mxi" mxp="c:\myfile.mxp"
    • (CS5 和更新版本,ZXP 格式): "XManCommand.exe" -package mxi="c:\myfile.mxi" zxp="c:\myfile.zxp"
  3. (Macintosh) 輸入以下命令,指定您自己的屬性值:
    • (CS4/CS5/CS5.5,MXP 格式): "./Adobe Extension Manager CSx" -package mxi="/myfolder/mysubfolder/myfile.mxi" mxp="/myfolder/mysubfolder/myfile.mxp"
    • (CS5 和更新版本,ZXP 格式): "./Adobe Extension Manager CSx" -package mxi="/myfolder/mysubfolder/myfile.mxi" zxp="/myfolder/mysubfolder/myfile.zxp"
  4. 安裝並測試擴充功能,以確保一切運作正常。

在命令列安裝擴充功能

  1. 導覽至 Extension Manager 應用程式資料夾。
  2. (Windows) 輸入以下指令,指定您自己的屬性值:
    • (CS4): "Adobe Extension Manager CS4.exe" -install mxp="c:\myfile.mxp"
    • (CS5 和更新版本,MXP 格式): "XManCommand.exe" -install mxp="c:\myfile.mxp"
    • (CS5 和更新版本,ZXP 格式): "XManCommand.exe" -install zxp="c:\myfile.zxp"
  3. (Macintosh) 輸入以下指令,指定您自己的屬性值:
    • (MXP 格式): "./Adobe Extension Manager CSx" -install mxp="/myfolder/mysubfolder/myfile.mxp"
    • (ZXP 格式): "./Adobe Extension Manager CSx" -install zxp="/myfolder/mysubfolder/myfile.zxp"
  4. 若要隱藏 Extension Manager 使用者介面,請將隱藏命令加在安裝命令前,如下所示:
    ... -suppress -install zxp="c:\myfile.zxp"
  5. 若要指定區域,請在安裝命令前新增區域命令並指定 lang 屬性,如下所示:
    ... -locale lang="en_US" -install zxp="c:\myfile.zxp"
  6. 測試擴充功能,以確保一切工作正常。

從指令行移除擴充功能

  1. 導覽至 Extension Manager 應用程式資料夾。
  2. 輸入以下指令,指定您自己的屬性值:
    • (Windows,CS5 和更新版本): XManCommand.exe -remove product="Dreamweaver CSx" extension="Sample"
    • (Windows,CS4) "Adobe Extension Manager CS4.exe" -remove product="Dreamweaver CS4" extension="Sample"
    • (Macintosh): "./Adobe Extension Manager CSx" -remove product="Dreamweaver CSx" extension="Sample"

    其中 CSx 代表 Extension Manager 版本號碼 (如 CS6)。

    使用產品屬性來指定使用擴充功能的產品。使用擴充功能屬性來指定擴充功能的名稱。

從指令行啟用擴充功能

  1. 導覽至 Extension Manager 應用程式資料夾。
  2. 輸入以下指令,指定您自己的屬性值:
    • (Windows,CS5 和更新版本): XManCommand.exe -enable product="Dreamweaver CSx" extension="Sample"
    • (Windows,CS4): "Adobe Extension Manager CS4.exe" -enable product="Dreamweaver CS4" extension="Sample"
    • (Macintosh): "./Adobe Extension Manager CSx" -enable product="Dreamweaver CSx" extension="Sample"

    其中 CSx 代表 Extension Manager 版本號碼 (如 CS6)。

    使用產品屬性來指定使用擴充功能的產品。使用擴充功能屬性來指定擴充功能的名稱。

從指令行停用擴充功能

  1. 導覽至 Extension Manager 應用程式資料夾。
  2. 輸入以下指令,指定您自己的屬性值:
    • (Windows,CS5 和更新版本): XManCommand.exe -disable product="Dreamweaver CSx" extension="Sample"
    • (Windows,CS4): "Adobe Extension Manager CS4.exe" -disable product="Dreamweaver CS4" extension="Sample"
    • (Macintosh): "./Adobe Extension Manager CSx" -disable product="Dreamweaver CSx" extension="Sample"

    其中 CSx 代表 Extension Manager 版本號碼 (如 CS6)。

    使用產品屬性來指定使用要停用的擴充功能的產品。使用擴充功能屬性來指定擴充功能的名稱。

尋找 Extension Manager 工作區中的單點產品

  1. 導覽至 Extension Manager 應用程式資料夾。
  2. 輸入以下指令,指定您自己的屬性值:
    • (Windows,CS5 和更新版本): XManCommand.exe -locate product="Dreamweaver CSx"
    • (Windows,CS4): "Adobe Extension Manager CS4.exe" -locate product="Dreamweaver CS4"
    • (Macintosh): "./Adobe Extension Manager CSx" -locate product="Dreamweaver CSx"

    其中 CSx 代表 Extension Manager 版本號碼 (如 CS6)。

    使用產品屬性來指定要尋找的產品。

從指令行將 MXP 擴充功能轉換為 ZXP 擴充功能 (CS6 和更新版本)

  1. 導覽至 Extension Manager 應用程式資料夾。
  2. 輸入以下指令,指定您自己的屬性值:
    • Windows: XManCommand.exe -convert mxp="c:\myOldExtension.mxp" zxp=”c:\myNewExtension.zxp"
    • Mac OS: "./AdobeExtension Manager CS6" -convert mxp="/myfolder/mysubfolder/myOldExtension.mxp" zxp="/myfolder/mysubfolder/myNewExtension.zxp"

使用 mxp 屬性來指定要轉換的 MXP 擴充功能。使用 zxp 屬性來指定新 ZXP 擴充功能的路徑和名稱。

從指令行啟用擴充功能集 (CS6 和更新版本)

  1. 導覽至 Extension Manager 應用程式資料夾。
  2. 輸入以下指令,指定您自己的屬性值:
    • Windows: XManCommand.exe -activate product="Dreamweaver CS6" set="Adobe Extensions"
    • Mac OS: "./Adobe Extension Manager CS6" -activate product="Dreamweaver CS6" set="Adobe Extensions"

使用 product 屬性來指定要啟用擴充功能集的產品。使用 set 屬性來指定要啟用之擴充功能集的名稱。

從指令行匯入集合設定 (CS6 和更新版本)

  1. 導覽至 Extension Manager 應用程式資料夾。
  2. 輸入以下指令,指定您自己的屬性值:
    • Windows: XManCommand.exe -import setcfg="c:\SetConfig.xml"
    • Mac OS: "./Adobe Extension Manager CS6" -import setcfg="/myfolder/mysubfolder/SetConfig.xml"

使用 setcfg 屬性來指定要匯入之集合設定檔的路徑和名稱。

透過 BridgeTalk 執行指令

Extension Manager 能執行透過 BridgeTalk 傳遞的指令。所有透過 BridgeTalk 傳送的指令都必須以 "-EMBT" 參數開頭。若要將指令傳送至 Extension Manager,請將目標 BridgeTalk 識別碼指定為 "exman-6.0"。

在 ExtendScript Toolkit CS6 中執行以下範例指令碼,以透過 BridgeTalk 將封裝指令傳送至 Extension Manager。

Windows:
 
var bt = new BridgeTalk();
bt.target = "exman-6.0";
bt.body = '-EMBT -package mxi="C:\\test.mxi" zxp="C:\\test.zxp"';
bt.send();
Mac OS:
 
var bt = new BridgeTalk();
bt.target = "exman-6.0";
bt.body = '-EMBT -package mxi="/Volumes/x1/test.mxi" zxp="/Volumes/x1/test.zxp"';
bt.send();

在執行指令後傳回代碼

當指令包含以下兩個參數之一時,Extension Manager 能在執行指令後提供傳回代碼:

  • "-suppress" (在執行指令時隱藏 Extension Manager 使用者介面)
  • "-from"

在執行指令後,Extension Manager 會傳回以下其中一個傳回代碼:

0 - 命令成功

1 - 無法安裝擴充功能

2 - 無法移除擴充功能

3 - 無法啟用擴充功能

4 - 無法停用擴充功能

5 - 無法封裝擴充功能

6 - 無法啟用擴充功能集

7 - 已有一個 Extension Manager 執行個體

8 - 無法匯入集合設定

101 - CLI 格式錯誤

102 - 指定的產品不存在

103 - 指定的擴充功能不存在

104 - 指定的擴充功能已啟用

105 - 指定的擴充功能已停用

106 - 指定的擴充功能不存在

107 - 指定的集合設定檔不存在

108 - 指定的集合設定檔無效

109 - 當作用中的擴充功能集為預先定義的擴充功能集時,無法啟用或停用指定的擴充功能

備註: 如果執行的指令需要有管理權限、目前的權限不足,則未隱藏使用者介面時,Extension Manager CS5.5 (和更新版本) 會要求您提供管理員憑證。隱藏使用者介面時 (指定 "-suppress" 參數),則會執行失敗。在這種情況下,請以系統管理員身分開啟命令提示字元 (Windows),或是在 Terminal 視窗中使用 sudo 指令 (Macintosh)。

Adobe 標誌

登入您的帳戶