UROVO ScanManager Kotlin пример и контрольный список проверки

Подготовьте воспроизводимый базовый уровень SDK

Упакуйте одобренный артефакт SDK посредством контролируемого процесса загрузки разработчика. Запишите его версию и SHA-256 вместе со сборкой приложения и записью устройства.

Храните API-интерфейсы поставщиков за адаптером сканера, чтобы бизнес-логику можно было тестировать без аппаратного обеспечения и можно было заменить другую реализацию захвата.

• Только утвержденный источник SDK
• Хеш артефакта записан
• Определена граница адаптера
• Матрица устройств создана

Один раз стать обладателем жизненного цикла сканера

Справочные документы API документируют openScanner, closeScanner, startDecode, stopDecode и функции режима вывода. Решите, будут ли эти вызовы принадлежать действию, службе переднего плана или другому компоненту области приложения.

Избегайте независимого открытия сканера на нескольких экранах. Сделайте остановку и закрытие безопасными для повторения и отображайте ошибочные возвращаемые значения в состоянии диагностики без регистрации полезных данных штрих-кода.

• Один владелец ресурса
• Идемпотентная очистка
• Возвращаемые значения наблюдаются
• Нет полезной нагрузки в обычных логах

Проверка полезной нагрузки широковещательной передачи

Успешная трансляция декодирования может включать в себя необработанные данные, декодированную строку, длину и тип штрих-кода. Прежде чем доставлять событие домена, проверьте действие, допустимость значений NULL и длину.

Выберите одно авторитетное представление. Если кодировка имеет значение, сохраняйте необработанные байты и декодируйте их с использованием явной кодировки вместо того, чтобы предполагать, что каждый штрих-код представляет собой простой ASCII.

• Действие точно соответствует
• Длина соответствует полезной нагрузке
• Политика кодирования документирована
• Дублирующая защита событий

Переход от демонстрации к доказательствам

Успех компиляции подтверждает только совместимость исходного кода. Запустите приложение на каждой предполагаемой модели, ОС и прошивке с репрезентативными метками и сценариями жизненного цикла.

Запишите настройки сканера и режим вывода после настройки. Регрессионный тест после изменения прошивки, SDK, приложения или политики MDM.

• Репрезентативный корпус сканирования
• Циклы сна и возобновления
• Случаи быстрого и длинного кода
• Версионная тестовая запись

Пример Kotlin с минимальным жизненным циклом

Проверьте константы режима вывода, флаги получателя Android и владение жизненным циклом на соответствие точному SDK, целевому API и архитектуре приложения.

import android.content.BroadcastReceiver
import android.content.Context
import android.content.Intent
import android.content.IntentFilter
import android.device.ScanManager
import androidx.appcompat.app.AppCompatActivity

class UrovoScannerActivity : AppCompatActivity() {
    private val scanner = ScanManager()
    private var receiverRegistered = false

    private val decodeReceiver = object : BroadcastReceiver() {
        override fun onReceive(context: Context, intent: Intent) {
            if (intent.action != ScanManager.ACTION_DECODE) return
            val raw = intent.getByteArrayExtra(ScanManager.DECODE_DATA_TAG) ?: return
            val declaredLength = intent.getIntExtra(ScanManager.BARCODE_LENGTH_TAG, raw.size)
            val type = intent.getByteExtra(ScanManager.BARCODE_TYPE_TAG, 0)
            val value = intent.getStringExtra(ScanManager.BARCODE_STRING_TAG)
                ?: raw.copyOf(declaredLength.coerceIn(0, raw.size)).toString(Charsets.UTF_8)
            onValidatedScan(value, type)
        }
    }

    override fun onStart() {
        super.onStart()
        check(scanner.openScanner()) { "Scanner could not be opened" }
        // Confirm the broadcast-output constant in the SDK version you ship.
        check(scanner.switchOutputMode(0)) { "Output mode could not be set" }
        registerReceiver(decodeReceiver, IntentFilter(ScanManager.ACTION_DECODE))
        receiverRegistered = true
    }

    override fun onStop() {
        scanner.stopDecode()
        if (receiverRegistered) unregisterReceiver(decodeReceiver)
        receiverRegistered = false
        scanner.closeScanner()
        super.onStop()
    }

    private fun onValidatedScan(value: String, type: Byte) {
        // Route a sanitized domain event; do not log sensitive barcode values.
    }
}

Контрольный список проверки ScanManager

Прикрепите эту запись к утвержденному базовому состоянию приложения и устройства.

1. 01

   Версия SDK и SHA-256 записаны

2. 02

   Устройство SKU, записанная ОС и прошивка

3. 03

   Сканер неоднократно открывается и закрывается

4. 04

   Режим вывода прочитан или подтвержден

5. 05

   Жизненный цикл получателя соответствует активному пользовательскому интерфейсу

6. 06

   Проверены дополнительные параметры необработанных данных, строк, длины и типа.

7. 07

   Все необходимые символы проверены

8. 08

   Проверено длительное, поврежденное и быстрое сканирование

9. 09

   Спящий режим, перезагрузка и режим киоска MDM протестированы.

10. 10

    Конфиденциальные данные штрих-кода не сохраняются

Часто задаваемые вопросы