Техническое примечание TN2322

Создание какао-AppleScript (AppleScriptObjC) Automator действие

Этот документ объясняет, как использовать шаблон Cocoa-AppleScript (AppleScriptObjC) Xcode для создания действия Automator.

XCode включает шаблон, упрощающий создавать Какао-AppleScript действия Automator. Создание действия с этим шаблоном состоит из выполняющих ключевых шагов:

Создать Какао-AppleScript действие Automator проект XCode:
Сконфигурировать атрибуты и поведение Вашего действия:
Создать интерфейс для Вашего действия:
Отобразить параметр на интерфейсный атрибут элемента:
Добавить код к Вашему действию:
Получать значение параметра в Вашем коде AppleScript:
Протестировать Ваше действие с Automator:
Создавать и устанавливать Ваше действие:
История версии документа

Создать Какао-AppleScript действие Automator проект XCode:

Рисунок 1  
Figure 1 Art/tn2322_figure_01.pngFigure 1 Art/tn2322_figure_01.png
Рисунок 2  
Figure 2 Art/tn2322_figure_02.pngFigure 2 Art/tn2322_figure_02.png
Рисунок 3  
Figure 3 Art/tn2322_figure_03.pngFigure 3 Art/tn2322_figure_03.png

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

Сконфигурировать атрибуты и поведение Вашего действия:

Рисунок 4  
Figure 4 Art/tn2322_figure_04.pngFigure 4 Art/tn2322_figure_04.png
Рисунок 5  
Figure 5 Art/tn2322_figure_05.pngFigure 5 Art/tn2322_figure_05.png
Рисунок 6  
Figure 6 Art/tn2322_figure_06.pngFigure 6 Art/tn2322_figure_06.png
Рисунок 7  
Figure 7 Art/tn2322_figure_07.png
Рисунок 8  
Figure 8 Art/tn2322_figure_08.pngFigure 8 Art/tn2322_figure_08.png
Рисунок 9  
Figure 9 Art/tn2322_figure_09.pngFigure 9 Art/tn2322_figure_09.png
Рисунок 10  
Figure 10 Art/tn2322_figure_10.pngFigure 10 Art/tn2322_figure_10.png
Рисунок 11  
Figure 11 Art/tn2322_figure_11.pngFigure 11 Art/tn2322_figure_11.png
Рисунок 12  
Figure 12 Art/tn2322_figure_12.pngFigure 12 Art/tn2322_figure_12.png
Рисунок 13  
Figure 13 Art/tn2322_figure_13.pngFigure 13 Art/tn2322_figure_13.png

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

Создать интерфейс для Вашего действия:

Рисунок 14  
Figure 14 Art/tn2322_figure_14.pngFigure 14 Art/tn2322_figure_14.png
  
Figure 15 Art/tn2322_figure_15.pngFigure 15 Art/tn2322_figure_15.png
Рисунок 16 рисунка 15  
Figure 16 Art/tn2322_figure_16.png
Рисунок 17  
Figure 17 Art/tn2322_figure_17.png

При добавлении интерфейсных элементов к представлению действия Automator придерживайтесь следующего руководства по проектированию:

Отобразить параметр на интерфейсный атрибут элемента:

Рисунок 18  
Figure 18 Art/tn2322_figure_18.pngFigure 18 Art/tn2322_figure_18.png

Добавить код к Вашему действию:

Рисунок 19  
Figure 19 Art/tn2322_figure_19.pngFigure 19 Art/tn2322_figure_19.png

Получать значение параметра в Вашем коде AppleScript:

Вызовите valueForKey для метода параметров действия, передав его имя параметра, который Вы хотите получить. Например:

Перечисление 1  

valueForKey_("myParameter") of parameters() of me
Рисунок 20  
Figure 20 Art/tn2322_figure_20.pngFigure 20 Art/tn2322_figure_20.png

Для тестирования действия Automator проект XCode необходимо сделать две вещи. Во-первых, необходимо установить Automator как исполнимую программу выполнения для проекта. Во-вторых, необходимо обеспечить параметр, говорящий Automator, где найти действие.

Протестировать Ваше действие с Automator:

Рисунок 21  
Figure 21 Art/tn2322_figure_21.pngFigure 21 Art/tn2322_figure_21.png

Перечисление 2  

-action "$(BUILT_PRODUCTS_DIR)/$(FULL_PRODUCT_NAME)"
Рисунок 22  
Figure 22 Art/tn2322_figure_22.pngFigure 22 Art/tn2322_figure_22.png

После конфигурирования Вашего проекта XCode, как описано выше, выберите Product> Run или введите Команду-R. Экземпляр Automator должен запустить и загрузить Ваше действие. Можно искать библиотеку действия Automator для нахождения его. Теперь, когда Вы сделаны, чтобы прекратить тестировать и разработка резюме, можно протестировать действие и возвратиться к XCode.

Рисунок 23  
Figure 23 Art/tn2322_figure_23.pngFigure 23 Art/tn2322_figure_23.png

Создавать и устанавливать Ваше действие:

Рисунок 24  
Figure 24 Art/tn2322_figure_24.pngFigure 24 Art/tn2322_figure_24.png
Рисунок 25  
Figure 25 Art/tn2322_figure_25.png
Рисунок 26  
Figure 26 Art/tn2322_figure_26.png

После экспорта действия оно может быть установлено в одно из следующих расположений:

/Library/Automator/ - Установите его здесь для предоставления доступа к нему доступным для всех пользователей.

~/Library/Automator/ - Установите его здесь для предоставления доступа к нему доступным для текущего пользователя.

Когда Automator запускается, он сканирует эти папки и загружает любые действия, которые он находит.

Если Вы - разработчик приложений, можно установить действие в a /Contents/Library/Automator/ каталог в Вашем комплекте приложений и Automator найдет его там, также.



История версии документа


ДатаПримечания
26.01.2015

Новый документ, объясняющий, как создать Какао-AppleScript (AppleScriptObjC) Automator действие.