Используя палитру какао-Automator

Среда разработки Automator включает палитру Interface Builder с объектами пользовательского интерфейса, разработанными для действий. Эту палитру называют Какао-Automator. Для загрузки этой палитры выберите область Palettes в Интерфейсных предпочтениях Разработчика, нажмите Add и выбор AMPalette.palette в /Developer/Extras/Palettes.

Палитра Cocoa-Automator (см. рисунок 4) содержит три специально реализованных всплывающих меню для представления легко конфигурируемых списков приложений, каталогов и файлов пользователям.

Эти списки обеспечивают доступ к стандарту или часто получали доступ к приложениям, папкам и файлам в файловой системе. Например, всплывающее меню Каталогов в действии смотрит что-то как пример на рисунке 5.

Можно также сконфигурировать всплывающие меню так, чтобы пользователи могли определить местоположение элементов кроме стандартных в списке, или (в случае всплывающего меню Каталогов) создают новые элементы.

Для размещения одного из этих всплывающих меню просто перетащите его от палитры до представления действия. Затем для конфигурирования всплывающего меню выберите Show Inspector из меню Tools и выберите область Attributes (рисунок 6). Область Attributes Интерфейсного Разработчика позволяет Вам конфигурировать объект пользовательского интерфейса в различных способах.

Для всплывающих меню Automator (объекты AMPathPopUpButton), специальные опции пути являются следующим:

Типы

Позволяет пользователям выбирать или приложения, каталоги, или файлы или любую комбинацию трех типов. Например, если Вы проверяете Каталоги и Файлы, пользователи в состоянии выбрать и каталоги и файлы от всплывающего меню.

Выбрать

Выбор New Paths добавляет Новый элемент у основания всплывающего меню. Во всплывающем меню Каталогов это позволяет пользователям создавать новый каталог с помощью браузера файловой системы; Новый элемент не появляется в других видах всплывающих меню.

Выбор Existing Paths добавляет Другой элемент у основания всплывающего меню. Во всех типах всплывающего меню этот элемент позволяет пользователям выбирать что-либо в браузере файловой системы.

Дисплей

Когда или Новая или Открытая позиция выбрана и Выбрать Panel, поскольку опция Sheet выбрана, действие выводит на экран браузер файловой системы как окно рабочего листа модальный лист, а не как модальное приложением диалоговое окно.

Показать

Когда опция Standard Paths выбрана, всплывающее меню имеет следующие элементы, в зависимости от своего типа:

• Если это - всплывающее меню Каталогов, стандартные расположения такой как Домой, Рабочий стол, Фильмы, и Изображения включены.

• Если это - всплывающее меню Приложений, список элементов включает все приложения в /Applications.

• Если это - всплывающее меню Файлов, ничто не происходит.

Когда опция Path Components выбрана, полный путь текущего выбранного элемента выведен на экран.

То, когда опция Placeholder выбрана, независимо от того, что Вы входите в текстовое поле Placeholder непосредственно под опцией, выведено на экран как первый раскрывающийся элемент. Этот заполнитель обычно является строкой те, которые “Выбирают приложение” или “Никакой выбор”.

Прежде чем всплывающее меню AMPathPopUpButton может должным образом функционировать в представлении действия, необходимо установить привязку между всплывающим меню и свойством параметров действия. Чтобы сделать это, укажите ключ для свойства как атрибут экземпляра Параметров (см. Привязку Установления для процедуры). Наконец, выберите всплывающее меню в пользовательском интерфейсе и затем укажите ключ в области Bindings инспектора, с помощью привязки пути; посмотрите рисунок 7 для примера.

Установление привязки

После построения представления действия установите привязку между объектами в пользовательском интерфейсе и объекте действия. Привязка является технологией Какао, концептуально базируемой в парадигме Контроллера представления Модели. В Контроллере представления Модели объекты в хорошо разработанной программе принимают одну из трех ролей: просмотрите возражает, что существующие данные и получают ввод данных пользователем; объекты модели, содержащие данные и воздействующие на те данные; и контроллер возражает, что добиваются передачи данных между представлением и объектами модели. Механизм привязки автоматически синхронизирует обмен данными между представлением и объектами модели, сокращая потребность в пользовательских объектах контроллера и всем коде «связующего звена», который они обычно влекут за собой. Действия Automator используют привязку для передавания данных между объектами в представлении действия и словаре параметров (или запись), что все действия должны записать пользователей настроек, указывают для действия.

Шаблоны проекта для действий Automator предварительно сконфигурированы для использования привязки вместо целевого действия и механизмов выхода (для Основанных на какао действий) или обработчики событий, указанные в области AppleScript Интерфейсного Разработчика для находящихся в AppleScript действий. Если Вы предпочитаете, можно использовать эти механизмы вместе с параметрами обновления “платформы Automator” API для обновления параметров действия вручную. Для получения информации об этом подходе посмотрите Обновление Несвязанные Параметры (для находящихся в AppleScript действий) или Обновление Параметров Действия (для действий Objective C).

Следующие шаги суммируют то, что необходимо сделать для установления привязки действия в Интерфейсном Разработчике. Для полного описания технологии привязки Какао посмотрите, что Привязка Какао Программирует Темы.

1. Выберите экземпляр Параметров в окне файла пера и выберите область Attributes окна Info. В маркированных «Ключах» таблицы добавляют ключи для каждого объекта пользовательского интерфейса, установка которого или оценивает Вас, должен получить доступ. Посмотрите рисунок 8 для примера.

   

   Ключи, которые Вы указываете здесь, используются в другом месте в действии для идентификации средств управления действия. Необходимо поэтому использовать те же строки, которые Вы использовали для обязательных ключей в следующих местах в проекте действия:

   • Как ключи для AMDefaultParameters свойство Automator. ( AMDefaultParameters свойство указывает начальные установки действия; посмотрите Указание Свойств Действия и Ссылки Свойства Действия Automator для подробных данных.) Соответствие AMDefaultParameters запись должна быть добавлена для каждого ключа, используемого с привязкой.

   • Как имена переменных экземпляра выхода и методов доступа в действиях Objective C

   • Поскольку ключи к записи параметров передали в находящееся в AppleScript действие в on run обработчик; посмотрите Структуру на Обработчике команды выполнения для получения дополнительной информации.

   • Поскольку переменные окружения установлены для действия сценария оболочки; посмотрите Действия Сценария оболочки Создания для подробных данных.

2. С экземпляром Параметров, все еще выбранным, выберите область Bindings окна Info и разверните подобласть «contentObject». Установите, “Связывают, чтобы” открыть элемент Владельцу Файла и войти parameters в поле «Model Key Path».

   Ключевой путь параметров относится к parameters свойство, определенное классом AMBundleAction — т.е. словарь или запись, используемая для получения пользователей настроек, делает в представлении действия.

3. Для каждого объекта пользовательского интерфейса действия установите привязку с надлежащим ключом параметров. Например, рисунок 9 показывает привязку для всплывающего меню.

   

   Привязка варьируется типом объекта пользовательского интерфейса. Например, всплывающие меню обычно отделываются от индекса элемента (selectedIndex), флажки имеют булевскую переменную value, и текстовые поля имеют строку value.

Когда Вы закончены с пользовательским интерфейсом действия, сохранили файл пера и возвращаетесь к проекту XCode.

Используя подручное меню Automator

Можно отредактировать информационный список свойств как текстовый файл в XCode. Просто дважды щелкните Info.plist файл в окне проекта и файл откроются в отдельном окне или области. Однако синтаксические ошибки могут часто происходить при редактировании списка свойств вручную. Вместо этого можно использовать подручное меню Automator, делающее ввод значений свойств проще и менее восприимчивым к ошибке.

Этот инспектор встроен в XCode для всех типов проектов Automator. Для доступа к инспектору сделайте следующее:

1. Выберите Edit Active Target 'Target' из Меню проектов.

2. Щелкните по вкладке Properties.

Более низкая часть инспектора, обычно резервирующегося для указания типов документов, здесь используется для Automator-специфичных свойств. Инспектор повреждает свойства в логические наборы; первый набор показывает свойства General (рисунок 11).

В представлении инспектора, таком как то на рисунке 11, дважды щелкните по ячейке под Значением для открытия ячейки для ввода значения. Если, например, Вы хотите активировать опцию Show When Run для действия, щелкните по надлежащим флажкам.

Если Вы представите всплывающее меню Набора, то Вы будете видеть другие логические наборы свойств Automator. Рисунок 12 показывает набор для AMAccepts свойство (Ввод).

Когда свойство является массивом, как с AMAccepts, щелкните по знаку «плюс» в левом нижнем углу инспектора для открытия нового поля для редактирования. Введите значение (в этом случае идентификатор типа). Для удаления элемента из массива выберите его и щелкните по знаку «минус».

Локализованные строки

Если Ваше действие программно генерирует строки, и Вы хотите выведенные на экран локализованные версии, необходимо интернационализировать программное обеспечение с помощью методов доступа, отличающихся для действий Objective C и основанных на сценарии действий.

И Objective C и действия AppleScript требуют, чтобы Вы создали для каждой локализации строковый файл, который является файлом с расширением .strings. (Стандартное, или имя по умолчанию для строкового файла Localizable.strings.) Каждая запись в строковом файле содержит ключ и значение; ключ является строкой на языке разработки, и значение является переведенной строкой. Запись может также иметь комментарий для помощи переводчикам. Используйте точку с запятой для завершения записи. Вот несколько примеров:

/* Title of alert panel which brings up a warning about

saving over the same document */

"Are you sure you want to overwrite the document?" =

“Souhaitez-vous vraiment écraser le document ?";

/* Encoding pop-up entry indicating automatic choice of encoding */

"Automatic" = "Automatique";

/* Button choice allowing user to cancel. */

"Cancel" = "Annuler";

Когда Вы завершили a Localizable.strings файл для локализации, необходимо интернационализировать его так же, как Вы были бы любой другой язык - или специфичный для локали файл ресурсов пакета. Посмотрите Файлы ресурсов Интернационализации для сводки.

Для кода Objective C используйте NSLocalizedStringмакрос или один из другого NSLocalizedString... макросы для запроса локализации, подходящей для текущей пользовательской настройки. Перечисление 2 дает пример, показывающий использование NSLocalizedString в сочетании с NSString stringWithFormat: метод.

Перечисление 2  Используя NSLocalizedString в коде Objective C

- (NSString *)displayName

{

    int cnt = [pdfView pageCount];

    NSString *name;

    if (cnt == 1) {

        NSString *format = NSLocalizedString(@"%@ (1 page)",

            @"Window title for a document with a single page");

        name = [NSString stringWithFormat:format, fileName];

    } else {

        NSString *format = NSLocalizedString(@"%@ (%d pages)",

            @"Window title for a document with multiple pages");

        name = [NSString stringWithFormat:format, fileName, cnt];

    }

    return name;

}

Поскольку AppleScript пишет сценарий команды, эквивалентной NSLocalizedString localized string. Один хороший подход должен иметь локальную подпрограмму, берущую строку для локализации в качестве параметра и использующую localized string команда на нем, как в Перечислении 3.

  Обработчик Сценария перечисления 3 для локализации строк

on localized_string(key_string)

return localized string key_string in bundle with identifier "com.apple.Automator.myAction"

end localized_string

В другом месте в main.applescript и в других сценариях для действия, вызовите эту подпрограмму, когда необходимо будет получить строку в текущей локализации:

    if the calendar_name is my localized_string("No Calendars") then        error my localized_string("The copy of iCal on this computer contains no calendars to clear.")

Локализация свойств Automator

Стандартный вариант строкового файла для проектов Infoplist.strings. В этом файле Вы присваиваете локализованные строки (т.е. переводы) к ключам, появляющимся в Info.plist файл. Для Automator это включает не только свойства верхнего уровня такой как AMName но подсвойства свойств Automator. Например, следующая выборка от Infoplist.strings файл для действия Изображений Обрезки:

AMName = "Crop Images";

ApplyButton = "Add";

IgnoreButton = "Don't Add";

Message = "This action will change the image files passed into it.  Would you like to add a Copy Files action so that the copies are changed and your originals are preserved?";

Пары ключ/значение в этом примере включают не только локализованное англичанами значение для AMName свойство, но локализованные строки для подсвойств AMWarning свойство.

Интернационализация файлов ресурсов

Необходимо интернационализировать любой файл в проекте действия, содержащем данные, которые являются определенными для языка или локали. Эти файлы включают:

• Файлы пера

• Файлы образа

• Строковые файлы (Localizable.strings)

• Infoplist.strings

Интернационализация файла ресурсов просто влечет за собой присвоение языка или локали к файлу. Когда Вы разрабатываете проект действия, XCode автоматически помещает ресурс в подкаталог локализации пакета Resources каталог. Подкаталоги локализации имеют расширение .lproj (например, French.lproj).

Для интернационализации файла ресурсов сделайте следующее:

1. Выберите папку Resources в XCode.

2. Добавьте файл к проекту (Проект> Добавляют Файлы).

3. Выберите файл и выберите Get Info из Меню проектов.

4. Нажмите Make File Localizable.

5. Нажмите Add Localization и введите или выберите язык или локаль.

Тестирование и отладка стратегий

Чтобы протестировать Ваше действие, создайте и выполнить проект действия (Сборка> Сборка и Выполнение). Поскольку Automator разрабатывает проект, который он выполняет amlint утилита в фазе сборки. amlint инструмент выполняет проверки целостности, чтобы удостовериться, что должным образом создается действие; например, это проверяет, что были установлены все требуемые свойства Automator. Это интегрирует свои предупреждающие сообщения с другими сообщениями в окне Xcode Build Results. Несмотря на то, что amlint не генерирует сообщения об ошибках (таким образом, останавливающий сборку), необходимо исследовать и решить все проблемы, о которых сообщают, перед созданием версии развертывания из действия. Узнать больше о amlint, см. страницу справочника для него (к которому можно получить доступ из Меню справки XCode).

Когда Automator запускается, необходимо создать поток операций, содержащий действие. Выполните поток операций и наблюдайте, как Ваше действие выполняет. Для получения лучших данных от тестирования рассмотрите следующие шаги:

• Используйте действие Результатов Представления для наблюдения вывода предшествующих действий.

• Используйте Диалоговое действие Подтверждения, чтобы приостановить или отменить выполнение потока операций.

• Добавьте одно каждое из вышеупомянутых двух действий между каждым действием.

Если действие основывается на AppleScript, можно использовать Выполнение действие AppleScript для тестирования Вашего on run обработчик команды, поскольку Вы пишете его.

Если Ваше действие основывается на реализации Objective C, можно отладить действие так же, как Вы были бы любой другой двоичный файл Objective C. Просто установите точку останова в XCode. Когда Ваше действие будет выполнено в Automator, точка останова инициирует в gdb. Можно также отладить действия AppleScript с помощью специального графического отладчика, задающегося для проектов действия AppleScript. Этот отладчик смотрит и ведет себя очень как графический отладчик для gdb делает. Это останавливается в точках останова, выводит на экран переменные и позволяет Вам продвинуться через сценарий. Переменные включают глобальные переменные, локальные переменные и свойства. Рисунок 16 показывает отладчик AppleScript в действии.

Для отладки действий AppleScript можно также вставить log или display dialog операторы в коде. Если оператор журнала в приложении tell блок, используйте tell me to log выражение вместо простого log.

Установка действий

Когда Ваше действие будет полностью отлажено и протестировано, создайте версию развертывания пакета (использующий надлежащую оптимизацию). Тогда создайте пакет установки для действия (или добавьте действие к пакету установки своего приложения). Установщик должен скопировать действие в /Library/Automator или ~/Library/AutomatorВ зависимости от того, должен ли доступ к действию быть в масштабе всей системы или ограничен пользователем установки.

Если действие использует функции того приложения, вместо того, чтобы установить Ваше действие отдельно, можно поместить его в пакете приложения, особенно. Когда Automator ищет действия для отображения, это смотрит в зарегистрированных приложениях также в стандартных каталогах Automator. Преимущество упаковки Ваших действий в приложении состоит в том, что Вы не должны создавать отдельный пакет установки для установки действий. Для установки действий пользователи должны только перетащить приложение к стандартному расположению.

Пакеты действия должны быть сохранены в обертке приложения в Contents/Library/Automator. Таким образом, если Ваше действие MyAction.action и Ваше приложение MyApp.app, путь в приложении был бы:

MyApp.app/Contents/Library/Automator/MyAction.action

Можно или вручную скопировать действие в это расположение (после создания необходимых подкаталогов), или у Вас есть XCode, копируют его с помощью фазы сборки Файлов Копии. Если Вы копируете действие в комплект приложений, но приложение уже установлено в системе, необходимо заставить Launch Services распознавать, что приложение имеет новое содержание для регистрации (т.е. новое действие) путем изменения даты модификации приложения. Можно сделать это путем ввода touch команда в Терминальном приложении.

$> sudo touch /Applications/MyApp.app

Или можно переименовать приложение в Средстве поиска к чему-то еще, возвратить его к настоящему имени, и затем запустить приложение один раз.

Часто задаваемые вопросы об отладке действий Automator

Вопрос: Как я могу определить, какую версию действия Automator использует, если многократные версии моего приложения (возможно содержащий многократные версии действия) установлены (локально или в моей сети)?

Ответ: нет никакого способа указать, какая версия Вашего приложения Automator должен получить действия от того, если установлены многократные версии приложения. Однако существует несколько способов определить версию действия, фактически использующегося:

• В OS X v10.5 при выборе действия в списке Действия Вы видите его версию в представлении описания. Вы можете также Щелчок управления, действие в потоке операций просматривает и выбирает Show in Finder для наблюдения, где действие расположено, так, чтобы можно было исследовать его непосредственно.

• В OS X v10.4, Automator не показывает, что версия действия в описании просматривает или позволяет Вам показывать действие в Средстве поиска. Возможная работа вокруг должна удалить любые нежелательные действия, если та опция доступна Вам, так, чтобы только требуемая версия действия была доступна.

Вопрос: Как я могу просмотреть журнал или сообщения об ошибках?

Ответ: при разработке действия сценария оболочки и выходов действия с ненулевым кодом состояния, что-нибудь, во что действие записало stderr обнаружится в журнале Automator, как описано в Отладке и Тестировании Действий Сценария оболочки.

Если Вы разрабатываете действие AppleScript, вывод операторов AppleScript такой как log или tell me to log появитесь в Консольном журнале (не в журнале Automator).

Если Вы разрабатываете действие Какао, выведенное от NSLog операторы также появятся в Консольном журнале.