Как проверить клавиатуру и раскладку удалённого Mac

После удалённого подключения к облачному Mac чаще всего недооценивают не обрыв сети, а ситуацию, когда клавиатура «в целом работает», но ввод остаётся некорректным: Command и Option поменяны местами, символы цифрового ряда не соответствуют раскладке, клавиши выбора китайских иероглифов перехватываются клиентом или автоматизированный скрипт вводит не те символы, что пользователь вручную. Если обнаружить такие проблемы уже после настройки инструментов, будет трудно определить их источник: локальная система, клиент удалённого доступа или источник ввода macOS. Надёжнее проверить ввод до инициализации рабочего окружения.

Сначала зафиксируйте трёхуровневую цепочку ввода

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

На локальном устройстве проверьте тип физической клавиатуры, текущую раскладку и наличие в клиенте удалённого доступа таких параметров, как «передавать системные сочетания клавиш» или «поменять местами Command и Option». На облачном Mac запишите версию системы, список включённых источников ввода и пользовательское переназначение клавиш:

sw_vers
defaults read com.apple.HIToolbox AppleEnabledInputSources
defaults read com.apple.HIToolbox AppleCurrentKeyboardLayoutInputSourceID
hidutil property --get "UserKeyMapping"

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

За преобразование клавиш-модификаторов должен отвечать только один уровень. Если клиент уже меняет клавиши местами, не создавайте такое же сопоставление на стороне хоста.

Найдите смещение раскладки с помощью матрицы символов

Не ограничивайтесь вводом нескольких букв в редакторе. Проверяйте символы в заданной последовательности в окне с обычным текстом, чтобы сочетания клавиш редактора, автодополнение и автозамена не влияли на результат.

При проверке символов ориентируйтесь на принятую в команде логическую раскладку, например американскую ANSI, а не на надписи на клавиатуре каждого участника. Если удалённая машина используется для автоматизированных задач, единая логическая раскладка надёжнее, чем воспроизведение локальных привычек каждого разработчика.

Исключите влияние автозамены текста

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

Проверяйте модификаторы и сочетания клавиш отдельно

Ошибки клавиш-модификаторов часто проявляются только в отдельных комбинациях: работающий Command+C не гарантирует корректную обработку Option+цифра, Control+буква или сочетаний Command+Shift. Рекомендуется подготовить минимальный набор сочетаний, охватывающий копирование, переключение окон, перемещение по словам, комбинации с изменением регистра и клавиши, зарезервированные клиентом.

Если подтверждено, что на стороне хоста осталось ошибочное сопоставление, его можно очистить в текущем сеансе входа:

hidutil property --set '{"UserKeyMapping":[]}'

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

Определите, перехватывает ли сочетание клиент

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

Проверьте методы ввода и границы автоматизации

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

Автоматизированные задачи не должны зависеть от «текущего метода ввода». Когда скрипт создаёт файлы конфигурации, номера версий или тестовые данные, он должен записывать их непосредственно в файл UTF-8 либо передавать значения через параметры команды. Тесты, управляющие графическим интерфейсом, также должны перед запуском переключаться на согласованный источник ввода и записывать его текущий идентификатор в журнал. Это позволяет отделить сбои бизнес-тестов от изменений среды ввода.

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

Повторите проверку после переподключения и сформируйте базовую конфигурацию

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

Итоговая базовая конфигурация может быть очень краткой:

1. Согласовать одну логическую раскладку клавиатуры.
2. Менять местами клавиши-модификаторы только на одном уровне: в клиенте или на хосте.
3. Сохранить вывод AppleEnabledInputSources и UserKeyMapping.
4. Полностью выполнить матрицу символов и проверить пять групп сочетаний клавиш.
5. По одному разу проверить метод ввода в терминале и графическом приложении.
6. После отключения и повторного подключения снова проверить ключевые пункты.

Принцип устранения проблем ввода состоит не в том, чтобы «настроить всё так, чтобы сработало сейчас», а в том, чтобы определить единственный уровень, отвечающий за преобразование, и обеспечить такой же результат при следующем подключении. Только после формирования этой базовой конфигурации следует устанавливать зависимости для разработки или подключать автоматизированные задачи — тогда последующие сбои будет значительно проще связать с конкретной причиной.

Часто задаваемые вопросы