UROVO ScanManager Kotlin przykład i lista kontrolna walidacji

Przygotuj powtarzalną SDK linię bazową

Spakuj zatwierdzony artefakt SDK w ramach kontrolowanego procesu pobierania przez programistę. Zapisz jego wersję i SHA-256 wraz z kompilacją aplikacji i rekordem urządzenia.

Zachowaj interfejsy API dostawcy za adapterem skanera, aby można było testować logikę biznesową bez sprzętu i zastąpić inną implementację przechwytywania.

• Tylko zatwierdzone źródło SDK.
• Zarejestrowano skrót artefaktu
• Zdefiniowano granicę adaptera
• Utworzono matrycę urządzeń

Posiadaj raz cykl życia skanera

Referencja API dokumentuje funkcje openScanner, CloseScanner, startDecode, stopDecode i funkcje trybu wyjściowego. Zdecyduj, czy działanie, usługa na pierwszym planie lub inny komponent o zasięgu aplikacji jest właścicielem tych wywołań.

Unikaj niezależnego otwierania skanera na wielu ekranach. Zapewnij bezpieczne powtarzanie wartości zatrzymania i zamknięcia oraz wynurzanie wartości zwracanych w stanie diagnostycznym bez rejestrowania ładunków z kodem kreskowym.

• Pojedynczy właściciel zasobu
• Idempotentne czyszczenie
• Zaobserwowane wartości zwracane
• Brak ładunków w zwykłych dziennikach

Sprawdź ładunek rozgłoszeniowy

Pomyślna transmisja dekodowania może obejmować nieprzetworzone dane, zdekodowany ciąg znaków, długość i typ kodu kreskowego. Przed dostarczeniem zdarzenia domeny sprawdź działanie, dopuszczalność wartości null i długość.

Wybierz jedną wiarygodną reprezentację. Jeśli kodowanie ma znaczenie, zachowaj surowe bajty i dekoduj przy użyciu jawnego zestawu znaków, zamiast zakładać, że każdy kod kreskowy jest prostym kodem ASCII.

• Akcja dokładnie pasuje
• Długość zgodna z ładownością
• Udokumentowana polityka kodowania
• Zduplikowany strażnik zdarzeń

Przejdź od wersji demonstracyjnej do dowodów produkcyjnych

Sukces kompilacji dowodzi jedynie zgodności źródła. Uruchom aplikację na każdym zamierzonym modelu, systemie operacyjnym i oprogramowaniu sprzętowym, korzystając z reprezentatywnych etykiet i scenariuszy cyklu życia.

Zapisz ustawienia skanera i tryb wyjściowy po konfiguracji. Test regresji po zmianach oprogramowania sprzętowego, SDK, aplikacji lub MDM zasad.

• Reprezentatywny korpus skanów
• Uśpij i wznów cykle
• Przypadki szybkiego i długiego kodu
• Wersjonowany zapis testu

Przykład uwzględniający minimalny cykl życia Kotlin.

Sprawdź stałe trybu wyjściowego, Android flagi odbiornika i własność cyklu życia pod kątem dokładnej SDK, docelowej API i architektury aplikacji.

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.
    }
}

Lista kontrolna sprawdzania poprawności programu ScanManager

Dołącz ten rekord do zatwierdzonej aplikacji i linii bazowej urządzenia.

1. 01

   Zarejestrowano wersję SDK i SHA-256

2. 02

   Zapisano urządzenie SKU, system operacyjny i oprogramowanie sprzętowe

3. 03

   Skaner wielokrotnie się otwiera i zamyka

4. 04

   Tryb wyjścia odczytany lub potwierdzony

5. 05

   Cykl życia odbiornika odpowiada aktywnemu interfejsowi użytkownika

6. 06

   Sprawdzono surowiec, sznurek, długość i dodatki typu

7. 07

   Przetestowano wszystkie wymagane symboliki

8. 08

   Testowano długie, uszkodzone i szybkie skany

9. 09

   Przetestowano tryb uśpienia, ponownego uruchomienia i MDM trybu kiosku

10. 10

    Nie zarejestrowano żadnych wrażliwych danych kodu kreskowego

Często zadawane pytania