Panoramica della compatibilità dei dispositivi

Android è progettato per essere eseguito su molti dispositivi diversi, come smartphone, tablet e televisori. La gamma di dispositivi offre un enorme potenziale pubblico della tua app. Affinché la tua app abbia successo su tutti i dispositivi, deve tollera la variabilità delle caratteristiche e fornisce un'interfaccia utente flessibile che si adatta configurazioni dello schermo diverse.

Per facilitare la compatibilità con i dispositivi, Android fornisce un framework di app dinamico in cui puoi fornire impostazioni risorse per app in formato statico ad esempio layout XML diversi per schermi di dimensioni differenti. Android carica quindi le risorse appropriate in base alla configurazione attuale del dispositivo. Con più consapevole del design della tua app e di altre risorse per l'app, puoi pubblicare un un singolo pacchetto per applicazioni (APK) che ottimizza l'esperienza utente su una serie di dispositivi.

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

Cosa significa "compatibilità" media?

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

Poiché Android è un progetto open source, qualsiasi produttore di hardware può per creare un dispositivo con sistema operativo Android. Ma un dispositivo è "Compatibile con Android" solo se è in grado di eseguire correttamente le app scritte per Ambiente di esecuzione Android. I dettagli esatti dell'app dell'ambiente di esecuzione sono definite Android di compatibilità. Ciascun dispositivo deve superare il Compatibility Test Suite (CTS) per essere considerata 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 la potenziale configurazione del dispositivo. Android funziona su un'ampia gamma 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 per i dispositivi

Android supporta una serie di funzionalità che la tua app può sfruttare tramite la piattaforma su quelle di livello inferiore. Alcune funzionalità si basano sull'hardware, ad esempio un sensore per la 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 disabilitare le funzionalità facoltative in fase di runtime app fornitrice di risorse con alternative per diverse configurazioni, ad esempio per schermi di diverse dimensioni. Se necessario, puoi limitare le funzionalità dell'app la disponibilità per determinati dispositivi tramite il Google Play Store in base ai seguenti fattori: 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 elemento per il sensore della bussola è FEATURE_SENSOR_COMPASS, e l'ID funzione per i widget delle app è FEATURE_APP_WIDGETS.

Se necessario, puoi impedire agli utenti di installare la tua app quando dispositivi non forniscono una funzionalità necessaria dichiarandola tramite un <uses-feature> nell'interfaccia utente file manifest.

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>

Il Google Play Store confronta le funzionalità richieste dalla tua app con disponibili sul dispositivo di ogni utente per determinare se la tua app è compatibili con ciascun 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, riduci temporaneamente la funzionalità dell'app corrispondente. Ad esempio, puoi verificare se una funzionalità è disponibile chiamandohasSystemFeature()come segue:

KotlinJava
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 il Google Play Store, controlla Filtri su Google Play documentazione.

Versione piattaforma

Dispositivi diversi potrebbero eseguire versioni diverse della piattaforma Android, ad esempio ad esempio Android 12 o Android 13. Ogni versione successiva della piattaforma aggiunge spesso API non disponibili nella versione precedente. Per indicare a quale insieme di API disponibile, ogni versione della piattaforma specifica 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(33)
        ...
    }
}
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 l'app utilizza API aggiunte in una versione più recente della piattaforma, ma non li richiede per la sua funzionalità principale, controlla il livello API all'indirizzo il runtime e riduci in modo controllato le funzionalità corrispondenti quando il livello API troppo basso. In questo caso, imposta minSdkVersion sul valore più basso possibili per la funzionalità principale dell'app, poi confronta la configurazione attuale o la versione precedente, SDK_INT, alla costante del nome in codice Build.VERSION_CODES che corrisponde al livello API che vuoi controllare, come mostrato di seguito esempio:

KotlinJava
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 schermo

Android funziona 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 generalizzate: piccolo, normale, grande e xlarge
  • Varie densità generalizzate: mdpi (media), hdpi (alta), xhdpi (extra elevata), xxhdpi (molto elevata) e altre

Per impostazione predefinita, l'app è compatibile con schermi di tutte le dimensioni e densità. perché il sistema apporta modifiche al layout dell'interfaccia utente e alle risorse delle immagini necessario per ogni schermata. Fornisci immagini bitmap ottimizzate per schermate comuni delle densità.

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. Ciò migliora l'esperienza utente su fattori di forma come tablet, smartphone e pieghevoli. it è 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 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 lingua geografica, vengono sempre gestiti in Google Play Console.

Altre risorse:

Panoramica delle risorse per app
Informazioni su come le app per Android sono strutturate in modo da separare le app risorse dal codice dell'app, incluso come fornire alternative per configurazioni specifiche del dispositivo.
Filtri su Google Play
Informazioni sui diversi modi in cui Google Play Store può impedire che i tuoi di installare l'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 utilizzi queste API.