• Заходим в расширенные настройки keyonekb2, пролистываем вниз, видим там наше приложение и после ResourceId: код поискового поля.

Либо после ResourceId вместо кода поискового поля мы видим текст на два абзаца, но при этом поисковый плагин в новом приложении все-таки работает. Пугаться не стоит. Это чуть более сложный случай, про него будет дальше.

1. В любом из обоих случаев жмем SAVE PLUGIN DATA

2. Идем в папку /storage/emulated/0/Android/data/com.sateda.keyonekb2/files/default

3. Берем файл plugin_data.json и кладем его в /storage/emulated/0/Android/data/com.sateda.keyonekb2/files

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

1. Добавлять свои "поисковые" слова в список универсальных поисковых слов

"default-search-words" : [ "Найти", "Поиск", "Search", "Искать" ]

1. Делать паузу (Xms) после нажатия на Поиск, но перед вводом символа (для случаев, когда поиск "выезжает" или просто "тупит");

2. Делать клик не на сам элемент с текстом Поиск, а на его "родителя" (для случаев, когда на сам элемент тычок не работает);

   "package-name" : "ru.yandex.yandexmaps",
   "custom-click-adapter-click-parent" : true,
   "search-field-id" : "ru.yandex.yandexmaps:id/search_line_search_text",
   "wait-before-send-char-ms" : 300

3. Для т.н. динамических кнопок Поиск (которые не отдают свое имя для сохранения) оставлять только один поисковый метод, чтобы каждый раз не пробовать все 10 универсальных метода (как сделано для Telegram например);

   "package-name" : "org.telegram.messenger",
    "additional-event-type-type-window-content-changed" : true,
    "dynamic-search-method" : [ {
      "dynamic-search-method-function" : "FindAccessibilityNodeInfosByText",
      "contains-string" : "Search" } ]

4. Убирать лишние типы евентов, если приложение подтормаживает;

5. Максимальные настройки показаны для приложения org.example.dummy (полезно для копипаста)

   "package-name" : "org.example.dummy",
    "additional-event-type-type-window-content-changed" : true,
    "custom-click-adapter-click-parent" : true,
    "dynamic-search-method" : [ {
      "dynamic-search-method-function" : "FindFirstByTextRecursive",
      "contains-string" : "Найти"
    }, {
      "dynamic-search-method-function" : "FindAccessibilityNodeInfosByText",
      "contains-string" : "Поиск"
    } ],
    "wait-before-send-char-ms" : 200

1. Зайти в пункт меню "РАСШИРЕННЫЕ НАСТРОЙКИ"

2. Нажать "SAVE KEYBOARD DATA"

3. Данные о раскладках сохранятся в папке /storage/emulated/0/Android/data/com.sateda.keyonekb2/files/default

(!) Если повторно нажать на кнопку "SAVE KEYBOARD DATA" то файлы в папке /default перезапишутся

1. В папке появятся файлы *.json

   • Сами раскладки для букв в файлах типа russian_hw.json или pocket_english.json

   • Символьные раскладки в файлах типа alt_hw.json или pocket_alt_hw.json

Содержимое файлов описывать не имеет смысла там все понятно.

1. Изменить файл с буквенной или символьной раскладкой

2. Записать его в папку /storage/emulated/0/Android/data/com.sateda.keyonekb2/files

   • Базово все раскладки зашиты в ресурсы приложения

   • Но, если клава при включении видит файл с таким же названием в "своей" папке на диске она предпочтительно берет его

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

1. Hint Если вы хотите кастомный символ из символьной раскладки, который будет специфичен для раскладки. То из символьной раскладки можно добавить поля в буквенную и они подхватятся и будут браться по умолчанию. Например, в русской раскладке на доллар повесить знак рубля.

  "key-code" : 11,
  "single-press-alt-shift-mode" : "€",
  "single-press-alt-mode" : "$",
  "alt-more-variants" : "₽₴₩£₪¥$€",
  "alt-shift-more-variants" : "₽₴₩£₪¥$€"

• Это нужно чтобы запустить метод в теле при каком-то условии (условиях)

• Если в массиве несколько методов, то чтобы выполнилось "тело" они оба должны сработать (вернуть true)

• Если нужно запустить несколько функций в теле, то запиcь meta-mode-method-names дублируется для каждой функции тела

• Важно! Последний метод тела должен быть останавливающим дальнейшее выполнение ("stop-processing-at-success-result": true)

• Иначе следом будут выполняться все методы из безусловного блока (без meta условий)

• Флаг используется для остановки дальнейшего выполнения методов тела

• Если флаг он не установлен то он по умолчанию false

• Это фейк-мета метод, всегда возвращающий true

• Он нужен, чтобы вызвать какое-то действие перед условными обработчиками мета состояний (т.е. и для случаев без мета состояний)

      "key-codes": [
        "KEYCODE_0"
      ],

      "key-codes": [
        "287"
      ],

1. Как мета-кнопка (с возможностью зажатие+другая кнопка). События: on-short-press, on-double-press, on-hold-xxx

2. Как обычная кнопка буквы-цифры (с возможностью долгого нажатия). События: on-short-press, on-double-press, on-long-press

• Могут применяться условные конструкции (meta-mode-method-names)

• Все условные конструкции вызываются по порядку

• Тело (функция) каждого сработавшего условного-мета-метода (вернувшего true) выполняется

  • Когда встретится стоп-флаг (stop-processing-at-success-result) обработка события останавливается

• Если не было стоп-флага или не было ни одного сработавшего условного-мета-метода

• То выполняется т.н. безусловный блок

• Действия, выполняющиеся, когда клавиатура попадает в поле ввода

• Могут применяться условные конструкции (meta-mode-method-names)

• Действия, выполняющиеся, когда клавиатура выходит из поля ввода

• Могут применяться условные конструкции (meta-mode-method-names)

• Действия, выполняющиеся перед отправкой символа в поле ввода

• Могут применяться условные конструкции (meta-mode-method-names)

• Действия, выполняющиеся после отправки символа в поле ввода

• Могут применяться условные конструкции (meta-mode-method-names)

• KEYCODE-ы, которые отправляются в клавиатуру даже если мы не находится в поле ввода

• Все остальные keycode-ы в режиме чтения игнорируются клавиатурой (соответствующие события отправляются в хост-приложение как есть)