API per Android 2.3.4

Livello API: 10

Android 2.3.4 (GINGERBREAD_MR1) è una release di manutenzione che aggiunge diverse correzioni di bug e patch alla piattaforma Android 2.3, senza alcuna modifica API rispetto ad Android 2.3.3. Inoltre, Android 2.3.4 introduce il supporto dell'API Open Accessory sui dispositivi mobili, tramite l'opzione facoltativa Apri la raccolta di accessori.

Per gli sviluppatori, la piattaforma Android 2.3.4 è disponibile come componente scaricabile per l'SDK Android. La piattaforma scaricabile include una libreria Android e un'immagine di sistema, nonché una serie di skin di emulazione altro ancora. Per iniziare a sviluppare o testare soluzioni rispetto ad Android 2.3.4, usa Android SDK Manager per scaricare la piattaforma nell'SDK.

Panoramica dell'API

Android 2.3.4 fornisce alle applicazioni la stessa API framework di Android 2.3.3 (livello API 10). Per un riepilogo dell'API, consulta le note sulla versione di Android 2.3.3.

Apri la raccolta di accessori

Open Accessory è una nuova funzionalità di integrazione periferiche connesse con applicazioni in esecuzione sulla piattaforma. La funzionalità si basa su uno stack USB (Universal Serial Bus) integrato nella piattaforma e su un'API esposta alle applicazioni. Le periferiche collegate ai dispositivi Android come accessori si connettono come host USB.

Open Accessory è stato introdotto in Android 3.1 (livello API 12), ma resa disponibile ai dispositivi con Android 2.3.4 mediante un nella libreria di accessori, la libreria di accessori La libreria espone un'API framework che consente alle applicazioni di rilevare, comunicare con e gestire una varietà di dispositivi collegati tramite USB. Fornisce inoltre l'implementazione dell'API per le parti della piattaforma Android non esposte direttamente alle applicazioni in Android 2.3.4.

La raccolta di accessori aperti è facoltativa su qualsiasi dispositivo. I produttori di dispositivi possono scegliere se includere o meno la Open Accessory Library nei loro prodotti. La libreria è compatibile con Android 3.1, quindi le applicazioni sviluppate rispetto ad Android 2.3.4 funzionano correttamente sui dispositivi con Android 3.1, se tali dispositivi supportano gli accessori USB.

L'API fornita da Open Accessory Library si basa sul modello Open Accessory API fornita in Android 3.1. Nella maggior parte delle aree, puoi utilizzare le stesse tecniche su quelle di livello inferiore. Tuttavia, lo sviluppo per la Open Accessory Library su Android 2.3.4 differisce dall'API USB standard nei modi seguenti:

  • Acquisizione di un oggetto UsbManager: per ottenere è un oggetto UsbManager quando utilizzi la libreria dei componenti aggiuntivi, usa il metodo helper getInstance() anziché getSystemService() Ad esempio:

    Kotlin

    val manager = UsbManager.getInstance(this)

    Java

    UsbManager manager = UsbManager.getInstance(this);
  • Ottenere un UsbAccessory da un intent filtrato: quando filtri per un dispositivo o un accessorio connesso con un filtro per intent, l'oggetto UsbAccessory è contenuto nell'intent passato all'applicazione. Se utilizzi nella libreria di componenti aggiuntivi, puoi recuperare l'oggetto UsbAccessory nel seguente modo:

    Kotlin

    val accessory = UsbManager.getAccessory(intent)

    Java

    UsbAccessory accessory = UsbManager.getAccessory(intent)
  • Nessun supporto host USB: Android 2.3.4 e la Open Accessory Library non supportano la modalità host USB (ad esempio tramite UsbDevice), anche se la modalità host USB è supportata in Android 3.1. Un dispositivo Android con sistema operativo Android 2.3.4 non può funzionare come USB . La libreria consente al dispositivo Android di funzionare solo una periferica, con l'accessorio connesso che funziona come host USB (tramite UsbAccessory).

Per sviluppare app utilizzando la sezione Apri raccolta accessori, devi avere:

  • L'ultima versione degli strumenti SDK Android
  • L'ultima versione del componente aggiuntivo delle API di Google, che include la libreria stessa (per il collegamento)
  • Un dispositivo hardware reale con Android 2.3.4 (o Android 3.1) con USB il supporto degli accessori, per eseguire test di runtime su dispositivi connessi

Per una discussione completa su come sviluppare applicazioni che interagiscono con gli accessori USB, consulta la documentazione per gli sviluppatori correlata.

Inoltre, gli sviluppatori possono richiedere il filtraggio su Google Play, in modo che le loro applicazioni non siano disponibili per gli utenti i cui dispositivi non forniscono il supporto degli accessori appropriati. Per richiedere il filtro, aggiungi l'elemento riportato di seguito al manifest dell'applicazione:

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

Livello API

La piattaforma Android 2.3.4 non incrementa il livello API. utilizza lo stesso livello API di Android 2.3.3, livello API 10.

Per utilizzare le API introdotte nel livello API 10 nella tua applicazione, devi compilare l'applicazione in base alla libreria Android fornita nella versione più recente del componente aggiuntivo API di Google, che include anche la libreria Open Accessory.

A seconda delle tue esigenze, potresti anche dover aggiungere un attributo android:minSdkVersion="10" all'elemento <uses-sdk> nel manifest dell'applicazione. Se la tua applicazione è progettata per funzionare solo su Android 2.3.3 e versioni successive, la dichiarazione dell'attributo impedisce l'installazione dell'applicazione su versioni precedenti della piattaforma.

Per saperne di più, consulta la pagina Che cos'è l'API Livello?