Pubblicare un'app Android per la distribuzione di Google Play

2025-02-25

L'approccio più comune alla distribuzione di app Android agli utenti è tramite Google Play. La prima volta che un'app viene inviata a Google Play, deve essere inviata tramite Google Play Console. Le versioni successive dell'app possono essere inviate tramite Visual Studio. In entrambi i casi, è necessario un account Google Play Developer. Le app inviate a Google Play richiedono l'approvazione da Google.

Per distribuire un'app Android .NET Multipiattaforma (.NET MAUI), è necessario firmarla con una chiave dall'archivio chiavi, prima del caricamento in Google Play. Gli archivi chiavi sono file binari che fungono da repository di certificati e chiavi private.

Google Play richiede che tu invii la tua app come un Android App Bundle (AAB). Google Play usa il bundle dell'app per generare e gestire pacchetti Android (APK) ottimizzati per ogni configurazione del dispositivo, in modo che vengano scaricate solo il codice e le risorse necessarie per un dispositivo specifico per eseguire l'app. Per altre informazioni sui bundle di app Android, vedere Informazioni sui bundle di app Android su developer.android.com.

Il processo di distribuzione di un'app ANDROID .NET MAUI tramite Google Play è il seguente:

Creare un account Google Play Developer. Per altre informazioni, vedere Creare un account per sviluppatori di Google Play.
Crea la tua app in Google Play Console. Per ulteriori informazioni, vedere Creare l'app in Google Play Console.
Configura la tua app in Google Play Console. Per altre informazioni, vedere Configurare l'app in Google Play Console.
Assicurarsi che l'app usi il formato del pacchetto corretto. Per altre informazioni, vedere Verificare il formato corretto del pacchetto.
Compilare e firmare l'app in Visual Studio e quindi distribuirla tramite Google Play Console. Per altre informazioni, vedere Distribuire l'app tramite Google Play Console.

Quindi, le versioni successive dell'app possono essere pubblicate tramite Visual Studio. Per altre informazioni, vedere Distribuire l'app tramite Visual Studio.

Creare un account per sviluppatore di Google Play

Per pubblicare app Android in Google Play, è necessario creare un account google Play Developer:

Usando l'account Google, iscriversi per ottenere un account per sviluppatori di Google Play .
Immettere informazioni sull'identità dello sviluppatore.
Durante il processo di iscrizione, dovrai rivedere e accettare il contratto di distribuzione per sviluppatori di Google Play .
Pagare la tariffa di registrazione di $ 25 una tantum.
Verificare l'identità seguendo le istruzioni nel messaggio di posta elettronica di verifica.

Importante

Prima di poter pubblicare app tramite Google Play, è necessario completare la verifica dell'identità. Inoltre, i nuovi titolari di account personali dovranno verificare che abbiano accesso a un dispositivo Android reale. Per altre informazioni, vedere Requisiti di verifica dei dispositivi per i nuovi account per sviluppatori su support.google.com.

Dopo aver creato l'account Google Play Developer, potrai iniziare il processo di pubblicazione di un'app in Google Play.

Per ulteriori informazioni, consulta Registrati per un account sviluppatore Google Play su support.google.com.

Crea la tua app in Google Play Console

Dopo aver creato l'account google Play Developer, dovrai creare un'app in Google Play Console:

Accedere all'account per sviluppatori di Google Play .
In Google Play Console, nella scheda Tutte le app, selezionare il pulsante Crea app:
Nella pagina Crea app immettere i dettagli dell'app e selezionare il pulsante Crea app:

Per altre informazioni sulla creazione di un'app in Google Play Console, vedere Creare e configurare l'app in support.google.com.

Configura l'app in Google Play Console

Dopo aver creato l'app, è necessario configurarla. Il dashboard dell'app ti guiderà attraverso tutti i passaggi più importanti.

Per avviare la configurazione dell'app, selezionare Dashboard nel menu a sinistra. Sotto i dettagli della tua app nella parte superiore della pagina troverai diverse categorie e attività relative alla configurazione e al rilascio dell'app. Devi completare le attività obbligatorie prima di poter avviare la tua app su Google Play. Al termine di un'attività, vedrai una spunta verde e il testo barrato. Verrà aggiornata anche la barra di stato nella parte superiore della sezione. Per ulteriori informazioni, consultare Configura la tua app nel pannello di controllo dell'app su support.google.com.

Assicurarsi che il formato del pacchetto sia corretto

Per pubblicare un'app Android .NET MAUI per la distribuzione di Google Play, è necessario che il formato del pacchetto dell'app sia AAB, ovvero il formato del pacchetto predefinito per le build di versione. Per verificare che il formato del pacchetto dell'app sia impostato correttamente:

Nell'Esplora soluzioni di Visual Studio fare clic con il pulsante destro del mouse sul progetto dell'app .NET MAUI e selezionare Proprietà. Passare quindi alla scheda Opzioni Android > e assicurarsi che il valore del campo Release sia impostato su bundle :

Pubblica

Distribuire l'app tramite Google Play Console

La prima volta che un AAB viene inviato a Google Play, deve essere caricato manualmente tramite Google Play Console. Ciò consente a Google Play di abbinare la firma della chiave in tutti i bundle futuri alla chiave originale usata per la prima versione dell'app. Per caricare l'app tramite Google Play Console, è necessario prima compilare e accedere a Visual Studio.

Per compilare e firmare l'app in Visual Studio:

Nella barra degli strumenti di Visual Studio, usa l'elenco a discesa Destinazione di Debug per selezionare Emulatori Android e quindi l'emulatore desiderato:
Nella barra degli strumenti di Visual Studio, usa l'elenco a discesa Configurazione soluzioni per passare dalla configurazione di debug alla configurazione di rilascio.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto di app .NET MAUI e selezionare Pubblica...:

Il Archive Manager verrà aperto e Visual Studio inizierà ad archiviare il bundle dell'app:
Nella Gestione Archivi, una volta completata con successo l'archiviazione, assicurati che il tuo archivio sia selezionato e quindi seleziona il pulsante Distribute ... per avviare il processo di distribuzione della tua app.

Verrà visualizzata la finestra di dialogo Distribuisci - Seleziona canale.

Nella finestra di dialogo Distribuisci - Seleziona Canale, selezionare il pulsante Ad Hoc.
Nella finestra di dialogo Distribute - Signing Identity selezionare il pulsante + per creare una nuova identità di firma:

La finestra di dialogo Crea archivio chiavi Android verrà visualizzata.

Nota

In alternativa, è possibile usare un'identità di firma esistente selezionando il pulsante Importa .
Nella finestra di dialogo Crea archivio chiavi Android immettere le informazioni necessarie per creare una nuova identità di firma, nota come archivio chiavi , quindi selezionare il pulsante Crea:
- Nome alternativo. Immettere un nome di identificazione per la chiave.
- Parola d’ordine. Creare e confermare una password sicura per la chiave.
- Validità. Impostare il periodo di tempo, espresso in anni, che la chiave sarà valida.
- Nome completo, unità organizzativa, organizzazione, città o località, stato o provincia e codice paese. Queste informazioni non vengono visualizzate nell'app, ma sono incluse nel certificato.
Un nuovo archivio chiavi, che contiene un nuovo certificato, verrà salvato in C:\Users{Username}\AppData\Local\Xamarin\Mono for Android\Keystore{Alias}{Alias}.keystore.

Importante

L'archivio chiavi e la password non vengono salvati nella soluzione di Visual Studio. Assicurarsi quindi di eseguire il backup di questi dati. Se lo perdi, non sarà possibile firmare l'app con la stessa identità di firma.
Nella finestra di dialogo Distribute - Signing Identity, selezionare l'identità di firma appena creata e selezionare il pulsante Salva con nome:

Il Gestione archivi visualizza il processo di pubblicazione.
Nella finestra di dialogo Salva con nome, verificare che il percorso e il nome del file del pacchetto siano corretti e selezionare il pulsante Salva.
Nella finestra di dialogo Password di firma, immettere la password dell'identità di firma e selezionare il pulsante OK:
Nel Archivio Manager, selezionare il pulsante Apri distribuzione una volta completato il processo di pubblicazione.

Visual Studio aprirà la cartella contenente l'app pubblicata.

L'app pubblicata può quindi essere rilasciata a Google Play tramite Google Play Console. A tale scopo, è prima necessario creare una versione in Google Play Console. Una versione è una combinazione di una o più versioni dell'app che preparerai per avviare un'app o implementare un aggiornamento. È possibile creare una versione nelle tracce seguenti:

Test interni. Le versioni di test interne sono disponibili per un massimo di 100 tester che è possibile scegliere.
Test chiusi. Le versioni di test chiuse sono disponibili per un numero limitato di tester scelti, che possono testare una versione non definitiva dell'app e inviare commenti e suggerimenti.
Aprire il test. Le versioni di test aperte sono disponibili per i tester su Google Play. Gli utenti possono partecipare ai test dalla pagina dello Store.
Produzione. Le versioni di produzione sono disponibili per tutti gli utenti di Google Play nei paesi scelti.

Per altre informazioni sulla creazione di una versione in Google Play Console, vedere Preparare e implementare una versione su support.google.com.

Importante

L'app inviata a Google Play viene in genere sottoposta a un processo di revisione. Per ulteriori informazioni, consulta Prepara la tua app per la revisione e Pubblica la tua app su support.google.com.

Distribuire l'app tramite Visual Studio

Un AAB deve essere già stato inviato a Google Play e aver superato la revisione, prima di poterlo distribuire da Visual Studio. Se si tenta di distribuire un AAB da Visual Studio che non è stato precedentemente caricato tramite il Play Console, verrà visualizzato il seguente errore:

Google Play richiede di caricare manualmente il primo pacchetto (APK/AAB) per questa app. A tale scopo, è possibile usare un pacchetto ad hoc.

Quando si verifica questo errore, caricare manualmente un AAB tramite Google Play Console. Le versioni successive dell'app possono quindi essere pubblicate tramite Visual Studio. Tuttavia, è necessario modificare il codice della versione dell'app per ogni caricamento. In caso contrario, si verificherà l'errore seguente:

È già stato caricato un AAB con codice di versione (1).

Per risolvere questo errore, ricompilare l'app con un numero di versione diverso e quindi inviarla nuovamente a Google Play tramite Visual Studio.

Nota

Il numero di versione dell'app può essere aggiornato aumentando il valore della proprietà integer ApplicationVersion nel file di progetto dell'app.

Il caricamento dell'app da Visual Studio a Google Play richiede prima di tutto di configurare l'accesso all'API in Google Play Console.

Abilitare l'accesso all'API Google

L'API Google Play Developer Publishing consente a Visual Studio di caricare nuove versioni di un'app in Google Play. Prima che Visual Studio possa iniziare a effettuare chiamate API, è necessario configurare l'accesso all'API nell'account google Play Developer. Ciò comporta il collegamento dell'account google Play Developer a un progetto Google Cloud e la configurazione dell'accesso all'API Di pubblicazione per sviluppatori Google Play con un client OAuth.

Per abilitare l'accesso all'API Google:

Accedere all'account per sviluppatori di Google Play .
In Google Play Console, espandi l'elemento Setup e seleziona API access. Quindi, nella pagina di accesso all'API , selezionare il pulsante Scegliere un progetto da collegare:

Per usare le API per sviluppatori di Google Play, è necessario un progetto Google Cloud che deve essere collegato all'account per sviluppatore di Google Play.

Nota

Un account Google Play Developer può essere collegato solo a un singolo progetto Google Cloud. Pertanto, se si pubblicano più app da un account Google Play Developer, tutti devono condividere lo stesso progetto Google Cloud.
Nella pagina di accesso all'API , selezionare il pulsante di opzione Crea un nuovo progetto Google Cloud seguito dal pulsante Salva.

Verrà creato un nuovo progetto Google Cloud e collegato all'account Google Play Developer.
Nella pagina di accesso all'API, nella sezione client OAuth selezionare schermata Configura consenso OAuth:
Nella pagina schermata di consenso OAuth , selezionare il pulsante di opzione a radio per il tipo di utente richiesto e quindi selezionare il pulsante Crea :

Per altre informazioni sui tipi di utente, vedere Tipo di utente su support.google.com.
Nella pagina Modifica registrazione app, compila i campi indicati come obbligatori e quindi seleziona il pulsante SALVA E CONTINUA.
Nella pagina Modifica registrazione app, selezionare il pulsante AGGIUNGI O RIMUOVI AMBITI.
Nel riquadro a comparsa Aggiorna ambiti selezionati, selezionare l'ambito ./auth/androidpublisher nella tabella e quindi selezionare il pulsante AGGIORNA:

Nota

Gli altri ambiti della tabella possono essere selezionati facoltativamente perché sono ambiti standard.
Nella pagina Modifica registrazione app, selezionare la scheda Credenziali.
Nella pagina Credenziali, selezionare il pulsante + CREATE CREDENTIALS e quindi l'elemento ID client OAuth.
Nella pagina Crea ID client OAuth, scegliere nell'elenco a discesa Tipo di applicazioneApp desktop, immettere Visual Studio nel campo Nome e quindi selezionare il pulsante CREA:
Nella finestra di dialogo client OAuth creata selezionare il pulsante DOWNLOAD JSON dati per scaricare l'ID client e il segreto client. Questa operazione sarà necessaria in un secondo momento. Fare quindi clic sul pulsante OK per chiudere la finestra di dialogo.

Per ulteriori informazioni sull'abilitazione dell'accesso alle API di Google nel tuo account sviluppatore Google Play, consulta Guida introduttiva su developers.google.com. Per altre informazioni sulla configurazione della schermata di consenso OAuth, vedere Configurazione della schermata di consenso OAuth in support.google.com.

Caricare l'app tramite Visual Studio

Per compilare e firmare l'app in Visual Studio:

Nella barra degli strumenti di Visual Studio, usa l'elenco a discesa destinazione di debug per selezionare gli emulatori Android e quindi l'emulatore scelto:
Nella barra degli strumenti di Visual Studio, utilizzare l'elenco a discesa Configurazione soluzioni per passare dalla configurazione di debug alla configurazione di rilascio.
In Esplora Soluzioni , clic destro sul progetto di app .NET MAUI e seleziona Pubblica...:

Il Archive Manager verrà aperto e Visual Studio inizierà ad archiviare il bundle dell'app:
Nella Gestore degli archivi, una volta completata l'archiviazione, assicurati che l'archivio sia selezionato e quindi seleziona il pulsante Distribuisci ... per avviare il processo di distribuzione della tua app:

Verrà visualizzata la finestra di dialogo Distribuisci - Seleziona canale.

Nella finestra di dialogo Distribuisci - Seleziona canale, selezionare il pulsante Google Play:
Nella finestra di dialogo Distribute - Signing Identity, selezionare l'identità di firma creata durante la creazione dell'app per la distribuzione tramite Google Play Console e quindi selezionare il pulsante Continua:

Aggiungere i dettagli dell'account Google Play Developer

Per aggiungere l'account Google Play Developer a Visual Studio:

Nella finestra di dialogo Distribute - Google Play Account selezionare il pulsante + per aggiungere i dettagli dell'account per sviluppatore di Google Play:
Nella finestra di dialogo Registra accesso all'API Google immettere una descrizione e l'ID client OAuth e il segreto client, quindi fare clic sul pulsante Registra:

Nota

La descrizione dell'account consente di registrare più account Google Play Developer e caricare app in diversi account Google Play Developer.

Verrà aperto un Web browser.
Nel Web browser accedere all'account google Play Developer. Dopo l'accesso, potrebbe essere visualizzato un messaggio che informa che Google non ha verificato l'app. In questo caso, selezionare il pulsante Continua:
Nel Web browser selezionare il pulsante continua per autorizzare l'app:

Il Web browser riceverà un codice di verifica.

Importante

Non chiudere il Web browser.
In Visual Studio, nella finestra di dialogo Distribute - Google Play Account selezionare Continue:

Selezionare una traccia in cui caricare l'app

Per selezionare la traccia di Google Play su cui caricare la tua app:

Nella finestra di dialogo Distribute - Google Play Track selezionare la traccia in cui caricare l'app. Google Play offre cinque tracce per il caricamento dell'app:
- Interno dovrebbe essere utilizzato per distribuire rapidamente l'app per i test interni e i controlli di qualità.
- Alpha deve essere usato per caricare una versione iniziale dell'app in un piccolo gruppo di tester.
- La versione beta deve essere usata per caricare una versione anticipata dell'app in un gruppo più ampio di tester.
- La produzione deve essere usata per la distribuzione completa in Google Play Store.
- È consigliabile usare custom per testare le versioni non definitive dell'app con utenti specifici creando un elenco di tester in base all'indirizzo di posta elettronica.
Importante

Se la traccia personalizzata non viene visualizzata, assicurarsi di aver creato una versione per tale traccia in Google Play Console. Per altre informazioni, vedere Preparare e distribuire una versione sul sito support.google.com.

Selezionare la traccia su cui caricare l'app, quindi selezionare il pulsante Carica:

Per altre informazioni sui test di Google Play, vedi Configurare un di test aperto, chiuso o interno su support.google.com.
Visual Studio inizierà a pubblicare l'app in Google Play. Nella finestra di dialogo Password di firma, immettere la password creata per l'identità di firma e selezionare il pulsante OK:

Visual Studio firmerà il bundle dell'app e lo caricherà in Google Play.

Importante

L'app inviata a Google Play viene in genere sottoposta a un processo di revisione. Per ulteriori informazioni, vedi Prepara la tua app per la revisione e Pubblica la tua app su support.google.com.