Правило архитектуры
Используйте Wedge для контролируемых рабочих процессов ввода форм, где поведение фокуса приемлемо. Используйте намерения, когда доступна структурированная доставка сканирования и конфигурация сканера может оставаться внешней. Используйте SDK, когда приложение должно владеть сеансами триггера, символами, режимом вывода или подробным состоянием сканера. Проверьте точное устройство и прошивку.
Разрыв клавиатуры: низкий код, скрытое состояние
В режиме Wedge символы вводятся в выделенный элемент управления и могут работать с веб-приложениями или устаревшими приложениями. Он переносим на уровне ввода, но зависит от фокуса, раскладки клавиатуры, IME, префикса, суффикса и времени.
Запретите сканам вводить поля поиска, заметок или аутентификации. Определите, добавляется ли Enter или Tab, и проверьте длинные коды, быстрое сканирование и ввод вручную.
- Явное состояние поля, готового к сканированию
- Префикс и суффикс задокументированы.
- Исправлен IME и раскладка клавиатуры.
- Защита от дублирования
Намерение трансляции: структурированная доставка с правилами жизненного цикла Android.
Вывод намерения отделяет данные сканирования от текстового фокуса. Получатель может проверить действие и дополнительные возможности, проверить продолжительность и направить событие в активный рабочий процесс.
Названия действий, дополнительные возможности и требования к приемнику различаются в зависимости от поставщика и версии SDK. Зарегистрируйтесь и отмените регистрацию с соответствующим жизненным циклом, ограничьте воздействие, где это возможно, и отклоните непредвиденные полезные нагрузки.
- Точное действие и дополнительные клавиши
- Экспорт приемника и проверка разрешений
- Поведение на переднем и заднем плане
- Необработанные байты и декодированная строка
Поставщик SDK: явный контроль и явная связь.
SDK может открывать и закрывать сканер, выбирать режим вывода, настраивать символы и запускать или останавливать сеансы декодирования. Это подходит, когда поведение сканирования является частью конечного автомата приложения.
Оберните вызовы поставщика интерфейсом приложения, запишите возвращаемые значения и сделайте очистку идемпотентной. Сохраните матрицу совместимости устройств, поскольку доступность API не гарантирует идентичное поведение ядра или прошивки.
- Адаптер вокруг поставщика API
- Открытие, запуск, остановка и закрытие владения
- Повторное чтение конфигурации, если доступно
- Видны состояния сбоя и тайм-аута
Проверка целостности и жизненного цикла данных
Проверьте холодный запуск, возобновление, блокировку экрана, переключение приложений, поворот, если поддерживается, перезагрузку, режим киоска MDM и быстрые повторяющиеся триггеры. Убедитесь, что каждое физическое сканирование создает одно запланированное бизнес-событие.
Используйте известные последовательности байтов для символов, отличных от ASCII, и управляющих символов. Решите, будет ли приложение хранить необработанные байты, декодированный текст, символы и метку времени. Избегайте регистрации конфиденциальных отсканированных значений.
- Одно сканирование равно одной транзакции
- Ни одно сканирование не приводит к неправильному экрану
- Кодировка и длина проверены
- Восстановление не требует перезагрузки устройства
Клин против намерения против SDK
Выберите минимальный уровень интеграции, который по-прежнему обеспечивает необходимый контроль.
| Критерий | Разрыв клавиатуры | Намерение трансляции | Продавец SDK |
|---|---|---|---|
| Усилия по реализации | Низкий | Средний | От среднего до высокого |
| Зависимость фокуса | Высокий | Низкий | Низкий |
| Управление сканером | Преимущественно внешняя конфигурация | Внешний или ограниченный | Принадлежит приложению |
| Структура данных | Символы и суффикс | Именованные дополнения | API событие или трансляция |
| Портативность | Переносимость на входном уровне | Картирование действий продавца | Требуется адаптер поставщика API |
Контрольный список проверки интеграции
Записывайте результаты по устройству, ОС, прошивке, SDK и сборке приложения.
- 01
Активен только заданный режим вывода.
- 02
Поведение фокуса и суффикса протестировано для клина
- 03
Действие намерения и дополнительные возможности проверены
- 04
Рассмотрен жизненный цикл и воздействие приемника
- 05
SDK обработаны возвращаемые значения открытия и закрытия
- 06
Протестированы быстрые триггеры и дублирующиеся события.
- 07
Проверены режим сна, возобновление работы, перезагрузка и переключение приложений.
- 08
Кодирование и длинные полезные данные проверены.
- 09
Ограниченные данные исключены из журналов
- 10
Откат и сброс конфигурации задокументированы.
Часто задаваемые вопросы
Достаточно ли надежен клавиатурный блок для производства?
Это может произойти, когда рабочий процесс жестко контролирует фокус, конфигурацию клавиатуры, суффикс и дублирующую отправку. Проверьте каждый экран, который может принимать входные данные.
Стандартизированы ли намерения сканера Android ?
Нет. Названия широковещательных действий, дополнительные возможности, конфигурация и разрешения могут различаться в зависимости от производителя устройства и версии SDK.
Должно ли приложение всегда использовать поставщика SDK?
Нет. Используйте его, когда приложению требуется управление сканером или состояние, которое не могут обеспечить Wedge и настроенные намерения. SDK добавляет работу по жизненному циклу и совместимости.
Доказательства и ограничения
Руководство по инженерной архитектуре / точное поведение требует проверки устройства
Принципы платформы Android сочетаются с доказательствами UROVO SDK ; эквивалентность API между поставщиками не заявлена.
Рассмотрено: 2026-08-10
- Android Документация разработчика: входные события и приемники широковещательных сообщений
- RuggedLayer одобрил UROVO Android SDK v4. 1.0326 ссылку на API
