Creazione di app Java per Android

  • Articolo

Importante

Visual Studio App Center è previsto per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate che è possibile considerare la migrazione a.

Altre informazioni sulle sequenze temporali di supporto e sulle alternative.

Per compilare la prima app Android, seguire questa procedura:

  1. Connettersi all'account del servizio repository (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Selezionare un repository e un ramo in cui risiede l'app.
  3. Scegliere il progetto Android da compilare.
  4. Configurare la prima compilazione.

Nota

Per l'esecuzione dell'app in un dispositivo reale, la compilazione deve essere firmata con un certificato valido.

Nota

App Center tiene traccia del progetto cercando i file di directory gradle (e gradlew) del progetto Android. Non includere questi file nel progetto .gitignore come Build di App Center non sarà in grado di trovarli.

Avviso

A causa dell'arresto recente di JCenter, alcune app potrebbero riscontrare errori di attività Gradle durante la compilazione con App Center. Visualizzare la guida alla migrazione fornita da Gradle. Come soluzione alternativa, tutte le istanze di jcenter() possono essere rimosse dal build.gradle file e sostituite con jcenter { url "http://jcenter.bintray.com/"}. Altre informazioni sull'arresto di JCenter sono disponibili qui.

1. Collegamento del repository

È necessario connettersi all'account del servizio repository se non è già stato eseguito. Dopo la connessione dell'account, selezionare il repository in cui si trova il progetto Android. Per configurare una compilazione per un repository, è necessaria l'autorizzazione di amministratore e pull.

2. Selezione di un ramo

Dopo aver selezionato un repository, selezionare il ramo da compilare. Per impostazione predefinita, tutti i rami attivi verranno elencati.

3. Configurazione della prima compilazione

Prima della prima compilazione, il progetto Android deve essere configurato.

3.1. Trigger di compilazione

Per impostazione predefinita, viene attivata una nuova compilazione ogni volta che uno sviluppatore esegue il push in un ramo configurato. Si tratta di "Integrazione continua". Se si preferisce attivare manualmente una nuova compilazione, è possibile modificare questa impostazione nel riquadro di configurazione.

3.2. Variante di compilazione

Le varianti di compilazione disponibili verranno popolate dai tipi di compilazione e dai sapori del prodotto specificati nel file build.gradle (livello di app). Selezionare quale variante di compilazione deve essere compilata.

Nota

La compilazione di App Center supporta la ricerca di varianti di compilazione come combinazione di un tipo di compilazione (debug, versione o definita personalizzata) e uno dei tipi di prodotto dichiarati gradle. Il rilevamento delle dimensioni del sapore (combinazioni di più sapori del prodotto) non è supportato in questo momento.

3.3. Compilare il bundle di app Android (.aab)

Il bundle di app Android è un formato di distribuzione caricato in Play Store e usato per generare SDK ottimizzati per dispositivi specifici. Per altre informazioni sul bundle di app Android, vedere la documentazione ufficiale di Android.

Attivare l'opzione per Il bundle di app Android per produrre un .aab oggetto oltre a .apk. Se il file (livello di app) contiene il android.bundlebuild.gradle blocco, questa opzione sarà già attiva.

3.4. Numero di versione di incremento

Se abilitato, il codice della versione nel AndroidManifest.xml dell'app aumenta automaticamente per ogni compilazione. La modifica avviene durante la compilazione effettiva e non verrà eseguito il commit nel repository.

3.5. Firma del codice

Una compilazione completata produrrà un .apk file e un file aggiuntivo .aab se abilitato. Per rilasciare la compilazione in Play Store, deve essere firmata con un certificato valido archiviato in un archivio chiavi. Per firmare le compilazioni prodotte da un ramo, abilitare l'accesso al codice nel riquadro di configurazione, caricare l'archivio chiavi nel repository e fornire le credenziali pertinenti nel riquadro di configurazione. Per altre informazioni sull'accesso al codice, vedere la documentazione di firma del codice Android di App Center. L'oggetto .aab verrà firmato usando le stesse credenziali dell'oggetto .apk.

3.6. Avviare la compilazione riuscita in un dispositivo reale

Usare il file APK appena prodotto per testare se l'app inizia su un dispositivo reale. Ciò aggiunge circa 10 minuti al tempo di compilazione totale. Altre informazioni su come configurare i test di avvio.

3.7. Configurare dal file build.gradle (livello di app)

Le informazioni specifiche sulla compilazione verranno raccolte dal file Gradle, incluse le dipendenze, la versione degli strumenti di compilazione, i tipi di compilazione e i tipi di prodotto.

3.8. Distribuire la compilazione

È possibile configurare ogni compilazione riuscita da un ramo da distribuire a un gruppo di distribuzione creato in precedenza o a una destinazione dell'archivio. È possibile aggiungere un nuovo gruppo di distribuzione o configurare una connessione all'archivio dall'interno del servizio Distribuisci. Esiste sempre un gruppo di distribuzione predefinito denominato "Collaboratori" che include tutti gli utenti che hanno accesso all'app.

Nota

Se si distribuisce in Google Play Store, è preferibile un bundle di app Android (.aab) e verrà distribuito se abilitato. Per i gruppi di distribuzione di App Center e le destinazioni di Intune store, verrà usato un normale .apk anche se viene generato anche un oggetto.aab.

4. Compilare i risultati

Dopo aver attivato una compilazione, può essere in questi stati:

  • accodato : la compilazione si trova in una coda in attesa che le risorse vengano liberate.
  • compilazione : l'app sta creando ed eseguendo attività correlate.
  • completato: la compilazione viene completata correttamente.
  • non riuscito: la compilazione è stata completata, ma non è riuscita. È possibile scaricare ed esaminare il log di compilazione per la risoluzione dei problemi.
  • annullata: la compilazione è stata annullata dall'azione dell'utente oppure è stata annullata.

4.1. Log di compilazione

Per una compilazione completata (riuscita o non riuscita), scaricare i log per altre informazioni su come è andata la compilazione. App Center fornisce un archivio con i file seguenti:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1>
    |-- <build-step-2>
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

I log specifici della compilazione (presenti nella directory di compilazione/ dell'archivio) sono utili per la risoluzione dei problemi e la comprensione del passaggio e del motivo per cui la compilazione non è riuscita.

4.2. Pacchetto dell'app (APK)

L'APK è un pacchetto che contiene l'app e gli asset Android. Se la compilazione è firmata correttamente, l'APK può essere installato in un dispositivo reale e distribuito in Play Store. Se la compilazione non è stata firmata, l'APK può essere eseguito in un emulatore o usato per altri scopi.

4.3. Creazione di più API

Se la configurazione dell'app compila più SDK, è necessario creare anche un APK universale. Il sistema di compilazione funziona con un file APK principale e ignora tutti gli SDK specifici di una determinata densità di CPU ABI o schermo. Per altre informazioni sulle divisioni APK e sulla creazione di un APK universale, leggere la guida alla suddivisione di ABI.

4.4. File di deobfuscation-mapping (mapping.txt)

Il mapping.txt file contiene informazioni su come eseguire il mapping delle tracce dello stack offuscate per l'app fino ai nomi di classe e metodo originali.

  • Se in precedenza si è integrato App Center SDK nell'app con il modulo di creazione di report di arresto anomalo abilitato e si usa Proguard o R8 per minificare e offuscare il file binario dell'app, il servizio di creazione di report di arresto anomalo richiede questo mapping.txt file per visualizzare report di arresto anomalo leggibili (deobfuscated).
  • Se in precedenza è stato integrato un altro SDK per scopi di creazione di report di arresto anomalo nell'app (ad esempio HockeyApp SDK), il servizio corrispondente richiede il mapping.txt file per visualizzare i report di arresto anomalo leggibili.

5. Versioni e requisiti supportati

La versione minima supportata per compilare app Android è 7.0 (livello API 24). Le app Android possono avere un livello di API minimo inferiore necessario per l'esecuzione, ma devono essere destinate almeno al livello API 24.

Le app devono essere compilate con Gradle e il plug-in Android Gradle da configurare correttamente. Il repository deve includere un wrapper Gradle.

Vedere anche: Informazioni sul computer di compilazione cloud