Работа из командной строки | Extension Manager CS6
В версии CS4 и более поздних с помощью командной строки можно выполнять различные операции, которые обычно выполняются в рабочей среде Extension Manager.
Основные понятия о работе с Extension Manager из командной строки
Расширениями можно управлять из командной строки, используя для этого определенный синтаксис, команды и атрибуты.
Перейдите к следующей папке:
- 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.
- Windows (CS5 и более поздние версии): XManCommand.exe
- Windows (CS4): " Adobe Extension Manager CS4.exe "
- Mac OS: “ ./Adobe Extension Manager CSx ”
где CSx — номер версии Extension Manager, например CS6.
В следующем списке описаны все доступные команды.
Создание пакета расширения. Необходимые атрибуты: mxi и mxp (версия CS5.5 и более ранние) или zxp.
Установка расширения. Обязательный атрибут: mxp или zxp. Дополнительные атрибуты: suppresseula (версия CS5.5 и более поздние), forallusers (версия CS6 и более поздние) и timeout (версия CS5 и более поздние).
Удаление расширения. Обязательные атрибуты: product, extension. Дополнительный атрибут (версия CS5 и более поздние): timeout.
Включение расширения. Обязательные атрибуты: product, extension. Дополнительный атрибут (версия CS5 и более поздние): timeout.
Отключение расширения. Обязательные атрибуты: product, extension. Дополнительный атрибут (версия CS5 и более поздние): timeout.
(Версия CS6 и более поздние) Активация набора для необходимого продукта. Необходимые атрибуты: product, set.
(Версия CS6 и более поздние) Импорт конфигурации набора из XML-файла. Необходимый атрибут: setcfg.
(Версия CS6 и более поздние) Преобразование расширения mxp в расширение zxp. Необходимые атрибуты: mxp и zxp.
Поиск необходимого продукта в рабочей среде Extension Manager. Обязательный атрибут: product.
(Версия CS5 и более поздние) Указывает создателя команды, когда параметр командной строки передается через BridgeTalk. После выполнения команды Extension Manager отправляет результат обратно указанному создателю. Необходимые атрибуты: product или pcdentry.
Используется, только когда параметр командной строки передается через BridgeTalk. Команда -EMBT должна стоять перед всеми другими командами. Атрибуты: нет.
Запрещение пользовательского интерфейса Extension Manager. Эта команда должна стоять перед всеми другими командами кроме -EMBT. Атрибуты: нет.
Указание языкового стандарта для Extension Manager при запуске. Обязательный атрибут: lang.
(Версия CS5 и более поздние) Выход из Extension Manager. Эта команда должна использоваться самостоятельно.
В следующем списке описаны доступные атрибуты.
Указывает имя и расположение файла установки расширения.
Указывает имя и расположение файла пакета в формате MXP.
Задает имя и расположение файла пакета в формате ZXP.
Указывает продукт, использующий расширение. Это значение должно совпадать с названием продукта, отображаемым в левой панели окна Extension Manager.
Задает имя расширения (которое указано в файле MXI).
(Версия CS5 и более поздние) Указывает идентификатор создателя команды в BridgeTalk.
(Версия CS5.5 и более поздние) Указывает, нужно ли запретить диалоговое окно лицензионного соглашения для конечного пользователя при установке расширения. Допустимые значения — «y» (запретить) или «n» (не запрещать). Значение по умолчанию — «n».
(Версия CS6 и более поздние) Указывает, что расширение должно быть установлено для всех пользователей, если значение — «y» и устанавливается расширение в расчете на пользователя. Расширение в расчете на пользователя — это вид расширения, файлы которого во время установки копируются в папки конкретного пользователя. Значение по умолчанию — «n».
Указывает код языка, например ru_RU.
(Версия CS5 и более поздние) Указывает максимальное время в секундах, в течение которого Extension Manager ожидает завершения работы продукта перед выполнением следующей команды. Этот атрибут должен быть указан после команд install/enable/disable/remove, и его значение должно быть положительным целым числом от 0 до 1000.
(Версия CS6 и более поздние) Указывает имя набора, который нужно активировать.
(Версия CS6 или более поздние) Указывает имя и расположение экспортированного файла конфигурации набора.
Создание пакета расширения из командной строки
- Перейдите в папку приложения Extension Manager.
- (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"
- (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"
- Установите и протестируйте расширение, чтобы убедиться в правильной работе всех компонентов.
Установка расширения из командной строки
- Перейдите в папку приложения Extension Manager.
- (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"
- (Macintosh) Введите следующую команду, указав собственное значение атрибута:
- (Формат MXP): "./Adobe Extension Manager CSx" -install mxp="/myfolder/mysubfolder/myfile.mxp"
- (Формат ZXP): "./Adobe Extension Manager CSx" -install zxp="/myfolder/mysubfolder/myfile.zxp"
- Чтобы запретить пользовательский интерфейс Extension Manager, добавьте команду supress перед командой install следующим образом: . -suppress -install zxp="c:\myfile.zxp"
- Чтобы указать язык, добавьте команду locale и задайте атрибут lang перед командой install следующим образом: . -locale lang="ru_RU" -install zxp="c:\myfile.zxp"
- Протестируйте расширение, чтобы убедиться в правильной работе всех компонентов.
Удаление расширения из командной строки
- (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» укажите имя расширения.
Включение расширения из командной строки
- (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» укажите имя расширения.
Отключение расширения из командной строки
- (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
- (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 и более поздние)
- Перейдите в папку приложения Extension Manager.
- Введите следующую команду, указав свои собственные значения атрибутов:
- 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 и более поздние)
- Перейдите в папку приложения Extension Manager.
- Введите следующую команду, указав собственное значение атрибута:
- 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 и более поздние)
- Перейдите в папку приложения Extension Manager.
- Введите следующую команду, указав собственное значение атрибута:
- 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.
Коды возврата после выполнения команд
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).