Configura Android Sandbox Testing

Per testare gli acquisti in-app è necessaria una configurazione corretta in Google Play Console. Questa guida ti accompagnerà nella configurazione del sandbox testing per la tua app Android.

Usa la build giusta per il compito

Prima di iniziare, distingui questi tre tipi di build Android:

• Build locale di debug/dev: Ideale per verificare UI e integrazioni native sul tuo dispositivo.
• AAB di release firmato caricato su Play Console: Necessario per test realistici di Google Play Billing.
• Build di test installata da Play Store: La build che i tester installano da un canale interno o chiuso. Usala per la QA degli acquisti.

Se installi solo un APK tramite sideload da Android Studio o adb, Google Play Billing potrebbe non comportarsi come in produzione. Per la validazione di abbonamenti e acquisti in-app, testa sempre con una build installata da Google Play.

Prerequisiti

• Un account sviluppatore Google Play Console. Se non ne hai ancora creato uno, inizia da la registrazione alla Play Console.
• Un record app creato in Play Console con il package name Android finale
• I tuoi prodotti in-app o abbonamenti creati in Play Console
• Un account Gmail di test da aggiungere al license testing
• Una release build firmata pronta per l'upload

Prima di dedicare tempo alla configurazione della fatturazione, crea l'app nella Play Console e decidi se sarà gratuita o a pagamento. Google permette di rendere un'app a pagamento gratuita in seguito, ma una volta che un'app è stata offerta gratuitamente, non può più diventare a pagamento.

Usa un Android App Bundle (.aab) per nuove app sul Play Store:

bunx cap sync android
cd android
./gradlew bundleRelease

Assicurati che la firma di rilascio Android sia già configurata prima di eseguire bundleRelease. Se keystore, signing config o le password di rilascio non sono ancora impostate, crea il bundle firmato da Android Studio con Build > Genera App Bundle / APK firmato, che ti chiederà di inserire tali valori.

Processo di setup

1. Aggiungi account di test

   In Play Console, apri Impostazioni > Test licenze e aggiungi l'account Google principale usato sul tuo dispositivo Android di test.

   Questo assicura che gli acquisti mostrino il flusso sandbox di Play invece di tentare un addebito reale.

   

2. Scegli un canale di test

   Vai su Test e rilascio > Test e scegli uno di questi canali:

   • Test interno: Percorso più veloce per QA e smoke test di fatturazione. I nuovi bundle sono solitamente disponibili in pochi minuti.
   • Test chiuso: Ideale per test più ampi e obbligatorio in produzione per gli account developer personali creati dopo il 13 novembre 2023.

   Per un primo rilascio, Play potrebbe mostrare un nome app e informazioni di listing temporanei ai tester interni fino a 48 ore.

   

3. Crea lista tester

   Dopo aver aperto il tuo track, crea una lista tester e aggiungi gli account Google che devono ricevere il build.

   Se stai cercando di ottenere l'accesso alla produzione con un account personale appena creato, assicurati di usare il closed testing e mantieni almeno 12 tester iscritti per 14 giorni consecutivi.

   

4. Carica una release build firmata

   Crea una nuova release nel track di test selezionato e carica la tua build firmata .aab.

   Le nuove app su Google Play dovrebbero usare un Android App Bundle invece di un APK. Dopo l'upload, salva la release, risolvi eventuali blocchi di policy o store listing segnalati da Play, quindi pubblica la release nel track di test.

   

5. Partecipa al programma di test

   Apri l'URL di opt-in dal tuo dispositivo di test e clicca su “Partecipa al programma di test” per iscriverti.

   Installa l'app dalla pagina del Play Store generata dal flusso di opt-in, non tramite un APK esportato localmente.

   

6. Build e Test

   Avvia la build installata tramite Play sul dispositivo di test e prova a effettuare un acquisto. Dovresti vedere un messaggio come:

   “Questo è un ordine di prova; non ti verrà addebitato alcun importo.”

   

Note importanti

• Per il QA della fatturazione, disinstalla qualsiasi copia dell'app installata tramite sideload prima di installare la build di test di Play.
• I test interni sono ottimi per smoke test rapidi, ma i test chiusi sono il percorso fondamentale per ottenere l'accesso alla produzione con nuovi account personali.
• Agli account di test non verranno addebitati gli acquisti
• Gli acquisti di test seguono lo stesso flusso di quelli in produzione
• Puoi testare tutte le funzionalità degli abbonamenti, inclusi trial e offerte introduttive
• Gli abbonamenti di test hanno periodi di rinnovo accelerati per test più rapidi
• Usa lo stesso account Google per tutti e tre: Play Store sul dispositivo, opt-in dei tester e License testing

Risoluzione problemi

Prodotti non visibili in modalità test:

• Assicurati che l'app sia caricata su un canale di test
• Verifica che l'account di test sia aggiunto a License testing
• Controlla che i prodotti siano attivi nella Google Play Console
• Conferma che la build sia stata installata da Google Play e non via sideload locale

Errore “Item not available”:

• Attendi 2-3 ore dopo la creazione dei prodotti affinché siano disponibili
• Assicurati che il package name dell'app coincida con quello in Play Console
• Verifica di aver effettuato l'accesso con un account di test
• Conferma di aver caricato la signed release build con lo stesso package name e catalogo prodotti

Acquisti di test che risultano come addebiti reali:

• Controlla che l'account sia stato aggiunto a License testing
• Assicurati di usare la build proveniente dal testing track
• Verifica che il banner di test appaia durante l'acquisto

Risorse aggiuntive

• Test degli acquisti con Google Play Billing
• Configura un test aperto, chiuso o interno
• Requisiti di test per nuovi account developer personali

Continua da Configura Android Sandbox Testing

Se stai usando Configura Android Sandbox Testing per pianificare approvazione e distribuzione sullo store, collegalo a Utilizzo di @capgo/native-purchases per la funzionalità nativa in Utilizzo di @capgo/native-purchases, @capgo/capacitor-in-app-review per i dettagli di implementazione in @capgo/capacitor-in-app-review, Utilizzo di @capgo/capacitor-in-app-review per la funzionalità nativa in Utilizzo di @capgo/capacitor-in-app-review, @capgo/capacitor-native-market per i dettagli di implementazione in @capgo/capacitor-native-market, e Utilizzo di @capgo/capacitor-native-market per la funzionalità nativa in Usare @capgo/capacitor-native-market.