Proprietà della versione dell'SDK Android

Le app per Android possono impostare una serie di proprietà della versione dell'SDK build.gradle. La documentazione per Android build.gradle spiega cosa queste proprietà rappresentano l'applicazione in generale. Questo documento spiega come queste proprietà influiscono sulle build NDK.

compileSdkVersion

Questa proprietà non ha effetto sulle build NDK. La disponibilità dell'API per l'NDK è regolata invece da minSdkVersion. Questo perché i simboli C++ sono risolti in fase di caricamento della libreria anziché rallentati alla prima chiamata (come sono in Java). Utilizzare simboli non disponibili nel minSdkVersion causerà il mancato caricamento della libreria sulle versioni del sistema operativo che non dispongono della nuova API, indipendentemente dal fatto che vengano chiamate o meno.

Per una nuova app, scegli la versione più recente disponibile. Per un'app esistente, aggiorna all'ultima versione quando ti è più comodo.

VersioneSdk target

Come per Java, l'elemento targetSdkVersion della tua app può modificare il runtime comportamento del codice nativo. I cambiamenti di comportamento nel sistema sono, quando fattibile, solo applicata alle app con targetSdkVersion superiore o uguale al sistema operativo che ha introdotto la modifica.

Per una nuova app, scegli la versione più recente disponibile. Per un'app esistente, aggiorna all'ultima versione quando opportuno (dopo aver aggiornato compileSdkVersion).

Gli sviluppatori di applicazioni in genere conoscono il targetSdkVersion della loro app, L'API è utile per gli sviluppatori di librerie che non possono sapere quali targetSdkVersion sarà la scelta degli utenti.

In fase di runtime, puoi ottenere il valore targetSdkVersion utilizzato da un'applicazione chiamando android_get_application_target_sdk_version(). Questa API è disponibile in API livello 24 e successivi. Questa funzione ha la seguente firma:

/**
 * Returns the `targetSdkVersion` of the caller, or `__ANDROID_API_FUTURE__` if
 * there is no known target SDK version (for code not running in the context of
 * an app).
 *
 * The returned values correspond to the named constants in `<android/api-level.h>`,
 * and is equivalent to the AndroidManifest.xml `targetSdkVersion`.
 *
 * See also android_get_device_api_level().
 *
 * Available since API level 24.
 */
int android_get_application_target_sdk_version() __INTRODUCED_IN(24);

Altre modifiche del comportamento potrebbero dipendere dal livello API del dispositivo. Puoi ottenere l'API livello del dispositivo su cui è in esecuzione la tua applicazione chiamando android_get_device_api_level(). Questa funzione ha la seguente firma:

/**
 * Returns the API level of the device we're actually running on, or -1 on failure.
 * The returned values correspond to the named constants in `<android/api-level.h>`,
 * and is equivalent to the Java `Build.VERSION.SDK_INT` API.
 *
 * See also android_get_application_target_sdk_version().
 */
int android_get_device_api_level();

versione maxSdk

Questa proprietà non ha effetto sulle build NDK.

Versione minSdk

Il set di minSdkVersion nel file build.gradle determina quali API sono disponibile al momento della build (vedi compileSdkVersion per capire le ragioni della differenza da build Java) e determina la versione minima del sistema operativo che il tuo codice con cui sarà compatibile.

minSdkVersion viene utilizzato dall'NDK per determinare quali funzionalità possono essere usate durante la compilazione del codice. Ad esempio, questa proprietà determina quale FORTIFY le funzionalità vengono usate in libc e possono anche consentire miglioramenti delle prestazioni o delle dimensioni (come GNU hash o RELR) per i tuoi file binari non compatibili con versioni precedenti di Android. Anche se non utilizzi nuove API, questa proprietà regola comunque la versione minima del sistema operativo supportata del tuo codice.

Avviso: la tua app potrebbe funzionare su dispositivi meno recenti anche se le tue librerie native sono create con una versione più recente di minSdkVersion. Non fare affidamento su questo comportamento. È il suo funzionamento potrebbe non essere garantito su altre versioni NDK, versioni del sistema operativo o singoli dispositivi.

Per una nuova app, visualizza i dati sulla distribuzione degli utenti nel Nuovo progetto di Android Studio guidata o sul sito apilevels.com. Scegli il saldo tra la potenziale quota di mercato e i costi di manutenzione. Più basso è il valore di minSdkVersion, più tempo dedicherai a risolvere i vecchi bug e ad aggiungere comportamenti di fallback per le funzionalità non ancora implementate.

Per un'app esistente, aumenta il minSdkVersion ogni volta che i livelli API precedenti non sono vale la pena prolungare i costi di manutenzione o se i tuoi utenti lo richiedono vale la pena sostenere i nuovi costi di manutenzione. Play Console offre metriche specifiche per il tuo la distribuzione utenti dell'app.

Nota: l'NDK ha il proprio valore minSdkVersion definito in <NDK>/meta/platforms.json, Si tratta del livello API più basso supportato dall'NDK. Non impostare il valore minSdkVersion dell'app su un valore inferiore a questo valore. Google Play potrebbe consentire alla tua app sui dispositivi meno recenti, ma il tuo codice NDK potrebbe non funzionare.

Il valore minSdkVersion della tua applicazione viene messo a disposizione del pre-responsabile tramite la macro __ANDROID_MIN_SDK_VERSION__ (la versione __ANDROID_API__ precedente è identici, ma preferiscono il primo perché il suo significato è più chiaro). Questa macro è definiti automaticamente da Clang, quindi non è necessario includere intestazione per utilizzarlo. Per build NDK, questa macro è sempre definita.