FSEvents: Разбираемся с мониториногом событий файловой системы в macOS
Механизм FSEvents состоит из трёх базовых частей:
Изначально информация о событиях хранится в памяти. Когда происходит событие, ему назначается 64-битный идентификатор. Может получиться так что событие пришло с уже назначенным идентификатором, в этом случае, просто обновятся флаги. После того, как буфер памяти заполнится события записываются на диск.
Подписываемся на события программно
Если тебя больше интересует возможность подписаться на события и слушать их программно, то предлагаю реализовать для этого несложный класс, который будет подписываться на уведомления в заданной директории и возвращать информацию об изменениях (путь к файлу и флаги изменений) в колбек.
Подписываемся на поток событий файловой системы
Откроем Xcode и создадим новый проект, это будет Cocoa App (на вкладке macOS), язык выберем Swift. Создадим новый класс (File > New > File > macOS > Swift file) под названием FSEventsService и напишем следующий код:
Здесь мы просто объявили класс и создали несколько переменных. Теперь нам нужно запустить мониторинг событий, для этого определим следующий метод:
Теперь осталось создать поток событий и передать в него необходимую информацию, а именно:
После этого остаётся только добавить поток событий в RunLoop (часть инфраструктуры отвечающая за обработку асинхронных событий, приходящих в поток) и запустить мониторинг.
Обрабатываем полученные события
Реализация колбэка будет выглядеть так:
Здесь мы получаем экземпляр нашего класса из контекста и записываем его в переменную mySelf. Из нее извлекаем колбек, который мы передали при инициализации нашего класса, пробегаем в цикле по пришедшим событиям, в нём создаем структуру, которая содержит информацию о событии (идентификатор события, путь и флаги) и передаем ее в этот коллбек.
Структура с информацией о событии выглядит следующим образом:
Останавливаем получение событий
Здесь все достаточно просто: нужно вызвать несколько методов для остановки потока событий:
Вызов этого метода можно добавить, например, в deinit :
Использование класса
На этом написание простейшей обёртки закончено, мы теперь легко можем получить события от файловой системы, например:
После запуска в логе приложения можно будет увидеть строки с измененными файлами. Перед запуском нужно не забыть отключить Sandbox (выбрать проект в инспекторе слева, перейти на вкладку Capabilities, отключить App Sandox), иначе у приложения будет доступ к файловой системе только внутри песочницы.
Фильтрация событий
В результате работы нашего класса, мы получили флаг события, который представляет собой битовую маску. Apple заранее определила определила для нас костанты с флагами, соотвествующими опредлённому типу события. Например, если мы захотим отфильтровать только события с созданием файла, это будет выглядеть следующим образом:
Подбирая комбинации флагов, можно гибко настроить получаемый поток событий под собственные нужды. Полный список флагов можно найти в документации.
Заключение
Сегодня мы рассмотрели реализацию собственной обертки над API FSEvents, если не считать взаимодействие с API на C, то использовать из Swift его довольно просто и не должно вызвать затруднений. На GitHub можно найти большое количество библиотек, схожих с тем, что мы реализовали сегодня. Пользоваться ими или нет, нужно решать исходя из конкретных задач: с одной стороны зачем писать лишний boilerplate, когда кто-то его уже написал за тебя, а с другой стороны в сложных решениях, всё равно приходится разбираться с внутренним устройством библиотек и докручивать их под специфичные нужды заказчика, так что может быть имеет смысл написать такой класс с нуля.
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет доступ к уведомлениям о системных событиях. Этот класс не наследуется.
Примеры
Этот раздел содержит два примера. в первом примере показано, как использовать системные события в обычном приложении, а во втором примере показано, как использовать системные события в службе Windows.
Пример 1
Следующий пример кода регистрирует интерес в некоторых системных событиях, а затем ожидает возникновения какого-либо из этих событий. Отображаемые выходные данные происходят, если пользователь изменяет разрешение экрана.
Пример 2
Службы не имеют циклов сообщений, если только им не разрешено взаимодействовать с рабочим столом. Если цикл обработки сообщений не предоставлен скрытой формой, как в этом примере, служба должна запускаться под локальной системной учетной записью, а для включения взаимодействия с рабочим столом требуется вмешательство вручную. То есть администратор должен вручную установить флажок Разрешить взаимодействие со службой «Рабочий стол » на вкладке » Вход » диалогового окна «Свойства службы». В этом случае цикл обработки сообщений предоставляется автоматически. Этот параметр доступен, только если служба запущена под локальной системной учетной записью. Взаимодействие с рабочим столом не может быть включено программным способом.
Чтобы запустить пример, выполните следующие действия.
Скомпилируйте код из командной строки. Имя, используемое для исходного файла, не имеет значения.
Используйте консоль служб для запуска службы.
Измените системное время или измените параметры пользователя, например свойства мыши.
Просмотрите сообщения в категории » приложение » Просмотр событий.
Используйте консоль служб для завершения работы службы.
Комментарии
SystemEventsКласс предоставляет возможность реагирования на определенные типы системных событий.
При возникновении системного события все делегаты, прикрепленные к событию, вызываются с помощью потока, отслеживающего системные события. Таким образом, следует делать любые вызовы из обработчиков событий, которые являются потокобезопасными. Если необходимо вызвать системное событие, которое не представлено в качестве члена этого класса, можно использовать InvokeOnEventsThread метод.
Не следует выполнять длительную обработку потока, вызывающего обработчик системных событий, поскольку это может препятствовать функционированию других приложений.
некоторые системные события могут не возникать в Windows Vista. убедитесь, что приложение работает правильно в Windows Vista.
Методы
Создает новый таймер окна, связанный с окном системных событий.
Определяет, равен ли указанный объект текущему объекту.
Служит хэш-функцией по умолчанию.
Возвращает объект Type для текущего экземпляра.
Вызывает заданный делегат, используя поток, прослушивающий системные события.
Завершает работу таймера, заданного идентификатором.
Создает неполную копию текущего объекта Object.
Возвращает строку, представляющую текущий объект.
События
Происходит, когда пользователь изменяет параметры дисплея.
Происходит при изменении параметров дисплея.
Происходит перед завершением потока, прослушивающего системные события.
Происходит, когда пользователь добавляет шрифты в систему или удаляет шрифты из системы.
Происходит при недостатке оперативной памяти в системе.
Происходит, когда пользователь переходит к приложению, которое использует другую палитру.
Происходит, когда пользователь приостанавливает или возобновляет работу системы.
Происходит, когда пользователь выходит из системы или завершает ее работу.
Происходит, когда пользователь пытается выйти из системы или завершить ее работу.
Происходит после смены текущего вошедшего в систему пользователя.
Происходит, когда пользователь изменяет время системных часов.
Происходит, когда заканчивается интервал таймера Windows.
Происходит после изменения пользовательских параметров.
Происходит при изменении пользовательских параметров.
System Events controls Folder Actions (which are AppleScripts you can attach to folders so that they’ll run whenever the folder is opened or an item is added/removed from it, etc.).
It can also be used by AppleScript developers to do some very basic and useful things like managing files, getting information on running applications, and controlling interface elements by simulating keyboard/mouse actions. It’s a scripter’s best friend.
Mac Convert for Life
System Events controls Folder Actions (which are AppleScripts you can attach to folders so that they’ll run whenever the folder is opened or an item is added/removed from it, etc.).
It can also be used by AppleScript developers to do some very basic and useful things like managing files, getting information on running applications, and controlling interface elements by simulating keyboard/mouse actions. It’s a scripter’s best friend.
Thanks, Mikuro, for your reply. But now I have a couple more questions:
1. How did it get there (in my start-up items) if I didn’t put it there? I’m the only one who uses my iBook.
2. Should I delete it or uncheck it from launching/running upon startup or just leave it as is?
I never saw this before and now, suddenly, it’s there. It’s unsettling.
В Windows есть возможность переключаться между кнопками с помощью Tab, на самом деле, в Mac OS X это также возможно, нужно лишь отметить соответствующую опцию в системных настройках. В разделе Клавиатура > «Сочетание клавиш» в самом низу окна настроек нужно пометить опцию “All Controls” (все элементы управления). Чтобы привести в действие изменения, необходимо нажать Control + F7.
Отключение циклического переключения Spaces
Если нажать Control + клавишу-стрелку, индикатор Spaces будет перемещаться до самого конца к правому, левому, верхнему или нижнему краю спейса, если продолжать нажимать клавиши, он переместится в следующий спейс. Чтобы отключить циклические переключения при нажатии Control + клавиши-стрелки, можно воспользоваться следующей командой терминала:
Для восстановления прежних настроек, необходимо повторить команду, изменив » NO» на » YES«
Изменяем паузу для Spaces
При перетаскивании приложений из одного Spaces в другой, возникает небольшая пауза перед переключением. Продолжительность этой паузы можно изменить с помощью следующей команды терминала:
Значение по-умолчанию составляет 0.75
Тайные знаки в меню «Window» Finder
Когда индикатор слева от названия окна отсутствует, как на скриншоте у «Scratch Disk», это означает, что окно открыто, но в настоящий момент не активно. Когда слева присутствует галочка, как на скриншоте у «Macintosh HD», это означает, что окно в настоящий момент активно. Ромбик слева от названия означает, что окно минимизировано.
Перетаскиваем приложение в другой Spaces
Перетащить приложение в другой Spaces действительно просто. Выводим приложение, которое нужно переместить, на передний план, активируем Spaces, а затем перетаскиваем приложение в тот спейс, который нужен.
Если вы хотите перенести все окна приложения из одного спейса в другой, тогда активируем Spaces, нажимаем command и перетаскиваем приложение в нужный спейс.
Если вы хотите объединить все окна всех приложений в один спейс, тогда надо активировать Spaces и нажать клавишу » c«.
Отключаем переключение Spaces по Command + Tab
Если у вас окно Finder находится в спейсе 1 и Firefox в спейсе 2, нажатие alt + tab приведет к автоматическому переключению на другой спейс. Если вы хотите отключить это, нужно убрать соответствующую галочку в панели настроек Spaces или применить следующую команду терминала:
Для восстановления изначальных настроек, пометьте нужную опцию в панели настроек Spaces или повторно примените команду, изменив » NO» на » YES«.
Дополнительная информация в окне входа
Начиная с версии Mac OS X 10.4.3, окно входа в систему стало более информативным. Кликнув на имени компьютера (под логотипом Mac OS X), вы увидите больше информации, например, точную версию операционной системы. Каждый клик меняет отображаемую информацию по циклу. Вот полный список отображаемых данных в порядке следования:
То есть, кликнув шесть раз на имени компьютера, вы увидите всю статистику, и седьмой клик вернет назад отображение имени. Но с новым входом, вы снова увидите имя компьютера. Если надо в окне входа отображать другую информацию по умолчанию, запустите следующую информацию в терминале:
В зависимости от того, что надо показать, замените info_name выше на одно из следующих:
После запуска этой команды, следующий вход будет показывать новую информацию.
Как добавить пробел в Dock
После этого, перегрузите Dock: либо завершите сеанс и войдите снова, либо запустите другую команду в Terminal.
Каждый раз, когда вы запускаете команду, в Dock добавляется разделитель, который вы можете перетащить в нужную позицию.
Команда выше добавляет разделитель в левую часть Dock (программы). Для того, чтобы добавить разделитель в правую часть (документы), запустите следующую команду:
После этого тоже надо перегрузить Dock.
Чтобы убрать разделитель, просто вытащите его из Dock, как и любую другую иконку, или щелкните правой кнопкой на разделителе и выберите Удалить из Dock.
Использование AppleScript для смены фона рабочего стола
Вы можете настроить Mac OS X так, чтобы фон рабочего стола менялся в случайном порядке с определенным интервалом. Но иногда случается так, что появляется картинка, которая уже была в этот день, и вы можете захотеть изменить ее. Это легко сделать при помощи AppleScript.
Откройте Программы > AppleScript > Редактор скриптов и вставьте скрипт, приведенный ниже:
property theSwitch : 0
if theSwitch = 0 then
tell application «System Events»
tell current desktop
set change interval to 1801.0
set theSwitch to 1
tell application «System Events»
tell current desktop
set change interval to 1800.0
set theSwitch to 0
Сохраните его как скрипт, или как программу (что даже удобнее). При запуске этот скрипт заставит систему изменить картинку немедленно.
Для удобства, сохраните скрипт как программу, и поставьте ее в легкодоступном месте, например на рабочем столе или в Dock.
Использование трекпада Multi-Touch в новом MacBook Pro
В новом MacBook Pro функциональность трекпада заметно расширилась. В отличие от обычных трекпадов сам трекпад MacBook Pro является кнопкой, и в любом его месте можно выполнять щелчки. Для включения жестов и настройки других параметров трекпада выберите Системные настройки > Трекпад.
Прокручивание двумя пальцами позволяет выполнять быструю прокрутку, прокрутку вверх, вниз или в стороны активного окна. Эта функция включена по умолчанию. Дополнительный щелчок или «щелчок правой кнопкой» обеспечивает доступ к пунктам контекстного меню. Для настройки области дополнительного щелчка одним пальцем в левой или правом нижнем углу трекпада выберите «Двойной щелчок» в пункте «Один палец» настроек.
Для настройки дополнительного щелчка двумя пальцами в любой области трекпада выберите «Двойной щелчок» в пункте «Два пальца» настроек. Также можно осуществлять это действие, удерживая Control во время нажатия.
Ваш Mac хранит системные журналы, которые могут помочь диагностировать и устранять проблемы с macOS и вашими установленными приложениями. Эти журналы хранятся в виде текстовых файлов журнала на системном диске вашего Mac, и macOS также включает в себя приложение для их просмотра.
Просмотр системных журналов в консольном приложении
Чтобы просмотреть системные журналы Mac, запустите консольное приложение. Вы можете запустить его с помощью Spotlight, нажав Ctrl + Space, набрав «Console», а затем нажав Enter. Вы также найдете его в Finder> Приложения> Утилиты> Консоль.
Консольное приложение, также известное как Console.app, похоже на Windows Event Viewer для Mac.
По умолчанию вы увидите список консольных сообщений с вашего текущего Mac. Вы можете нажать «Ошибки и неисправности» на панели инструментов, чтобы увидеть только сообщения об ошибках, если хотите. Вы также можете использовать окно поиска для поиска типа сообщения об ошибке, которое вы хотите увидеть.
Если вам нужна дополнительная информация о причине сбоя приложения в вашей системе, вы можете найти его здесь. Разработчику приложения может понадобиться эта информация для исправления сбоя, который также происходит на вашем Mac.
Чтобы просмотреть файл системного журнала, нажмите «system.log». Чтобы просмотреть другие журналы, относящиеся к конкретному приложению, просмотрите другие папки здесь. «
Чтобы просмотреть журналы другой учетной записи пользователя Mac, расположенные в разделах «Отчеты пользователя» или «
/ Библиотека / Журналы», вам необходимо войти в систему под этим пользователем, а затем открыть консольное приложение.
Вы можете скопировать данные из ваших системных журналов в текстовый файл, если вам нужно экспортировать их, чтобы поделиться ими с кем-то еще в целях устранения неполадок. Сначала нажмите «Правка»> «Выбрать все», чтобы выбрать все сообщения на текущем экране. Затем нажмите «Правка»> «Копировать», чтобы скопировать их в буфер обмена.
Затем откройте приложение TextEdit, например, нажав Ctrl + Space, набрав «TextEdit» и нажав «Enter». Создайте новый документ и затем выберите «Правка»> «Вставить», чтобы вставить сообщения в текстовый файл. Нажмите Файл> Сохранить, чтобы сохранить ваш текстовый файл впоследствии.
Найти файлы журналов на диске
Эти журналы представляют собой текстовые файлы, которые вы также можете найти на локальном диске вашего Mac. Это означает, что вы можете просматривать их в Finder или через терминал, открывать их в других приложениях, использовать с ними инструменты командной строки и создавать резервные копии файлов.
Чтобы найти эти файлы журналов, посмотрите в следующих местах:
