Guida introduttiva ad Android Jetpack

Jetpack comprende una raccolta di librerie Android che incorporano le best practice e forniscono la compatibilità con le versioni precedenti nelle tue app per Android.

La guida all'architettura delle app di Jetpack fornisce una panoramica delle best practice e dell'architettura consigliata da prendere in considerazione durante la creazione della tua app per Android.

Le sezioni seguenti spiegano come iniziare a utilizzare i componenti Jetpack.

Utilizza una libreria Jetpack nella tua app

Tutti i componenti Jetpack sono disponibili nel repository Maven di Google.

Apri il file settings.gradle e aggiungi il repository google() nel blocco dependencyResolutionManagement { repositories {...}} come mostrato di seguito:

Alla moda

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        jcenter()
    }
}

Kotlin

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        jcenter()
    }
}

Puoi quindi aggiungere componenti Jetpack, come i componenti dell'architettura come LiveData e ViewModel, nel file build.gradle del tuo modulo, come mostrato qui:

Alla moda

dependencies {
    def lifecycle_version = "2.2.0"

    implementation "androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version"
    implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"
    ...
}

Kotlin

dependencies {
    val lifecycle_version = "2.2.0"

    implementation("androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version")
    implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version")
    ...
}

Molte librerie Jetpack forniscono estensioni Android KTX, come mostrato sopra con lifecycle-livedata-ktx e lifecycle-viewmodel-ktx. Le estensioni KTX si basano sull'API basata su Java, sfruttando le funzionalità del linguaggio specifiche di Kotlin.

Per scoprire le nuove release della libreria Jetpack, consulta la pagina Release.

Le pagine di riferimento API basate su Kotlin e basate su Java sono disponibili per tutte le librerie Jetpack.

(Facoltativo) Verifica le dipendenze di Jetpack

A partire da giugno 2023, il team di Jetpack firma le librerie Jetpack. Queste firme consentono agli sviluppatori di verificare che gli artefatti della libreria siano creati e firmati da Google. Una libreria è idonea per la verifica della firma una volta che pubblica un aggiornamento.

Se nel tuo progetto Android è abilitata la verifica della firma, segui questi passaggi per verificare le dipendenze di Jetpack nel progetto Gradle:

  1. Aggiungi le chiavi attendibili di Google alla sezione <trusted-keys> in $PROJECT_ROOT/gradle/verification-metadata.xml:

    <trusted-keys>
        <trusted-key id="8461efa0e74abae010de66994eb27db2a3b88b8b">
            ...
        </trusted-key>
        <trusted-key id="a5f483cd733a4ebaea378b2ae88979fb9b30acf2">
            ...
        </trusted-key>
        <trusted-key id="0f06ff86beeaf4e71866ee5232ee5355a6bc6e42">
            ...
        </trusted-key>
        <trusted-key id="0e225917414670f4442c250dfd533c07c264648f">
            ...
        </trusted-key>
        ...
    </trusted-keys>
    
  2. Aggiungi una voce <trusting group> per ogni libreria utilizzata dal progetto. Ecco un esempio per le librerie androidx.fragment e androidx.emoji2:

    <trusted-keys>
        <trusted-key id="8461efa0e74abae010de66994eb27db2a3b88b8b">
            <trusting group="androidx.fragment"/>
            <trusting group="androidx.emoji2"/>
        </trusted-key>
        <trusted-key id="a5f483cd733a4ebaea378b2ae88979fb9b30acf2">
            <trusting group="androidx.fragment"/>
            <trusting group="androidx.emoji2"/>
        </trusted-key>
        ...
    </trusted-keys>
    

Per problemi relativi alla verifica delle dipendenze, consulta la guida di Gradle sulla risoluzione dei problemi di verifica delle dipendenze.

Infine, i dettagli sulla nostra chiave attendibile possono essere visualizzati sul sito del server di chiavi di Ubuntu.

Sfrutta Jetpack

Le librerie Jetpack possono essere utilizzate singolarmente o in combinazione per soddisfare diverse esigenze nelle tue app.

  • WorkManager per le tue esigenze di pianificazione in background.
  • Room per la persistenza dell'archiviazione dei dati.
  • Navigazione per gestire il flusso di navigazione dell'applicazione.
  • CameraX per le esigenze della tua app Fotocamera.
  • Consulta la panoramica di tutte le librerie Jetpack.

Le librerie Jetpack sono pubblicate nello spazio dei nomi androidx. Se il tuo progetto utilizza attualmente la Android Support Library, scopri come eseguire la migrazione allo spazio dei nomi androidx.

Per scoprire di più sull'utilizzo di Jetpack, consulta queste pagine:

Risorse aggiuntive

Formazione online

Codice di esempio

  • L'app demo Sunflower utilizza molti componenti Jetpack diversi per mostrare le best practice di sviluppo Android.

Video