Developer Hub / Barcode/Scanner

Integration des Barcode-Scanners

Schaffen Sie eine klare Scanner-Grenze, normalisieren Sie Ergebnisse aus Keyboard Wedge, Intent oder direktem SDK-Aufruf und schließen Sie jede Sitzung sauber.

PublikationsstandardEntwickler

Verbinden und validieren Sie Ihre App auf der Zielhardware.

Ein wiederholbarer Scan-Flow, der eine anwendungseigene Ereignisform liefert.

Android Entwickler integrieren einen Handheld-Scanner in eine bestehende App.

Öffentliche Inhalte behandeln reproduzierbare Integrationsmuster. Eingeschränkte SDKs, Firmware und Herstellerunterlagen bleiben in freigegebenen Kanälen.

Vergleichbare Nachweise mit Methode, Version und Grenzen.

EntwicklerressourcenBarcode/Scanner
RuggedLayer TestlaborAnfänger
Technische Guides, SDK-Hinweise, Beispiel-Apps und Kompatibilitätsdaten für Barcode und RFID.Android Entwickler integrieren einen Handheld-Scanner in eine bestehende App.
  • An Android App mit einem Workflow, der ein Barcode-Ergebnis benötigt.
  • Das genaue Zielmodell, Android Bau und genehmigtes Gerät SDK identifiziert.
  • Eine Entscheidung über Keil, Absicht oder direkte SDK Transport; mischen Sie sie nicht versehentlich.

Publikationsstandard

Enterprise-Android-Integrationen mit versionierten Nachweisen entwickeln.

Öffentliche Inhalte behandeln reproduzierbare Integrationsmuster. Eingeschränkte SDKs, Firmware und Herstellerunterlagen bleiben in freigegebenen Kanälen.

  1. 01

    Wählen Sie den Transport für den Workflow

    Verwenden Sie Keil, wenn ein fokussiertes Formular eine schnelle Nachrüstung benötigt. Verwenden Sie eine explizite Absicht oder einen Rückruf, wenn die Anwendung das Ereignis besitzt. Verwenden Sie ein direktes Gerät API nur hinter einem kleinen Adapter, so dass Business-Bildschirme nicht von Anbietertypen abhängen.

  2. 02

    Definieren Sie das Ereignis, das Ihre Anwendung besitzt

    Halten Sie dekodierten Text, rohe Bytes, Symbologie und empfangene Zeit zusammen. Behandeln Sie die Transportnutzlast als nicht vertrauenswürdige Eingabe und lehnen Sie fehlende, übergroße oder undekodierbare Daten ab, bevor sie die Bestandslogik erreicht.

  3. 03

    Öffnen, Hören, Starten und Stoppen in einem Besitzer

    Registrieren Sie den Ergebnispfad, bevor Sie eine Dekodierung starten. Starten Sie nur einmal, stoppen Sie, wenn der Workflow endet, und schließen Sie die Geräteressource von jedem Exit-Pfad, einschließlich Hintergrund, Stornierung und Fehler.

  4. 04

    Beweisen Sie die unglücklichen Wege

    Testen Sie eine leere Nutzlast, doppeltes Ergebnis, Timeout, nicht unterstützte Symbologie, Bildschirmlebenslauf und ein Gerät ohne Scanneroption. Ein grüner Scan auf einem Gerät ist keine Kompatibilitätserklärung für jede Konfiguration.

Beispielanwendungen / Kotlin

SDK- und API-Muster

Original-Adaptermuster: CapturePort an das genehmigte Gerät binden SDK In Ihrem privaten Android Projekt.

scan-boundary.kt

data class CaptureEvent(
  val value: String,
  val symbology: String?,
  val capturedAt: Instant,
)

interface CapturePort {
  fun open()
  fun start()
  fun stop()
  fun close()
  fun setListener(listener: (CaptureEvent) -> Unit)
}

class ScanWorkflow(private val scanner: CapturePort) {
  private var active = false

  fun begin(onCapture: (CaptureEvent) -> Unit) {
    if (active) return
    scanner.open()
    scanner.setListener(onCapture)
    scanner.start()
    active = true
  }

  fun end() {
    if (!active) return
    runCatching { scanner.stop() }
    runCatching { scanner.close() }
    active = false
  }
}
Hersteller-Binärdateien, API-Referenzen, Firmware und Quellcode-Beispiele werden nur veröffentlicht, wenn Redistributionsgenehmigung und unterstützter Umfang dokumentiert sind.

SDK-Verteilung

Publikationsprüfung

Hersteller-Binärdateien, API-Referenzen, Firmware und Quellcode-Beispiele werden nur veröffentlicht, wenn Redistributionsgenehmigung und unterstützter Umfang dokumentiert sind.

Kein Wert oder Rohbytes

Geben Sie einen Eingabefehler zurück und halten Sie den Workflow für einen anderen Scan verfügbar.

Das gleiche Ergebnis kommt zweimal

Deduplizieren durch einen kurzlebigen Ereignisschlüssel; Inventar niemals stillschweigend doppelt empfangen.

Timeout oder Scanner beschäftigt

Stoppen Sie den aktuellen Vorgang, zeigen Sie einen wiederherstellbaren Zustand an und erlauben Sie eine kontrollierte Wiederholung.

Bildschirm verlässt den Vordergrund

Stoppen oder pausieren Sie gemäß dem Workflow-Vertrag und registrieren Sie sich dann sicher im Lebenslauf.

Nachweisstatus

Vergleichbare Nachweise mit Methode, Version und Grenzen.

  1. 01

    Aufzeichnungsmodell, Option Scanner, Android Build, Firmware und SDK Freigabe.

  2. 02

    Kaltstart, wiederholte Start-/Stopp-, Hintergrund-/Wiederaufnahme- und Annullierungstests.

  3. 03

    Verwendungscode 128, ein beschädigtes Label, ein leerer Auslöser und eine nicht unterstützte Symbologie.

  4. 04

    Bestätigen Sie, dass keine rohen Scandaten oder Kundenkennung in gewöhnliche Protokolle geschrieben werden.

Verbinden und validieren Sie Ihre App auf der Zielhardware. Führen Sie den gleichen Event-Vertrag mit einem gefälschten Adapter aus, bevor Sie Hardware anschließen.

Ressourcen

SDK- und API-Muster

Hersteller-Binärdateien, API-Referenzen, Firmware und Quellcode-Beispiele werden nur veröffentlicht, wenn Redistributionsgenehmigung und unterstützter Umfang dokumentiert sind.

Verbinden und validieren Sie Ihre App auf der Zielhardware.

Teilen Sie den nicht vertraulichen App-Ablauf, das aktuelle Gerät und den Integrationsweg; wir legen den passenden Validierungsumfang fest.

App verbinden und validieren