Panoramica della compatibilità dei dispositivi

Android è progettato per essere eseguito su molti dispositivi diversi, come smartphone, tablet e TV. La 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 alle diverse configurazioni dello schermo.

Per facilitare la compatibilità dei dispositivi, Android fornisce un framework di app dinamico in cui puoi fornire risorse dell'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 dispositivo attuale. Se pianifichi con attenzione il design della tua app e le risorse aggiuntive, puoi pubblicare un singolo pacchetto dell'applicazione (APK) che ottimizza l'esperienza utente su una varietà di dispositivi.

Se necessario, puoi specificare i requisiti delle funzionalità della tua app e controllare quali tipi di dispositivi possono installare la tua app da Google Play Store. Questo documento spiega come 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ò creare 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. Per essere considerato compatibile, ogni dispositivo deve superare il Compatibility Test Suite (CTS).

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

Tuttavia, devi considerare se la tua app è compatibile con ogni potenziale configurazione 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à.

Controlla la disponibilità dell'app per i dispositivi

Android supporta una serie di funzionalità che la tua app può sfruttare tramite le API della piattaforma. Alcune funzionalità sono basate sull'hardware, come un sensore per la bussola; alcune sono basate sul software, come i widget delle app; altre dipendono dalla versione della piattaforma. Non tutti i dispositivi supportano tutte le funzionalità, quindi potresti dover controllare la disponibilità della tua app per i dispositivi in base alle funzionalità richieste dall'app.

Per raggiungere la base utenti più ampia 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 risorse dell'app con alternative per configurazioni diverse, ad esempio layout diversi per dimensioni dello schermo diverse. Se necessario, puoi limitare la disponibilità della tua app a determinati dispositivi tramite Google Play Store in base alle seguenti caratteristiche del dispositivo:

• Funzionalità del dispositivo
• Versione della piattaforma
• Configurazione dello schermo

Funzionalità del dispositivo

Per gestire la disponibilità della tua 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, mentre l'ID funzionalità per i widget delle app è FEATURE_APP_WIDGETS.

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

Ad esempio, se la tua app non ha senso su un dispositivo privo di un sensore bussola, puoi dichiarare il sensore bussola 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 l'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 della tua app non richiede una funzionalità del dispositivo, imposta l'attributo required su "false" e verifica la funzionalità del dispositivo in fase di runtime. Se la funzionalità dell'app non è disponibile sul dispositivo corrente, esegui la riduzione controllata della funzionalità dell'app corrispondente. Ad esempio, puoi verificare se una funzionalità è disponibile chiamando hasSystemFeature() in questo modo:

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

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 Google Play Store, consulta la documentazione relativa ai filtri su Google Play.

Versione della piattaforma

Dispositivi diversi potrebbero eseguire versioni diverse della piattaforma Android, ad esempio Android 12 o Android 13. Ogni versione successiva della piattaforma spesso aggiunge API non disponibili nella versione precedente. Per indicare quale insieme di API è disponibile, 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:

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(36)
        ...
    }
}

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 36
        ...
    }
}

Per ulteriori informazioni sul file build.gradle, leggi Configura la build.

Ogni versione successiva di Android offre 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 se utilizzi 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 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 della tua 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 seguente:

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()
}

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 smartphone, tablet e TV. Per classificare i dispositivi in base al tipo di schermo, Android definisce due caratteristiche per ogni 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 ne facilitano il targeting:

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

Per impostazione predefinita, la tua app è compatibile con tutte le dimensioni e le densità dello schermo, perché il sistema apporta le modifiche necessarie al layout UI 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 importanti, come l'orientamento verticale e orizzontale o dimensioni della finestra grandi e piccole, valuta la possibilità di fornire layout alternativi flessibili per modifiche di configurazione più piccole. In questo modo, l'esperienza utente migliora su fattori di forma come tablet, smartphone e pieghevoli. Inoltre, è utile quando le finestre cambiano dimensioni 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, leggi la panoramica sulla compatibilità dello schermo e consulta le norme sulla qualità delle app per schermi grandi.

Controlla la disponibilità dell'app per motivi commerciali

Oltre a limitare la disponibilità della tua app in base alle caratteristiche del dispositivo, potresti doverla limitare per motivi commerciali o legali. Per questo tipo di situazione, 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.

Il filtro per la compatibilità tecnica, ad esempio i componenti hardware richiesti, si basa sempre sulle informazioni contenute nel file APK o AAB. Tuttavia, il filtro per motivi non tecnici, ad esempio la località geografica, viene sempre gestito in Google Play Console.

Altre risorse:

Panoramica delle risorse dell'app

Informazioni su come sono strutturate le app per Android per separare le risorse dell'app dal relativo codice, incluso come fornire risorse alternative per configurazioni specifiche del dispositivo.

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 affinché la tua app possa utilizzare queste API.