Разработка кастомной клавиатуры (Custom Keyboard) для Android
Input Method Editor (IME) на Android — это сервис, зарегистрированный в системе через InputMethodService. В отличие от iOS, Android даёт разработчику значительно больше свободы: IME может занимать произвольную высоту, содержать WebView, работать в фоне через bound service. Эта свобода оборачивается своим набором граблей.
Жизненный цикл InputMethodService
Клавиатура существует как системный сервис. Ключевые callbacks:
-
onCreateInputView()— создание вью клавиатуры, вызывается один раз -
onStartInputView(EditorInfo, Boolean)— каждый раз при появлении клавиатуры; здесь читаемEditorInfo.inputType, чтобы понять, что за поле — пароль, email, числа, произвольный текст -
onFinishInputView(Boolean)— поле потеряло фокус -
onComputeInsets(Insets)— критически важен для управления отступами
EditorInfo.inputType — битовая маска. Поле пароля: inputType & InputType.TYPE_MASK_VARIATION == InputType.TYPE_TEXT_VARIATION_PASSWORD. Если не обработать этот случай явно, автокоррекция и предсказания слов будут предлагаться в полях паролей — и это гарантированный отказ в Play Store.
Проблема с высотой и insets
Самая частая жалоба: клавиатура перекрывает EditText. Причина — неправильная реализация onComputeInsets. По умолчанию система не знает, какую часть экрана занимает IME, и не сдвигает контент.
@Override
public void onComputeInsets(InputMethodService.Insets outInsets) {
super.onComputeInsets(outInsets);
outInsets.contentTopInsets = outInsets.visibleTopInsets;
}
Но это работает только если host-приложение использует adjustResize или adjustPan в windowSoftInputMode. Если там стоит adjustNothing — ничего не поможет, это ответственность host-приложения. Нужно это документировать.
Передача текста в поле
Ввод символа: getCurrentInputConnection().commitText("a", 1). Удаление: getCurrentInputConnection().deleteSurroundingText(1, 0). Фиксация composing text (для IME с промежуточным состоянием, как японские/китайские): setComposingText() + finishComposingText().
InputConnection может быть null — это происходит при потере фокуса между вызовами. Каждый вызов нужно проверять:
val ic = currentInputConnection ?: return
ic.commitText(text, 1)
Хранение данных и разрешения
IME в Android — привилегированный компонент, но разрешения работают стандартно. Для доступа в интернет нужен INTERNET в манифесте. Словарь и настройки — SharedPreferences или Room. Предиктивный ввод с серверной стороны — только через явное согласие пользователя плюс описание в Privacy Policy.
Play Store проверяет IME с удвоенным вниманием: скрытая передача нажатий клавиш — прямое нарушение политики. Если клавиатура отправляет что-то на сервер (аналитику раскладки, предиктивный ввод), это нужно декларировать через Data Safety Form.
Тема и Material Design
Начиная с Android 12, клавиатура должна поддерживать Dynamic Color из Material You, если хочет выглядеть органично. MaterialTheme через AppCompatDelegate + DynamicColors.applyToActivitiesIfAvailable() не работает в IME напрямую — нужно применять тему к inputView явно через ContextThemeWrapper.
Jetpack Compose внутри IME работает начиная с Compose 1.2, но требует аккуратной настройки: ComposeView внутри onCreateInputView() с явным setViewCompositionStrategy(ViewCompositionStrategy.DisposeOnDetachedFromWindow).
Тестирование
Проверяем на реальных устройствах с разными версиями: Android 8 (API 26) — минимум, если не используем новые IME API. Тестируем в Chrome для Android (отдельный InputConnection), в Gmail, в полях с inputType=numberPassword. В эмуляторе можно запускать, но поведение insets отличается.
Срок разработки: 1-3 недели. Зависит от наличия предиктивного ввода, поддержки нескольких языков и кастомной темизации. Стоимость рассчитывается индивидуально.