Технический обзор для Zebra DataWedge на Elo Android I-Series 5. Совместимость, поддержка функций и конфигурация (Этап 1)
Быстрые ссылки
Версии
| Компонент | Версия |
|---|---|
| Компонент | Версия |
| DataWedge | 20.0.36.139 |
| Сканер Framework | 43.63.56.0 |
| Минимальная Elo OS | Elo Android 14 MR-9, 7.000.009.0046+gen5p |
1. Обзор
Начиная с релиза операционной системы Android 14 MR-9, устройства Elo I-Series 5 поставляются с Zebra DataWedge, той же службой захвата данных без кода, которая используется на устройствах Zebra с Android для бизнеса.
DataWedge захватывает данные с подключенного сканера штрих-кодов или камеры и передает их тому приложению, которое находится на переднем плане - либо в виде нажатий клавиш, как будто они напечатаны на клавиатуре, либо как Android намерение, которое приложение получает программно. Приложения не нуждаются в включении специфичного к сканеру кода или специфичного SDK Elo для получения данных сканирования.
Это первая интеграция программной платформы, предоставленная совместно Elo и Zebra. DataWedge разработан Zebra и интегрирован Elo в образ операционной системы Elo Android, поэтому он доступен сразу после обновления MR-9 - отдельная загрузка или установка не требуется.
Почему это важно
- Повторное использование существующей логики приложения. Приложения, уже написанные с использованием профилей и намерений DataWedge на устройствах Zebra, разработаны так, чтобы работать на Elo I-Series 5 без переписывания их интеграции сканирования.
- Не требуется SDK для сканера. Данные сканирования поступают в виде нажатий клавиш или намерений, поэтому новые приложения могут поддерживать сканирование без интеграции специфичного для устройства SDK.
- Поведение для каждого приложения, автоматически. Профили связаны с приложениями; DataWedge переключает профили по мере того, как приложения выходят на передний план, без действий со стороны пользователя.
- Повторяемая настройка флота. Конфигурация, созданная на одном устройстве, может быть экспортирована и импортирована на других.
2. Совместимость оборудования и платформы
Поддерживаемые устройства и ОС
| Устройство | Чипсет | ОС |
|---|---|---|
| Elo I-Series 5 10", 15" и 22" | Qualcomm QCS6490 | Android 14 |
Минимальная ОС: Elo Android 14 MR-9, версия 7.000.009.0046+gen5p или позже.
Доступность: обновление OTA на портале EloView 28 октября 2026 года; стандартное OTA на EloView и OEMConfig с 4 ноября 2026 года.
Поддерживаемые источники ввода
| Источник ввода | Подключение | Примечания |
|---|---|---|
| Сканеры штрих-кодов Elo Edge Connect | USB | Сканеры с движком Zebra управляются нативно DataWedge. |
| Встроенная передняя камера | Встроенная | Указана в DataWedge как Передняя камера. Выберите ее в меню выбора сканера штрих-кодов Добавить новый сканер. Доступна на I-Series 5 10", 15" и 22". |
Справка Zebra TechDocs:
Ввод штрих-кодов: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
3. Функции
Этап 1 предлагает основной набор функций DataWedge для захвата штрих-кодов, управления профилями, доставки данных и конфигурации. Описания функций следуют документации Zebra DataWedge; смотрите Zebra TechDocs (https://techdocs.zebra.com/datawedge/latest/guide/about/) для полного справочника параметров.
3.1 Захват данных
| Функция | Описание |
|---|---|
| Ввод штрих-кодов | Получение данных штрих-кода с подключенных USB-сканеров или камеры. |
| Сканирование камерой | Сканирование штрих-кодов с помощью камеры через видоискатель DataWedge. |
| Плагин ввода сканера | Управление аппаратным обеспечением сканера, параметрами декодера и параметрами считывателя. |
| Выбор сканера | По умолчанию автоматически. Чтобы использовать конкретный внешний сканер или переднюю камеру, откройте выбор сканера ввода штрих-кодов, откройте меню и выберите Добавить новый сканер; Использовать авто, чтобы вернуться к автоматическому выбору. |
| Конфигурация декодера (символика) | Включите или отключите отдельные символики и установите параметры декодера для каждого профиля. |
| Data Capture Plus (триггер сканирования на экране) | Назначает часть экрана как виртуальный триггер для сканирования: нажатие и удерживание запускает сканирование с использованием выбранного профиля сканера или камеры, как если бы это был аппаратный триггер. Показан как плавающая кнопка в приложениях, для которых включен этот профиль: по умолчанию он включен в новых профилях, и для приложений без профиля он появляется, как только включен Profile0 (Начало работы, Шаг 2). |
Справка Zebra TechDocs:
Ввод штрих-кодов: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
Data Capture Plus: https://techdocs.zebra.com/datawedge/latest/guide/input/dcp/
3.2 Доставка и форматирование данных
| Функция | Описание |
|---|---|
| Вывод нажатий клавиш | Передает данные сканирования как события клавиш в обрабатываемую область приложения на переднем плане, включая символы управляющих клавиш, задержку между символами и задержку события клавиши. |
| Вывод намерений | Передает данные сканирования в приложение как Android намерение (широковещательное сообщение, запуск активности или службы) с настраиваемым действием и категорией. Данные поступают в стандартные дополнительные параметры DataWedge, такие как com.symbol.datawedge.data_string и com.symbol.datawedge.label_type. |
| Основное форматирование данных (BDF) | Добавить префикс, суффикс или клавиши Enter/Tab к данным сканирования. |
| Расширенное форматирование данных (ADF) | Форматирование на основе правил, основанных на символике, длине или содержимом. |
| Парсинг GS1 / GS1 Digital Link | Парсинг и упорядочивание идентификаторов приложений GS1 в выводе. |
Справка Zebra TechDocs:
Вывод нажатий клавиш: https://techdocs.zebra.com/datawedge/latest/guide/output/keystroke/
Вывод намерений: https://techdocs.zebra.com/datawedge/latest/guide/output/intent/
BDF: https://techdocs.zebra.com/datawedge/latest/guide/process/bdf/
ADF: https://techdocs.zebra.com/datawedge/latest/guide/process/adf/
3.3 Управление профилями
| Функция | Описание |
|---|---|
| Несколько профилей | Создавайте и управляйте отдельными конфигурациями для разных приложений или случаев использования. |
| Профиль по умолчанию (Profile0) | Базовый профиль, применяемый к любому приложению без своего собственного профиля. |
| Ассоциация приложений и активности | Связать профиль с одним или несколькими приложениями (и активностями), чтобы он активировался, когда это приложение на переднем плане. |
| Автоматическое переключение профилей | DataWedge переключается на связанный профиль, когда приложение выходит на передний план. |
| Создание / редактирование / удаление профиля | Управление профилями в приложении для конфигурации DataWedge. |
| Отключить профиль | Отключить профиль без его удаления. |
| Клонировать профиль | Создать дубликат профиля (без связи с приложением). |
Справка Zebra TechDocs:
Профили DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
3.4 Настройки DataWedge и развертывание
| Функция | Описание |
|---|---|
| Включить / отключить DataWedge | Включить или отключить службу DataWedge. |
| Список отключенных приложений | Приостановить DataWedge для выбранных приложений или активностей, пока они находятся на переднем плане. |
| Экспорт / импорт профилей | Экспорт одного профиля в файл и импорт его на другое устройство. |
| Экспорт / импорт полной конфигурации | Экспорт полной конфигурации DataWedge и импорт на другие устройства. |
| Восстановить настройки по умолчанию | Вернуть DataWedge к его настройкам по умолчанию. |
| Авто импорт | DataWedge автоматически применяет файлы конфигурации, помещенные в его папку автоимпорта (см. раздел 4). |
| Сохранение конфигурации | Конфигурация сохраняется после перезагрузок. |
| Интерфейс конфигурации | Приложение DataWedge на устройстве для ручной настройки. |
Справка Zebra TechDocs:
Настройки DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/settings/
3.5 Программное управление и инструменты
| Функция | Описание |
|---|---|
| API намерения DataWedge | Управляйте DataWedge из приложения с помощью Android намерений - например, переключайте профили, запускайте мягкое сканирование, устанавливайте список отключенных приложений, запрашивайте статус сканера и создавайте или обновляйте конфигурацию. |
| Приложение DWDemo | Тестируйте сканирование и вывод данных. |
Справка Zebra TechDocs:
API DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/api/
DWDemo: https://techdocs.zebra.com/datawedge/latest/guide/samples/dwdemo/
4. Начало работы
Шаг 1 - Обновите ОС
- Обновите устройство до Elo Android 14 MR-9 (7.000.009.0046+gen5p) или позже через портал EloView или Панель управления EloView на устройстве. Другие пользователи MDM могут использовать функции автоматического и ручного обновления Elo OEMConfig.
- Если вы используете сканер штрих-кодов Edge Connect, подключите его к устройству.
- Откройте приложение DataWedge из лаунчера приложений.
Шаг 2 - Включите Profile0 и проверьте
- Profile0 - это резервный профиль, который применяется к каждому приложению без собственного профиля. В базовой сборке он отключен по умолчанию, поэтому приложения без собственного профиля не получают плавающую кнопку сканирования, и DataWedge не удерживает камеру, пока вы не включите ее.
- Чтобы включить его, откройте Настройки Android Elo Settings и включите Сканирование DataWedge (Profile0). Затем откройте DWDemo, сканируйте штрих-код с помощью подключенного сканера (или нажмите и удерживайте желтую кнопку сканирования на экране: при выборе сканера на Авто используется подключенный USB-сканер, а без подключенного USB-сканера сканируется передней камерой), и подтвердите, что данные появились.
- Пока управление Elo Settings активно, запись Profile0 в приложении DataWedge затенена ("отключено администратором"); измените Profile0 через Elo Settings.
- Чтобы включить сканирование без прикосновения к каждому устройству, дайте вашему приложению свой собственный профиль, а не полагайтесь на Profile0. Профиль применяется, когда его приложение на переднем плане, независимо от настройки Profile0. Создайте его на эталонном устройстве и разверните его на флоте с помощью Авто Импорт (Шаг 5), или пусть приложение создаст его при первом запуске с помощью API SET_CONFIG Intent для DataWedge (см. Для разработчиков).
Шаг 3 - Создайте профиль для вашего приложения
- В DataWedge откройте меню и выберите Новый профиль; введите имя.
- Откройте Связанные приложения и добавьте пакет вашего приложения (и, при желании, конкретные активности).
- В разделе Ввод штрих-кодов убедитесь, что ввод включен, и выберите устройство в разделе Выбор сканера (Авто по умолчанию; чтобы выбрать конкретный внешний сканер или переднюю камеру, откройте меню и выберите Сохранить новый сканер). Примечание: сканер, выбранный в меню выбора сканера ввода штрих-кодов, - тот, который используется профилем; Конфигурация параметров сканера только устанавливает параметры этого сканера.
- В разделе Декодеры включите только символики, необходимые вашему рабочему процессу.
- Выберите вывод: Вывод нажатий клавиш для приложений, которые читают текстовые поля, или Вывод намерений для приложений, которые получают данные сканирования программно (установите действие намерения, категорию и способ доставки, чтобы соответствовать получателю вашего приложения). Отключите вывод, который вы не используете.
- При желании добавьте префиксы, суффиксы или правила в разделе Основное или Расширенное форматирование данных.
- Переведите ваше приложение на передний план - DataWedge автоматически переключается на новый профиль.
Шаг 4 - Управление Profile0 и кнопкой сканирования на экране
- Profile0 по умолчанию отключен, поэтому приложения без собственного профиля не показывают плавающую кнопку сканирования. Включите или выключите его в Настройки Android > Elo Settings > Сканирование DataWedge (Profile0).
- Data Capture Plus включен по умолчанию в каждом новом профиле, поэтому плавающая кнопка сканирования также появляется в приложениях, которые имеют свой собственный профиль. Чтобы скрыть его для приложения, откройте профиль этого приложения и снимите отметку с Data Capture Plus > Включено.
- Приложения, которые не должны делить камеру или получать данные сканирования - например, приложения для платежей tap-to-pay / SoftPOS, которые обнаруживают использование камеры - должны быть добавлены в Настройки > Список отключенных приложений в DataWedge или Profile0 должен оставаться выключенным.
Шаг 5 - Разверните конфигурацию на вашем флоте
- На настроенном эталонном устройстве откройте Экспорт настроек DataWedge и экспортируйте полную конфигурацию (datawedge.db) или отдельный профиль (dwprofile\_<name>.db).
- Используйте ваш MDM для отправки файла в папку автоимпорта DataWedge на целевых устройствах:
/storage/emulated/0/Android/data/com.symbol.datawedge/files/autoimport
- DataWedge автоматически импортирует файл и применяет его без перезагрузки. Не переименовывайте и не редактируйте экспортированные файлы .db.
Для разработчиков
- Используйте API Intent DataWedge для переключения профилей, запуска сканирования и создания или обновления профилей из вашего приложения: https://techdocs.zebra.com/datawedge/latest/guide/api/
- Справка по профилям и плагинам: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
- Приложения, уже интегрированные с DataWedge на устройствах Zebra с Android, не требуют изменений кода сканирования для набора функций Этапа 1.
5. Ресурсы и поддержка
- Документация Zebra DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/about/
- Поддержка Elo: https://www.elotouch.com/support
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article