API Android 2.3.4

Niveau d'API : 10

Android 2.3.4 (GINGERBREAD_MR1) est une version de maintenance qui ajoute plusieurs correctifs vers la plate-forme Android 2.3, sans aucune modification des API d'Android 2.3.3. De plus, Android 2.3.4 est compatible avec l'API Open Accessory sur les appareils mobiles, via la bibliothèque Open Accessory facultative.

Pour les développeurs, la plate-forme Android 2.3.4 est disponible en tant que composant téléchargeable pour le SDK Android. La plate-forme téléchargeable comprend une bibliothèque Android et une image système, ainsi qu'un ensemble d'apparences d'émulateur et plus encore. Pour commencer à développer ou à tester sur Android 2.3.4, utilisez Android SDK Manager pour télécharger la plate-forme dans votre SDK.

Présentation de l'API

Android 2.3.4 fournit aux applications la même API de framework qu'Android 2.3.3. (niveau d'API 10). Pour obtenir un résumé de l'API, consultez les notes de version d'Android 2.3.3.

Ouvrir la bibliothèque d'accessoires

Open Accessory est une nouvelle fonctionnalité d'intégration périphériques connectés avec des applications s'exécutant sur la plateforme. Cette fonctionnalité repose sur une pile USB (Universal Serial Bus) intégrée à la plate-forme et une API exposée aux applications. Les périphériques qui se connectent aux appareils Android en tant qu'accessoires se connectent en tant qu'hôtes USB.

L'accessoire ouvert est introduit dans Android 3.1 (niveau d'API 12), mais il est mis à la disposition des appareils équipés d'Android 2.3.4 au moyen d'une la bibliothèque Open Accessory. La bibliothèque expose une API de framework qui permet aux applications de découvrir, de communiquer avec et de gérer divers types d'appareils connectés via USB. Il fournit également l'implémentation de l'API sur des parties de la plate-forme Android qui ne sont pas directement exposées aux applications dans Android 2.3.4.

La bibliothèque Open Accessory est facultative sur n'importe quel appareil. Les fabricants d'appareils peuvent choisir d'inclure ou d'exclure la bibliothèque Open Accessory dans leurs produits. La bibliothèque est rétrocompatible avec Android 3.1. les applications développées avec Android 2.3.4 s'exécutent correctement sur les appareils fonctionnant sous Android 3.1, si ces appareils sont compatibles avec les accessoires USB.

L'API fournie par la bibliothèque d'accessoires ouverts est basée sur l'API Open Accessory API fournie dans Android 3.1. Dans la plupart des domaines, vous pouvez utiliser les mêmes techniques et API. Toutefois, le développement pour la bibliothèque Open Accessory sur Android 2.3.4 diffère de l'API USB standard de la manière suivante :

  • Obtenir un objet UsbManager : pour obtenir un objet UsbManager lorsque vous utilisez la bibliothèque de modules complémentaires ; Utilisez la méthode d'assistance getInstance() plutôt que getSystemService(). Par exemple:

    Kotlin

    val manager = UsbManager.getInstance(this)

    Java

    UsbManager manager = UsbManager.getInstance(this);
  • Obtenir un UsbAccessory à partir d'un intent filtré : lorsque vous filtrez un appareil ou un accessoire connecté à l'aide d'un filtre d'intent, l'objet UsbAccessory est contenu dans l'intent transmis à votre application. Si vous utilisez vous pouvez obtenir l'objet UsbAccessory de la manière suivante:

    Kotlin

    val accessory = UsbManager.getAccessory(intent)

    Java

    UsbAccessory accessory = UsbManager.getAccessory(intent)
  • Pas de prise en charge des hôtes USB : Android 2.3.4 et la bibliothèque d'accessoires ouverts n'est pas compatible avec le mode hôte USB (via UsbDevice, par exemple), bien qu'il soit compatible avec Android 3.1. Un appareil Android fonctionnant sous Android 2.3.4 ne peut pas servir d'hôte USB. Cette bibliothèque permet à l'appareil Android de fonctionner comme Un périphérique uniquement, l'accessoire connecté fonctionnant comme hôte USB (via UsbAccessory).

Pour développer des applications à l'aide de la bibliothèque Open Accessory, vous avez besoin des éléments suivants :

  • La dernière version des outils du SDK Android
  • La dernière version du module complémentaire des API Google, qui inclut la bibliothèque elle-même (pour l'association)
  • Un appareil physique exécutant Android 2.3.4 (ou Android 3.1) avec USB la compatibilité avec les accessoires, pour les tests d'exécution sur des appareils connectés ;

Pour en savoir plus sur le développement d'applications qui interagissent avec des accessoires USB, consultez la documentation destinée aux développeurs correspondante.

De plus, les développeurs peuvent demander un filtrage sur Google Play afin que leurs applications ne soient pas disponibles pour les utilisateurs dont les appareils ne sont pas compatibles avec les accessoires appropriés. Pour demander un filtrage, ajoutez l'élément ci-dessous au fichier manifeste de l'application:

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

Niveau d'API

La plate-forme Android 2.3.4 n'augmente pas le niveau d'API. Elle utilise le même niveau d'API qu'Android 2.3.3, soit le niveau d'API 10.

Pour utiliser les API introduites au niveau d'API 10 dans votre application, vous devez compiler l'application avec la bibliothèque Android fournie dans la dernière version du module complémentaire des API Google, qui inclut également la bibliothèque Open Accessory.

Selon vos besoins, vous devrez peut-être également ajouter un attribut android:minSdkVersion="10" à l'élément <uses-sdk> dans le fichier manifeste de l'application. Si votre application est conçue pour s'exécuter uniquement sur Android 2.3.3 ou version ultérieure, déclarer l'attribut empêche son installation sur les versions antérieures de la plate-forme.

Pour plus d'informations, consultez la page Qu'est-ce que l'API ? Niveau ?