Разработка Android Kiosk приложения

This article, written by Android developer Davran, provides a technical overview of developing a Kiosk application for Android. It explains that a Kiosk app locks a user into a single application, commonly used in terminals and self-service devices, and details the implementation using the Device Policy Manager API and Lock Task Mode. The author describes the process of setting a whitelist of allowed packages and configuring lock task features to disable the system UI, while noting the challenge of having to re-enable features individually when exiting Kiosk mode.

Всем привет это моя первая публикация. И первый опыт написания статей по разработке. Давайте начнем с небольшого знакомства. Меня зовут Давран, я андройд разработчик с 8 летнем стажем разработки мобильных приложений разного спектра. Мой опыт работы: Сегодня я хотел начать свое повествование с темы Android Kiosk. На первый взгляд kiosk приложение на Android - это что то простое: нужно просто "залочить" пользователя внутри одного экрана. На практике все оказалось немного сложнее. В рамках нашего проекта Pai, я занимался разработкой приложения под планшет, а так же написанием лаунчера как в итоге оказалось не совсем лаунчером Что такое киоск Kiosk-приложение - это приложение с ограниченным доступом в котором пользователь не может выйти за пределы одного приложения. Такие решения используется в терминалах, POS системах инфокиосках и устройствах самообслуживания. Требования На старте требования казались простыми, у меня был небольшой опыт написания лаунчера под android, и я думал что этих знаний и каких нибудь pet проектов на гитхабе хватит для решения задачи. Но у меня было много вопросов которые направили меня на поиск документации для этой области ссылка https://developer.android.com/work/dpc/dedicated-devices?hl=ru Итого нам нужно чтобы: - Пользователь не смог выйти из приложения - Приложение должно запускаться автоматически при включении устройства - Нельзя давать доступ к системным настройкам и UI Реализация Все что мне потребовалось это немного документации, пару снипетов кода. За основу решения были взяты Device Owner и Lock Task Mode. Ну что же, теперь перейдем непосредственно к коду и реализации... Kiosk Controller Первым делом нам предстоит ознакомиться с DevicePolicyManager API https://developer.android.com/reference/android/app/admin/DevicePolicyManager если в двух словах то это API для администратора устройства которое позволяет нам много вещей управление приложениями, управление настройками девайса и прочие вещи но для этого нам нужно одно из двух, либо нужные пермишины либо же админ права это не есть рут устройства Дальше нам предстоит ознакомиться с KeyguardManager API https://developer.android.com/reference/android/app/KeyguardManager это API нужно нам для работы с лок скрином девайса а точнее для прослушивание его стейтов. И так же нам нужно создать DeviceAdminReceiver https://developer.android.com/reference/android/app/admin/DeviceAdminReceiver для получения установленных настроек в наше приложение 1 - Нам нужно создать white list приложений которые можно будет запускать в режиме киоска поэтому мы создадим массив названия пакетов: private val WHITE LIST PACKAGES = arrayOf "your.package.name", "dev.firebase.appdistribution", "com.android.settings" 2 - Мы создаем класс KioskController и создаем ссылки на системные сервисы private val dpm = context.getSystemService DevicePolicyManager::class.java private val keyguard = context.getSystemService KeyguardManager::class.java private val admin = ComponentName context, AdminReceiver::class.java 3 - Основную работу будет делать нам DevicePolicyManager и первая магическая строчка это dpm.setLockTaskPackages admin, arrayOf WHITE LIST PACKAGES данная команда отдает системе белый список приложений которые можно будет открыть в режиме киоска вторая магичечская строчка dpm.setLockTaskFeatures admin, DevicePolicyManager.LOCK TASK FEATURE NONE данная команда отключает все настраиваемые элементы с UI в режиме киоска статус бар,навигационный бар, одним словом у вас в киоск режиме отключается весь внешний UI системы из минусов я нашел только вновь кривой API, так как флаг DevicePolicyManager.LOCK TASK FEATURE NONE выключает все но нет флажка включить все, поэтому придется использовать комбинацию флажков чтобы вернуться с режима киоска dpm.setLockTaskFeatures admin, DevicePolicyManager.LOCK TASK FEATURE HOME or DevicePolicyManager.LOCK TASK FEATURE OVERVIEW or DevicePolicyManager.LOCK TASK FEATURE NOTIFICATIONS or DevicePolicyManager.LOCK TASK FEATURE GLOBAL ACTIONS и на выходе у нас получаются две функции fun enterAdminMode { if isDeviceOwner return dpm.setLockTaskFeatures admin, DevicePolicyManager.LOCK TASK FEATURE HOME or DevicePolicyManager.LOCK TASK FEATURE OVERVIEW or DevicePolicyManager.LOCK TASK FEATURE NOTIFICATIONS or DevicePolicyManager.LOCK TASK FEATURE GLOBAL ACTIONS } fun exitAdminMode { if isDeviceOwner return dpm.setLockTaskFeatures admin, DevicePolicyManager.LOCK TASK FEATURE NONE } есть еще вспомогательные fun canStartLockTask : Boolean { if isDeviceOwner return false if dpm.isLockTaskPermitted context.packageName return false return keyguard.isDeviceLocked } isLockTaskPermitted - это проверка на на наличие прав у приложение переходить в режим киоска. fun isDeviceOwner : Boolean = dpm.isDeviceOwnerApp context.packageName Проверка на наличие прав админа устройства Так же у DevicePolicyManager есть функция addRestriction которая позволяет выключить ту или иную вещь на девайсе: - Сейф бут - сброс заводских настроек - подключение внешних юсб - добавление аккаунтов на устройство - настройки блютуза и еще много чего. переменная admin - это DeviceAdminReceiver https://developer.android.com/reference/android/app/admin/DeviceAdminReceiver который помогает системе определить куда вести все эти настройки в действие. Установка приложения На этом создание контролера завершено, далее нам нужно сбросить девайс до заводских настроек, включить USB debugging, разрешить установку через USB и не создавать и не авторизовываться ни под каким аккаунтом на устройстве. Мы ставим наше приложение на устройство, открываем терминал и выполняем команду Установка девайс овнера adb shell dpm set-device-owner "your.package.name/com.example.AdminReceiver Удаление девайс овнера adb shell dpm remove-active-admin "your.package.name/com.example.AdminReceiver и указываем путь до нашего AdminReceiver это DeviceAdminReceiver который мы создали в KioskController class AdminReceiver : DeviceAdminReceiver На этом нам осталось лишь установить наше приложение как домашний лаунчер устройства и поздравляю вас, вы теперь админ устройства в режиме киоска. P.S - я использовал SingleActivity архитектуру для того чтобы добавить скрытую кнопку которая позволит открыть AdminScreen ввести пин код админа и выйти с режима киоска для конфигурации планшета. Если хотите могу эту часть тоже описать.