После обновления приложения на ТСД перестали сканироваться штрих-коды? Раньше всё работало? Вот пошаговая инструкция по диагностике и решению проблемы.
1
Подготовка
- Убедитесь, что ТСД заряжен — аккумулятор выше 50%
- Запишите точное название и версию приложения
- Запишите версию ОС/прошивки ТСД
2
Быстрая проверка аппаратуры
- Откройте встроенное демо-приложение сканера (если есть) и попытайтесь считать штрих-код
- Если не сканирует — проблема в сканере или прошивке
- Попробуйте сканировать сторонним приложением (например, Barcode Scanner)
- Если работает — проблема именно в обновлённом приложении
3
Проверка настроек после обновления
- Проверьте разрешения: камера, сканер, хранение, интенты (Настройки Android → Разрешения → Приложение)
- Внутри приложения проверьте — включён ли движок сканирования
- Проверьте разрешены ли нужные типы штрих-кодов (EAN, Code128 и т.д.)
- Верните пользовательские профили сканирования к значениям по умолчанию
4
Проверка сервисов сканера
- Убедитесь, что сервис сканера (ScanService/DecoderService) запущен
- Перезапустите сервис или всё устройство
- Проверьте логи на ошибки инициализации:
adb logcat | grep -i scan
5
Совместимость SDK / API
- Уточните: использует ли приложение нативный API производителя или сторонний SDK
- После обновления могли измениться вызовы или версии
- Проверьте changelog обновления на упоминание изменений в модуле сканирования
- Откатитесь на предыдущую версию для проверки
6
Конфликты с другими приложениями
- Отключите фоновые приложения, которые могут перехватывать сканер или камеру
- Проверьте политики MDM (Kiosk, Single App режим)
- Обновление могло сбросить разрешения MDM
7
Тестирование условий сканирования
- Проверьте фокус и подсветку — попробуйте ближе/дальше
- Включите/выключите подсветку
- Попробуйте разные штрих-коды и этикетки
- Проверьте при разном освещении
8
Сбор логов и данных
- Соберите логи приложения и системы (logcat, скриншоты ошибок)
- Зафиксируйте точное время неудачных попыток
- Запишите серийный номер устройства
9
Откат / переустановка
- Если проблема появилась сразу после обновления — откатите приложение на предыдущую версию
- Установите APK старой версии для проверки
- Если откат помогает — причина в обновлении, готовьте баг-репорт разработчикам
10
Обращение к разработчикам
Передайте в поддержку:
- Шаги воспроизведения проблемы
- Версии приложения и прошивки
- Логи и скриншоты ошибок
- Результат проверки встроенного сканера
- Результат отката на старую версию
📋 Чек-лист для обращения в поддержку
- Версия приложения: ___________
- Версия ОС/прошивки ТСД: ___________
- Встроенный demo-сканер: OK / FAIL
- Разрешения приложения: OK / FAIL
- Логcat с ошибкой: приложен / нет
- Результат отката: OK / FAIL