从命令行工作 | Extension Manager CS6

在 CS4 和更高版本中,可使用命令行执行能在 Extension Manager 工作区中正常执行的各种操作。

Extension Manager 命令行基础知识

可以使用特定语法、命令和属性从命令行管理扩展。

  1. 在 Windows 中,选择“开始”>“所有程序”>“附件”>“命令提示符”以打开命令提示符。在 Mac OS 上,双击“应用程序/实用工具”文件夹中的终端图标以打开终端。
  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 窗口左侧面板中显示的产品名称相同。

    扩展

    指定扩展的名称(按照 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。

    使用 product 属性指定使用扩展的产品。使用 extension 属性指定扩展的名称。

从命令行启用扩展

  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。

    使用 product 属性指定使用扩展的产品。使用 extension 属性指定扩展的名称。

从命令行禁用扩展

  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。

    使用 product 属性指定使用要禁用的扩展的产品。使用 extension 属性指定扩展的名称。

在 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 属性指定要激活扩展集的产品。使用集属性指定要激活的扩展集的名称。

从命令行导入集配置(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),或在终端窗口中使用 sudo 命令 (Macintosh)。

Adobe 徽标

登录到您的帐户