AppleScript UI-скриптинг для macOS

AppleScript умеет не только управлять приложениями через их собственные «слои» автоматизации, но и симулировать действия пользователя — нажимать кнопки, вводить текст и выбирать пункты меню через UI-скриптинг. Включите доступность, используйте keystroke и System Events, а для сложных интерфейсов анализируйте дерево элементов через UIElementInspector. В статье — пошаговая методика, готовые сниппеты, чек-листы и рекомендации по отладке.

Логотип AppleScript на Mac

firstimage=”https://www.makeuseof.com/wp-content/uploads/2011/03/applescript.jpg”

Как использовать AppleScript — пример интерфейса

AppleScript — мощный инструмент автоматизации macOS. Но не все приложения предоставляют встроенные AppleScript-скрипты. В таких случаях UI-скриптинг (Automation через системные события) заполняет пробелы: он эмулирует действия пользователя. Эта инструкция объяснит, как настроить среду, писать надёжные скрипты и отлаживать взаимодействие с любым приложением, даже если у него нет родной поддержки AppleScript.

Почему UI-скриптинг полезен

Позволяет автоматизировать приложения без AppleScript-слоя.
Работает с диалогами, всплывающими окнами и нестандартными элементами.
В сочетании с Automator даёт гибкий инструмент для повторяющихся задач.

Важно: UI-скриптинг опирается на элементы интерфейса. Изменение интерфейса приложения (обновление, локализация) может сломать скрипт. Планируйте поддержку.

Обновите базовые знания AppleScript

Если вы давно не работали с AppleScript, освежите основные конструкции: tell-блоки, переменные, условные операторы и циклы. Эта статья не учит синтаксису с нуля — она фокусируется на практическом применении UI-скриптинга.

Включите UI-скриптинг в macOS

Чтобы управлять интерфейсом программ, нужно дать macOS разрешение на управление устройством для Assistive Access.

Откройте Системные настройки → Универсальный доступ (или Доступность).
В разделе «Доступ для вспомогательных устройств» (или «Полный доступ к управлению») включите разрешение для нужных приложений (обычно Terminal, Script Editor, Automator, или ваше приложение-лаунчер).

Включить доступность для AppleScript в macOS

Важно: после включения может понадобиться перезапустить приложение, которому вы дали доступ.

Базовые приёмы: ввод клавиш и модификаторов

Самый простой способ взаимодействия с UI — симулировать нажатия клавиш.

Примеры (вставляйте эти фрагменты в Script Editor):

tell application "System Events"
    -- Открыть окно Find в TextEdit: Command-F
    keystroke "f" using {command down}
    -- Ввести текст
    keystroke "искомый текст"
    -- Перейти к следующему полю: Tab
    keystroke tab
    -- Ввести текст замены
    keystroke "текст замены"
    -- Нажать Command-Shift-S: сохранить как
    keystroke "s" using {command down, shift down}
end tell

Короткие подсказки:

keystroke “a” — вводит символы.
keystroke tab — отдельная команда для клавиш, не символов.
Модификаторы: {command down}, {option down}, {control down}, {shift down}.

Пример поиска и замены в TextEdit с помощью AppleScript

Нажатие кнопок и выбор пунктов меню

Когда окно содержит кнопки или меню, вы можете кликнуть их напрямую:

tell application "System Events"
    tell process "TextEdit"
        click button "Replace All" of window 1
    end tell
end tell

Если кнопка внутри группы или листа (sheet), укажите путь к элементу. Частая ошибка — указать имя видимого окна; иногда требуется использовать window 1.

Как находить элементы интерфейса: UIElementInspector

Для надёжных скриптов нужно знать, как элементы действительно организованы. UIElementInspector (бесплатный, сторонний инструмент) показывает дерево элементов в реальном времени: вы просто наводите мышь — и инспектор показывает, чему соответствует этот элемент в иерархии.

UIElementInspector показывает иерархию элементов интерфейса

Пример иерархии и соответствующего кода:

-- Структура: sheet 1 -> group 1 -> group 1 -> pop up button 1
tell application "System Events"
    tell process "Пример"
        tell group 1 of group 1 of sheet 1 of window 1
            tell pop up button 1
                click
                -- затем выбрать пункт меню
                click menu item "Rich Text (RTF)" of menu 1
            end tell
        end tell
    end tell
end tell

Последовательность действий для Find/Replace в AppleScript

Совет: часто приходится экспериментировать — менять номера (group 1 → group 2) или использовать имена элементов, если они доступны.

Пример: сохранить документ как RTF

Сценарий действий, который выполняет: открыть Save As, выбрать формат RTF и сохранить.

Мини-алгоритм:

Вызывать команду «Save As» комбинацией клавиш или меню.
Дождаться появления sheet/окна сохранения.
Кликнуть выпадающее меню формата и выбрать RTF.
Нажать кнопку Save.

Кодовый пример (фрагмент):

tell application "System Events"
    tell process "TextEdit"
        -- Открыть Save As
        keystroke "s" using {command down}
        delay 0.5
        -- Указать путь через элементы окна сохранения
        tell sheet 1 of window 1
            click pop up button 1
            click menu item "Rich Text (RTF)" of menu 1
            click button "Save"
        end tell
    end tell
end tell

Пример сохранения как RTF через UI-скрипт

Важно: иногда UIElementInspector «не видит» временное окно над основным окном. В таких случаях используйте window 1 и уточняйте sheet 1.

Отладка: что делать, если скрипт не работает

Проверьте, что вы дали приложению доступ для управления (Системные настройки → Доступность).
Убедитесь в правильном имени процесса: используйте UIElementInspector или ps для подтверждения.
Добавляйте delay (0.2–0.8 сек) между шагами, особенно при открытии окон.
Попробуйте заменить числовые индексы (button 1) на имена, если они есть.
Локализация: в разных языковых версиях macOS подписи кнопок меняются. Для скриптов, работающих в нескольких локалях, выбирайте путь по индексу или используйте проверку языка.

Когда UI-скриптинг не подходит

При высоконагруженных или сильно анимированных интерфейсах — тайминги станут ненадёжными.
Для приложений с динамическими интерфейсами (частые обновления) — поддержка скрипта будет требовать постоянных исправлений.
Когда нужна высокая степень точности/надёжности (например, банковские операции) — лучше использовать официальные API или CLI-инструменты.

Альтернативные подходы

Используйте встроенные AppleScript-объекты приложения (если доступны) — они надёжнее.
CLI/скрипты на Python/Swift с Apple Events (ScriptingBridge) для более крупных решений.
Automator + AppleScript для составных задач.

Мини‑методология: как быстро написать и поддерживать UI-скрипт

Сформулируйте задачу шагами пользователя.
Включите доступность в macOS.
Снимите структуру элементов через UIElementInspector.
Напишите прототип с keystroke и click.
Добавьте delay для стабильности.
Тестируйте в разных сценариях (пустой документ, открытый документ, ошибки).
Документируйте «рабочие» версии приложения и macOS.

Чек-листы по ролям

Разработчик:

Включил System Events в разрешениях.
Использует UIElementInspector для точных путей.
Добавил обработку ошибок и delay.

Power User:

Записал сценарий в Script Editor.
Проверил работу с типичными документами.
Сделал резервную копию скрипта.

QA/Тестировщик:

Протестировал на двух версиях macOS.
Проверил локализации (кнопки на разных языках).
Описал шаги воспроизведения ошибок.

Сниппет-чит‑шит: часто используемые конструкции

-- Общий шаблон
tell application "System Events"
    tell process "AppName"
        -- Навигация по дереву
        click button 1 of group 2 of window 1
        keystroke "text" -- ввод
        keystroke tab -- Tab
    end tell
end tell

-- Клик по пункту меню
click menu item "Save As..." of menu 1 of menu bar item "File" of menu bar 1

Факторы стабильности: delays, проверка существования окна, использование try/on error для логирования.

Факто-бокс: основные правила

Всегда включайте доступ «Управление устройством».
Используйте UIElementInspector для точной адресации.
Добавляйте задержки и обработку ошибок.
Помните о локализации интерфейса.

Критерии приёмки

Скрипт выполняет весь сценарий без вмешательства в 90% тестовых прогонов (если нужны метрики — замените на ваши).
Скрипт корректно обрабатывает отсутствие ожидаемого окна — выдаёт читаемое сообщение об ошибке.
Скрипт документирован: список версий приложений и macOS, для которых он тестирован.

Короткий глоссарий (1 строка)

UI-скриптинг: эмуляция действий пользователя через System Events.
UIElementInspector: инструмент для просмотра иерархии UI-элементов.

Потенциальные риски и их смягчение

Риск: интерфейс обновился → скрипт сломался.
Митигирование: версияция скриптов и автоматические тесты после обновления приложения.

Риск: локализация кнопок.
Митигирование: использовать индексы элементов или дополнительную проверку языка.

Краткие рекомендации по безопасности и конфиденциальности

Не передавайте скрипту пароли в явном виде. Если автоматизация требует вводить учётные данные, используйте Keychain или защищённое хранилище и минимизируйте скрипты с вводом секретов.

Decision flowchart

flowchart TD
  A[Начало: что нужно автоматизировать?]
  A --> B{Есть ли AppleScript-слой?}
  B -- Да --> C[Использовать встроенные команды приложения]
  B -- Нет --> D{Можно ли управлять через CLI/API?}
  D -- Да --> E[Использовать CLI/API]
  D -- Нет --> F[Использовать UI-скриптинг]
  F --> G[Использовать UIElementInspector, добавить delays и обработку ошибок]
  G --> H[Тест, документирование и поддержка]

Заключение

UI-скриптинг расширяет возможности AppleScript и позволяет автоматизировать те задачи, для которых нет готовых интерфейсов автоматизации. Работайте по методологии: планируйте, инспектируйте, прототипируйте, добавляйте задержки и тестируйте в разных условиях. Сочетание UI-скриптинга и Automator даёт мощный инструмент для повышения производительности на macOS.

Какие задачи вы автоматизировали с помощью AppleScript? Поделитесь примерами и трудностями — это поможет улучшить общие подходы.

Пример команд keystroke и модификаторов в AppleScript