Panoramica della compatibilità dei dispositivi

Android è progettato per funzionare su tanti dispositivi, come telefoni, tablet e televisori. La gamma di dispositivi offre un enorme potenziale di pubblico 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 garantire la compatibilità dei dispositivi, Android fornisce un framework dinamico dell'app in cui puoi fornire risorse per le app specifiche per la configurazione in file statici, ad esempio layout XML diversi per dimensioni dello schermo diverse. Android carica quindi le risorse appropriate in base alla configurazione attuale del dispositivo. Tenendo conto del design della tua app e di ulteriori risorse per l'app, puoi pubblicare un singolo pacchetto dell'applicazione (APK) che ottimizza l'esperienza utente su una varietà di dispositivi.

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

Cosa significa "compatibilità"?

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

Poiché Android è un progetto open source, qualsiasi produttore di hardware può creare un dispositivo che esegue il sistema operativo Android. Tuttavia, un dispositivo è "compatibile con Android" solo se è in grado di 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. Per essere considerato compatibile, ogni dispositivo deve superare la Compatibility Test Suite (CTS).

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

Tuttavia, devi valutare se la tua app è compatibile con ogni potenziale configurazione del dispositivo. Android viene eseguito su un'ampia gamma di configurazioni dispositivo, pertanto 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 soltanto 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 della piattaforma. Alcune funzionalità sono basate sull'hardware, ad esempio il sensore per la bussola; altre sono basate su software, ad esempio i widget di app, e altre dipendono dalla versione della piattaforma. Non tutti i dispositivi supportano tutte le funzionalità, pertanto potrebbe essere necessario controllare la disponibilità dell'app per i dispositivi in base alle funzionalità richieste per l'app.

Per ottenere la più ampia base utenti possibile per la tua app, supporta il maggior numero possibile di configurazioni di dispositivi utilizzando un singolo APK o AAB. Nella maggior parte dei casi, puoi farlo disattivando le funzionalità facoltative in fase di runtime e fornendo le risorse dell'app con alternative per configurazioni diverse, ad esempio layout diversi per schermi di dimensioni 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à dell'app in base alle funzionalità del dispositivo, Android definisce gli 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 della bussola è FEATURE_SENSOR_COMPASS e l'ID funzionalità per i widget dell'app è FEATURE_APP_WIDGETS.

Se necessario, puoi impedire agli utenti di installare la tua app se 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 privo di 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>

Il Google Play Store confronta le funzionalità richieste dalla tua app con le funzionalità 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ò installare l'app.

Tuttavia, se la funzionalità principale dell'app non richiede una funzionalità del dispositivo, imposta l'attributo required su "false" e verifica la presenza della funzionalità del dispositivo in fase di runtime. Se la funzionalità dell'app non è disponibile sul dispositivo attuale, riduci in modo controllato la funzionalità dell'app corrispondente. Ad esempio, puoi chiedere 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. A ogni versione successiva della piattaforma spesso vengono aggiunte API non disponibili nella versione precedente. Per indicare i set 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)
        ...
    }
}

trendy

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 maggiori informazioni sul file build.gradle, consulta Configurare la build.

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

Tuttavia, se la tua app utilizza API aggiunte in una versione più recente della piattaforma, ma non le richiede per la sua funzionalità principale, controlla il livello API in fase di runtime e riduci in modo controllato le funzionalità corrispondenti quando il livello API è troppo basso. In questo caso, imposta minSdkVersion sul valore più basso possibile per la funzionalità principale dell'app, quindi confronta la versione del sistema attuale, 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 che segue:

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 schermo

Android viene eseguito su dispositivi di varie dimensioni, ad esempio telefoni, tablet e TV. Per classificare i dispositivi in base al tipo di schermo, Android definisce due caratteristiche per ciascun dispositivo: le dimensioni dello schermo (le dimensioni fisiche dello schermo) e la 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 le rendono più facili da scegliere come target:

  • Quattro dimensioni generalizzate: small, normal, large e xlarge
  • Diverse densità generalizzate: mdpi (medio), hdpi (alto), xhdpi (molto alto), xxhdpi (molto-molto alto) e altre

Per impostazione predefinita, la tua app è compatibile con tutte le dimensioni e le densità degli schermi, perché il sistema apporta modifiche al layout dell'interfaccia utente e alle risorse di immagine come necessario per ogni schermata. Fornisci immagini bitmap ottimizzate per le densità dello schermo più comuni.

Ottimizza l'esperienza utente utilizzando il più possibile layout flessibili. Qualora siano presenti layout per modifiche di configurazione di grandi dimensioni, ad esempio verticale e orizzontale, o per finestre di dimensioni grandi o piccole, valuta la possibilità di fornire layout alternativi che siano flessibili per le modifiche più piccole nella configurazione. Ciò migliora l'esperienza utente su fattori di forma come tablet, smartphone e pieghevoli. È utile anche quando le dimensioni delle finestre cambiano in modalità multi-finestra.

Per informazioni su come creare risorse alternative per schermi diversi e su come limitare la tua app a determinate dimensioni dello schermo quando necessario, leggi la panoramica sulla compatibilità dello schermo e le norme sulla qualità delle app per schermi grandi.

Controllare la disponibilità dell'app per motivi aziendali

Oltre a limitare la disponibilità dell'app in base alle caratteristiche del dispositivo, potresti dover limitare la disponibilità dell'app per motivi aziendali o legali. In questo tipo di situazione, il Google Play Store offre opzioni di filtro in Play Console che ti consentono di controllare la disponibilità della tua app per motivi non tecnici, ad esempio 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, il filtro per motivi non tecnici, come l'area geografica viene sempre gestito in Google Play Console.

Altre risorse:

Panoramica delle risorse per le app
Informazioni su come le app per Android sono strutturate per separare le risorse dell'app dal codice dell'app, incluso come puoi fornire risorse alternative per configurazioni dispositivo specifiche.
Filtri su Google Play
Informazioni sui diversi modi in cui 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 a determinate API con un sistema di autorizzazioni che richiede il consenso dell'utente per l'utilizzo di queste API da parte della tua app.