APIs unter Android 2.3.4

API-Level:10

Android 2.3.4 (GINGERBREAD_MR1) ist eine Wartungsversion mit mehreren Fehlerbehebungen und Patches auf die Android 2.3-Plattform übertragen, ohne dass im Vergleich zu Android 2.3.3 API-Änderungen erforderlich sind. Außerdem wird mit Android 2.3.4 die Open Accessory API über die optionale Open Accessory Library auf Mobilgeräten unterstützt.

Für Entwickler ist die Android 2.3.4-Plattform als herunterladbare Komponente für das Android SDK. Die herunterladbare Plattform umfasst eine Android-Bibliothek und ein System-Image sowie eine Reihe von Emulator-Skins mehr. Um mit dem Entwickeln oder Testen auf Android 2.3.4 zu beginnen, Verwenden Sie den Android SDK Manager, um die Plattform in Ihr SDK herunterzuladen.

API-Übersicht

Android 2.3.4 bietet die gleiche Framework API für Anwendungen wie Android 2.3.3. (API-Level 10). Eine Zusammenfassung der API finden Sie in der Hinweise zur Android-Version 2.3.3

Zubehörbibliothek öffnen

Open Accessory ist eine neue Funktion, mit der verbundene Peripheriegeräte in Anwendungen eingebunden werden können, die auf der Plattform ausgeführt werden. Die Funktion basiert auf einem in die Plattform integrierten USB-Stack (Universal Serial Bus) und einer API, die für Anwendungen freigegeben ist. Peripheriegeräte, die als Zubehör an Android-Geräte angeschlossen werden, werden als USB-Hosts verbunden.

Open Accessory wurde in Android 3.1 (API-Level 12) eingeführt, ist aber auch auf Geräten mit Android 2.3.4 verfügbar, und zwar über eine optionale externe Bibliothek, die Open Accessory Library. Die Bibliothek stellt eine Framework-API bereit, mit der Anwendungen verschiedene über USB verbundene Gerätetypen finden, mit ihnen kommunizieren und verwalten können. Außerdem wird die API-Implementierung entsprechend der Android-Plattform, die nicht direkt Anwendungen in Android

Die Open Accessory Library ist auf jedem Gerät optional. Gerätehersteller können auswählen, ob die Open Accessory Library in ihren Produkten enthalten sein soll oder nicht. Die Bibliothek ist aufwärtskompatibel mit Android 3.1, Anwendungen, die für Android 2.3.4 entwickelt wurden, werden auf Geräten ordnungsgemäß ausgeführt. mit Android 3.1, sofern diese Geräte USB-Zubehör unterstützen.

Die von der Open Accessory Library bereitgestellte API basiert auf dem Open Accessory In Android 3.1 bereitgestellte API In den meisten Bereichen können Sie dieselben Techniken und APIs verwenden. Die Entwicklung für die Open Accessory Library unter Android 2.3.4 unterscheidet sich jedoch über die Standard-USB-API:

  • UsbManager-Objekt abrufen – um zu erhalten, ein UsbManager-Objekt, wenn Sie die Add-on-Bibliothek verwenden, Verwenden Sie die Hilfsmethode getInstance() statt getSystemService() Hier einige Beispiele:

    Kotlin

    val manager = UsbManager.getInstance(this)

    Java

    UsbManager manager = UsbManager.getInstance(this);
  • UsbAccessory über einen gefilterten Intent abrufen: Wenn Sie mit einem Intent-Filter nach einem verbundenen Gerät oder Zubehör filtern, ist das UsbAccessory-Objekt im Intent enthalten, der an Ihre Anwendung übergeben wird. Wenn Sie die Add-on-Bibliothek verwenden, können Sie das UsbAccessory-Objekt so abrufen:

    Kotlin

    val accessory = UsbManager.getAccessory(intent)

    Java

    UsbAccessory accessory = UsbManager.getAccessory(intent)
  • Keine USB-Host-Unterstützung: Android 2.3.4 und die Open Accessory Library unterstützen den USB-Host-Modus nicht (z. B. über UsbDevice). Der USB-Host-Modus wird jedoch in Android 3.1 unterstützt. Ein Android-Gerät mit Android 2.3.4 kann nicht als USB-Gerät verwendet werden. Host. Mit der Bibliothek kann das Android-Gerät nur als Peripheriegerät fungieren, wobei das verbundene Zubehör als USB-Host (über UsbAccessory) dient.

Zum Entwickeln von Apps mit der Open Accessory Library ist Folgendes erforderlich:

  • Die neueste Version der Android SDK-Tools
  • Die neueste Version des Google APIs-Add-ons, die die Bibliothek enthält sich selbst (zur Verknüpfung)
  • Ein echtes Hardwaregerät mit Android 2.3.4 (oder Android 3.1) und Unterstützung für USB-Zubehör für Laufzeittests mit verbundenen Geräten

Eine umfassende Besprechung der Entwicklung von Anwendungen, die mit USB interagieren finden Sie in der zugehörigen Entwicklerdokumentation.

Darüber hinaus können Entwickler eine Filterung bei Google Play beantragen, Ihre Anwendungen nicht für Nutzer verfügbar sind, deren Geräte den entsprechendes Zubehör anbieten. Fügen Sie das Element unten hinzu, um eine Filterung anzufordern an das App-Manifest an:

<uses-feature
  android:name="android.hardware.usb.accessory"
  android:required="true">

API-Ebene

Bei der Android 2.3.4-Plattform wird die API-Ebene nicht erhöht. Es wird dieselbe API-Ebene wie bei Android 2.3.3 verwendet, also API-Ebene 10.

Wenn Sie in Ihrer Anwendung APIs verwenden möchten, die in API-Level 10 eingeführt wurden, müssen Sie die Anwendung mit der Android-Bibliothek kompilieren, die in der neuesten Version des Google APIs Add-ons enthalten ist. Diese enthält auch die Open Accessory Library.

Je nach Ihren Anforderungen können Sie muss auch ein android:minSdkVersion="10"-Element <uses-sdk>-Element im Feld Manifests. Wenn Ihre App nur für Android 2.3.3 und höher entwickelt wurde, Durch das Deklarieren des Attributs wird verhindert, dass die Anwendung früher installiert wird. Versionen der Plattform.

Weitere Informationen finden Sie unter Was ist eine API? Stufe?