Panoramica della compatibilità dei dispositivi

Android è progettato per funzionare su molti dispositivi diversi, come smartphone, tablet e televisori. L'ampia gamma di dispositivi offre un pubblico potenziale enorme per la tua app. Affinché la tua app abbia successo su tutti i dispositivi, deve tollerare la variabilità delle funzionalità e fornire un'interfaccia utente flessibile che si adatti a diverse configurazioni dello schermo.

Per facilitare la compatibilità con i dispositivi, Android fornisce un framework per app dinamico in cui puoi fornire risorse app specifiche per la configurazione in file statici, come layout XML diversi per dimensioni dello schermo diverse. Android carica quindi le risorse appropriate in base alla configurazione attuale del dispositivo. Con un design premeditato e risorse aggiuntive, puoi pubblicare un singolo pacchetto di applicazioni (APK) che ottimizza l'esperienza utente su una serie di dispositivi.

Tuttavia, se necessario, puoi specificare i requisiti delle funzionalità della tua app e controllare i tipi di dispositivi che possono installarla dal Google Play Store. Questo documento spiega come puoi controllare quali dispositivi hanno accesso alle tue app e come prepararle per raggiungere il pubblico giusto.

Che cosa significa "compatibilità"?

Per quanto riguarda lo sviluppo Android, esistono due tipi di compatibilità: compatibilità dei dispositivi e compatibilità delle app.

Poiché Android è un progetto open source, qualsiasi produttore di hardware può sviluppare un dispositivo che esegue il sistema operativo Android. Tuttavia, un dispositivo è "compatibile con Android" solo se può eseguire correttamente le app scritte per l'ambiente di esecuzione Android. I dettagli esatti dell'ambiente di esecuzione Android sono definiti dal Programma di compatibilità Android. Ogni dispositivo deve superare la Compatibility Test Suite (CTS) per essere considerato compatibile.

In qualità di sviluppatore di app, non devi preoccuparti se un dispositivo è compatibile con Android, perché solo i dispositivi compatibili con Android includono il Google Play Store. Pertanto, se un utente installa la tua app dal Google Play Store, significa che utilizza un dispositivo compatibile con Android.

Tuttavia, devi valutare se la tua app è compatibile con ogni potenziale configurazione del dispositivo. Poiché Android viene eseguito su un'ampia gamma di configurazioni di dispositivi, alcune funzionalità non sono disponibili su tutti i dispositivi. Ad esempio, alcuni dispositivi potrebbero non includere un sensore per la bussola. Se la funzionalità di base dell'app richiede un sensore per la bussola, l'app è compatibile solo con i dispositivi che includono questa funzionalità.

Controllare la disponibilità dell'app sui dispositivi

Android supporta una serie di funzionalità che la tua app può sfruttare tramite le API di piattaforma. Alcune funzionalità si basano sull'hardware, ad esempio un sensore bussola, altre su software, ad esempio i widget delle app, e altre ancora dipendono dalla versione della piattaforma. Non tutti i dispositivi supportano tutte le funzionalità, pertanto potresti dover controllare la disponibilità della tua app sui dispositivi in base alle funzionalità richieste.

Per ottenere la base di utenti più ampia possibile per la tua app, supporta il maggior numero possibile di configurazioni dispositivo utilizzando un singolo APK o AAB. Nella maggior parte dei casi, puoi farlo disattivando le funzionalità facoltative in fase di esecuzione e fornendo alle risorse dell'app alternative per configurazioni diverse, ad esempio diversi layout per dimensioni dello schermo diverse. Se necessario, puoi limitare la disponibilità della tua app a determinati dispositivi tramite il Google Play Store in base alle seguenti caratteristiche del dispositivo:

Funzionalità del dispositivo

Per gestire la disponibilità della tua app in base alle funzionalità del dispositivo, Android definisce ID funzionalità per qualsiasi funzionalità hardware o software che potrebbe non essere disponibile su tutti i dispositivi. Ad esempio, l'ID funzionalità per il sensore bussola èFEATURE_SENSOR_COMPASS, mentre l'ID funzionalità per i widget dell'app èFEATURE_APP_WIDGETS.

Se necessario, puoi impedire agli utenti di installare la tua app quando i loro dispositivi non forniscono una funzionalità necessaria dichiarando la funzionalità utilizzando un elemento <uses-feature> nel file manifest dell'app.

Ad esempio, se la tua app non ha senso su un dispositivo che non dispone di un sensore per la bussola, puoi dichiarare il sensore come requisito con il seguente tag manifest:

<manifest ... >
    <uses-feature android:name="android.hardware.sensor.compass"
                  android:required="true" />
    ...
</manifest>

Google Play Store confronta le funzionalità richieste dalla tua app con quelle disponibili sul dispositivo di ogni utente per determinare se la tua app è compatibile con ogni dispositivo. Se il dispositivo non dispone di tutte le funzionalità richieste dalla tua app, l'utente non può installarla.

Tuttavia, se la funzionalità principale dell'app non richiede una funzionalità del dispositivo, imposta l'attributo required su "false" e controlla la funzionalità del dispositivo in fase di esecuzione. Se la funzionalità dell'app non è disponibile sul dispositivo attuale, esegui il downgrade della funzionalità corrispondente dell'app. Ad esempio, puoi verificare se una funzionalità è disponibile chiamando hasSystemFeature() come segue:

Kotlin

if (!packageManager.hasSystemFeature(PackageManager.FEATURE_SENSOR_COMPASS)) {
    // This device doesn't have a compass. Turn off the compass feature.
    disableCompassFeature()
}

Java

PackageManager pm = getPackageManager();
if (!pm.hasSystemFeature(PackageManager.FEATURE_SENSOR_COMPASS)) {
    // This device doesn't have a compass. Turn off the compass feature.
    disableCompassFeature();
}

Per informazioni su tutti i filtri che puoi utilizzare per controllare la disponibilità della tua app tramite il Google Play Store, consulta la documentazione relativa ai filtri su Google Play.

Versione piattaforma

Dispositivi diversi potrebbero eseguire versioni diverse della piattaforma Android, ad esempio Android 12 o Android 13. Ogni versione successiva della piattaforma aggiunge spesso API non disponibili nella versione precedente. Per indicare l'insieme di API disponibili, ogni versione della piattaforma specifica un livello API. Ad esempio, Android 12 è il livello API 31 e Android 13 è il livello API 33.

Devi specificare i valori minSdkVersion e targetSdkVersion nel file build.gradle:

Kotlin

android {
    defaultConfig {
        applicationId = "com.example.myapp"

        // Defines the minimum API level required to run the app.
        minSdkVersion(30)

        // Specifies the API level used to test the app.
        targetSdkVersion(33)
        ...
    }
}

Groovy

android {
    defaultConfig {
        applicationId 'com.example.myapp'

        // Defines the minimum API level required to run the app.
        minSdkVersion 30

        // Specifies the API level used to test the app.
        targetSdkVersion 33
        ...
    }
}

Per ulteriori informazioni sul file build.gradle, consulta Configurare la compilazione.

Ogni versione successiva di Android garantisce la compatibilità per le app create utilizzando le API delle versioni precedenti della piattaforma, pertanto la tua app è compatibile con le versioni future di Android pur utilizzando le API Android documentate.

Tuttavia, se la tua app utilizza API aggiunte in una versione della piattaforma più recente, ma non le richiede per la sua funzionalità principale, controlla il livello API in fase di esecuzione e esegui il downgrade delle funzionalità corrispondenti quando il livello API è troppo basso. In questo caso, imposta minSdkVersion sul valore minimo possibile per la funzionalità principale della tua app, quindi confronta la versione corrente del sistema, SDK_INT, con la costante del nome in codice in Build.VERSION_CODES che corrisponde al livello API che vuoi controllare, come mostrato nell'esempio seguente:

Kotlin

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) {
    // Running on something older than API level 11, so disable
    // the drag and drop features that use ClipboardManager APIs.
    disableDragAndDrop()
}

Java

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) {
    // Running on something older than API level 11, so disable
    // the drag and drop features that use ClipboardManager APIs.
    disableDragAndDrop();
}

Configurazione dello schermo

Android viene eseguito su dispositivi di varie dimensioni, come telefoni, tablet e TV. Per categorizzare i dispositivi in base al tipo di schermo, Android definisce due caratteristiche per ogni dispositivo: dimensioni dello schermo (le dimensioni fisiche dello schermo) e densità dello schermo (la densità fisica dei pixel sullo schermo, nota come DPI). Per semplificare le diverse configurazioni, Android generalizza queste varianti in gruppi che ne semplificano il targeting:

  • Quattro dimensioni generiche: piccola, normale, grande ed extra grande
  • Diverse densità generalizzate: mdpi (media), hdpi (alta), xhdpi (extra alta), xxhdpi (extra extra alta) e altre

Per impostazione predefinita, la tua app è compatibile con tutte le dimensioni e le densità dello schermo, poiché il sistema apporta le modifiche necessarie al layout dell'interfaccia utente e alle risorse immagine per ogni schermo. Fornisci immagini bitmap ottimizzate per le densità dello schermo comuni.

Ottimizza l'esperienza utente utilizzando il più possibile layout flessibili. Se sono presenti layout per modifiche di configurazione significative, ad esempio ritratto e paesaggio o dimensioni delle finestre grandi e piccole, valuta la possibilità di fornire layout alternativi flessibili per modifiche più piccole della configurazione. In questo modo, viene migliorata l'esperienza utente su fattori di forma come tablet, smartphone e dispositivi pieghevoli. È utile anche quando le finestre cambiano dimensione in modalità multi-finestra.

Per informazioni su come creare risorse alternative per schermi diversi e su come limitare l'app a determinate dimensioni dello schermo, se necessario, consulta la panoramica della compatibilità con lo schermo e le linee guida per la qualità delle app per schermi di grandi dimensioni.

Controllare la disponibilità dell'app per motivi commerciali

Oltre a limitare la disponibilità della tua app in base alle caratteristiche del dispositivo, potresti dover limitare la disponibilità della tua app per motivi commerciali o legali. Per questo tipo di situazione, il Google Play Store fornisce opzioni di filtro in Play Console che ti consentono di controllare la disponibilità della tua app per motivi non tecnici, come le impostazioni internazionali dell'utente o l'operatore wireless.

I filtri per la compatibilità tecnica, ad esempio i componenti hardware richiesti, si basano sempre sulle informazioni contenute nel file APK o AAB. Tuttavia, i filtri per motivi non tecnici, come la località geografica, vengono sempre gestiti in Google Play Console.

Altre risorse:

Panoramica delle risorse dell'app
Informazioni su come le app Android sono strutturate per separare le risorse dell'app dal codice dell'app, incluso come puoi fornire risorse alternative per configurazioni specifiche del dispositivo.
Filtri su Google Play
Informazioni sui diversi modi in cui il Google Play Store può impedire l'installazione della tua app su dispositivi diversi.
Autorizzazioni su Android
In che modo Android limita l'accesso delle app ad alcune API con un sistema di autorizzazioni che richiede il consenso dell'utente per l'utilizzo di queste API da parte dell'app.