В версии CS4 и более поздних с помощью командной строки можно выполнять различные операции, которые обычно выполняются в рабочей среде Extension Manager.

Основные понятия о работе с Extension Manager из командной строки

Расширениями можно управлять из командной строки, используя для этого определенный синтаксис, команды и атрибуты.

  1. Чтобы запустить командную строку в Windows, выберите «Пуск» > «Все программы» > «Стандартные» > «Командная строка». На Mac OS запустите программу Terminal, дважды щелкнув ее значок в папке Applications/Utilities.
  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 и более поздние) Указывает, нужно ли запретить диалоговое окно лицензионного соглашения для конечного пользователя при установке расширения. Допустимые значения — «y» (запретить) или «n» (не запрещать). Значение по умолчанию — «n».

    forallusers

    (Версия CS6 и более поздние) Указывает, что расширение должно быть установлено для всех пользователей, если значение — «y» и устанавливается расширение в расчете на пользователя. Расширение в расчете на пользователя — это вид расширения, файлы которого во время установки копируются в папки конкретного пользователя. Значение по умолчанию — «n».

    lang

    Указывает код языка, например ru_RU.

    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, добавьте команду supress перед командой install следующим образом:
    ... -suppress -install zxp="c:\myfile.zxp"
  5. Чтобы указать язык, добавьте команду locale и задайте атрибут lang перед командой install следующим образом:
    ... -locale lang="ru_RU" -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.

    С помощью атрибута product укажите продукт, который нужно найти.

Преобразование расширения 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, чтобы передать команду пакета в Extension Manager через BridgeTalk.

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 в программе Terminal (Macintosh).

Эта работа лицензируется в соответствии с лицензией Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported  На посты, размещаемые в Twitter™ и Facebook, условия Creative Commons не распространяются.

Правовые уведомления   |   Политика конфиденциальности в сети Интернет