Developer Hub / Hardware Key Mapping

Hardware Key Mapping

Inspizieren Sie einen physischen Schlüssel, bewahren Sie die ursprüngliche Zuordnung auf und bieten Sie einen zuverlässigen Wiederherstellungspfad, bevor Sie das Verhalten ändern.

PublikationsstandardEntwickler

Verbinden und validieren Sie Ihre App auf der Zielhardware.

Eine reversible Schlüsselanpassung, die den Bediener nicht stillschweigend stranden oder das erforderliche Systemverhalten blockieren kann.

Teams passen Scan-Trigger, Aktionstasten oder Workflow-Verknüpfungen an verwalteten Handhelds an.

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

Vergleichbare Nachweise mit Methode, Version und Grenzen.

EntwicklerressourcenHardware Key Mapping
RuggedLayer TestlaborZwischenprodukt
Technische Guides, SDK-Hinweise, Beispiel-Apps und Kompatibilitätsdaten für Barcode und RFID.Teams passen Scan-Trigger, Aktionstasten oder Workflow-Verknüpfungen an verwalteten Handhelds an.
  • Ein physisches Gerät mit einem dokumentierten Zielschlüssel und einer genehmigten Bereitstellungsrichtlinie.
  • Ein Wiederherstellungspfad, der nicht vom neu zugeordneten Schlüssel abhängt.
  • Eine explizite Entscheidung darüber, ob die Änderung App-Level oder Device-Level ist.

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

    Bestimmen Sie die kleinste Kontrollfläche

    Verwenden Sie die Schlüsselverarbeitung auf Anwendungsebene, wenn der Workflow in der App bleiben kann. Verwenden Sie die Zuordnung auf Geräteebene nur, wenn die Bereitstellungsrichtlinie und das Modell sie unterstützen.

  2. 02

    Snapshot vor dem Wechsel

    Lesen und Speichern des ursprünglichen Schlüsselcodes, des Aktions- und Abhörzustands in einem kontrollierten Bereitstellungsprotokoll. Gehen Sie niemals davon aus, dass das Factory Mapping in allen Varianten identisch ist.

  3. 03

    Karte einen Schlüssel auf einmal

    Wenden Sie eine reversible Änderung an, überprüfen Sie sie im Ziel-Workflow und halten Sie Navigations-, Notfall-, Zahlungs- und Systemschlüssel außerhalb der Demo.

  4. 04

    Wiederherstellung und Neustart

    Überprüfen Sie Wiederherstellung, Reboot-Persistenz, Factory-Reset-Verhalten und ein physisches Wiederherstellungsverfahren. Eine erfolgreiche Remap ohne Wiederherstellung ist nicht einsatzbereit.

Beispielanwendungen / Kotlin

SDK- und API-Muster

Das öffentliche Beispiel modelliert sichere Zustandsübergänge; die tatsächliche Zuordnung auf Geräteebene bleibt modell- und richtlinienspezifisch.

key-restore-plan.kt

data class KeySnapshot(
  val keyCode: Int,
  val action: String?,
  val intercepted: Boolean,
)

interface KeyPort {
  fun snapshot(keyCode: Int): KeySnapshot
  fun apply(keyCode: Int, action: String)
  fun restore(snapshot: KeySnapshot)
}

fun applyTemporaryMapping(port: KeyPort, keyCode: Int, action: String) {
  val original = port.snapshot(keyCode)
  try {
    port.apply(keyCode, action)
    // Verify the workflow here before the device leaves the lab.
  } catch (error: Throwable) {
    port.restore(original)
    throw error
  }
}
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.

Der Schlüssel hat keinen bekannten Eintrag

Stoppen und notieren sie die modellspezifische einschränkung; schreiben sie kein erratenes mapping.

Die App verliert Navigationseingaben

Verwenden Sie den physischen Wiederherstellungspfad, stellen Sie den Snapshot wieder her und entfernen Sie das Mapping aus der Bereitstellung.

Mapping verschwindet nach dem Neustart

Markieren Sie es nur für die Sitzung und verschieben Sie die Persistenz in die Bereitstellungskonfiguration, falls genehmigt.

Nachweisstatus

Vergleichbare Nachweise mit Methode, Version und Grenzen.

  1. 01

    Notieren Sie die ursprüngliche Zuordnung und testen Sie eine Wiederherstellung, bevor Sie die Änderung anwenden.

  2. 02

    Überprüfen Sie die Aktion in Vordergrund-, Hintergrund-, Neustart- und Reset-Szenarien.

  3. 03

    Systemnavigation und Notfallverhalten bleiben verfügbar.

  4. 04

    Bewahren Sie während der Prüfung neben dem Gerät eine Wiederherstellungsanweisung auf.

Verbinden und validieren Sie Ihre App auf der Zielhardware. Fügen Sie die Schlüsselrichtlinie und das Wiederherstellungsverfahren der Bereitstellungscheckliste hinzu.

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