Configura Test di Sandbox Android

La verifica degli acquisti in-app richiede una configurazione corretta nel Console di Google Play. Questa guida ti guiderà attraverso la configurazione del testing sandbox per la tua app Android.

Scegli la build giusta per il lavoro

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

• Build di debug/dev locale: Buono per verificare l'interfaccia utente e le integrazioni native sul tuo dispositivo.
• Build di rilascio firmato AAB caricato nel Console di Google Play: Richiesto per test di fatturazione Google Play realistici.
• Build di testing installato su Play: La build che gli tester installano da un track interno o chiuso. Utilizza questo per la QA di acquisto.

Se si sideloada solo un APK da Android Studio o adb, Google Play Billing potrebbe non comportarsi nello stesso modo che in produzione. Per la validazione delle sottoscrizioni e degli acquisti in-app, testa sempre con una build installata da Google Play.

Prerequisiti

• Un account di sviluppatore del Console di Gioco Play. Se non l'hai ancora creato, inizia da iscrizione al Console di Gioco Play.
• Un record dell'app creato nel Console di Gioco Play con il tuo nome del pacchetto Android finale
• I tuoi prodotti in-app o sottoscrizioni creati nel Console di Gioco Play
• Un account Gmail di prova che puoi aggiungere per la verifica delle licenze
• Una build di rilascio firmata pronta per l'upload

Prima di spendere tempo sulla configurazione dei pagamenti, crea l'app nel Console di Gioco Play e decidi se sarà lingue gratuiti o pagati. Google ti consente di spostare un'applicazione pagata in gratuita in seguito, ma una volta che un'app è stata offerta gratuitamente, non può essere convertita in pagata.

Usa un bundle per applicazioni Android (.aab) per nuove app di Play Store:

bunx cap sync android
cd android
./gradlew bundleRelease

Assicurati che la configurazione di firma per l'Android sia già configurata prima di eseguire bundleRelease. Se il tuo keystore, la configurazione di firma o le password di rilascio non sono ancora impostati, crea il bundle firmato da Android Studio con Costruisci > Genera bundle firmato / APK, che richiede questi valori.

Procedura di Avvio

1. Aggiungi Account di Test

   In Console di Gioco, apri Impostazioni > Licenza di test e aggiungi l'account Google principale utilizzato sul tuo dispositivo di test Android.

   Ciò assicura che le acquisti mostrino il flusso di sandbox di Play invece di tentare un carico reale.

   

2. Scegli un Tracciato di Test

   Vai a Test e rilascio > Test e scegli uno di questi tracciati:

   • Internal testing: Percorso più veloce per i test di QA e fumo di fatturazione. Le nuove raccolte sono normalmente disponibili in pochi minuti.
   • Closed testing: Migliore per test più ampi, e richiesta prima della produzione per conti utente sviluppatore personali creati dopo il 13 novembre 2023.

   Per una prima rilascio, Play potrebbe mostrare un nome di app temporaneo e informazioni di elenco per i test interni per fino a 48 ore.

   

3. Crea lista di tester

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

   Se stai lavorando verso l'accesso alla produzione su un conto utente personalizzato appena creato, assicurati di utilizzare closed testing e mantenere almeno 12 tester opt-in per 14 giorni consecutivi.

   

4. Carica una versione rilasciata firmata

   Creare una nuova versione nel tracciato di testing selezionato e caricare la tua versione firmata .aab.

   Nuove app di Google Play dovrebbero utilizzare un bundle Android App piuttosto che un APK. Dopo il caricamento, salva la versione, risolvi eventuali blocchi di politica o di lista di store Play flags, quindi pubblica la versione nel tracciato di testing

   

5. Unisciti al Programma di Testing

   Apri l'URL di opt-in dal tuo dispositivo di test e clicca sul “Diventa un tester” tasto per iscriverti.

   Installa l'app dalla lista di store Play creata da quel flusso di opt-in, non da un APK esportato localmente.

   

6. Costruisci e Testa

   Lancia la versione installata su Play sul dispositivo di test e tenta un acquisto. Dovresti vedere un messaggio come:

   “Questo è un ordine di test; non verrà addebitato alcun costo.”

   

Nota importante

• Per la fatturazione QA, disinstallare qualsiasi copia caricata manualmente dell'app prima di installare l'edizione di testing di Play.
• La testing interna è ottima per i test di fumo veloci, ma la testing chiusa è la pista che conta per l'accesso alla produzione con account personale.
• Gli account di test non saranno addebitati per le spese
• Gli acquisti di test utilizzano lo stesso flusso degli acquisti di produzione
• Si possono testare tutte le funzionalità delle sottoscrizioni, compresi i trial e gli offerti introduttivi
• Le sottoscrizioni di test hanno periodi di rinnovo accelerati per un testing più veloce
• Utilizzare lo stesso account Google per tutti e tre i luoghi: il negozio Play sul dispositivo, il flusso di opzione per i tester e la testing di licenza

Risolvere i problemi

Prodotti non visualizzati in modalità di test:

• Assicurati che l'app sia caricata su un tracciato di testing
• Verifica che l'account di test sia aggiunto a License testing
• Controlla che i prodotti siano attivi nel Google Play Console
• Conferma che il build sia stato installato da Google Play, non caricato localmente

Errore “oggetto non disponibile”:

• Attendi 2-3 ore dopo aver creato i prodotti affinché diventino disponibili
• Assicurati che il nome del pacchetto dell'app corrisponda a quello presente nel Play Console
• Verifica di essere connesso con un account di test
• Conferma di aver caricato il build di rilascio firmato che punti allo stesso nome del pacchetto e catalogo dei prodotti

Acquisti in test visualizzati come addebiti reali:

• Verifica che l'account sia stato aggiunto alla licenza di testing
• Assicurati di utilizzare la versione costruita dal track di testing
• Verifica che il banner di testing venga visualizzato durante l'acquisto

Risorse aggiuntive

• Effettua acquisti di prova con Google Play Billing
• Configura un test aperto, chiuso o interno
• Requisiti di testing per nuovi account di sviluppatore personali

Continua da Configura testing sandbox Android

Se stai utilizzando Configura testing sandbox Android per pianificare l'approvazione e la distribuzione del negozio, connettilo con Usando @capgo/native-purchases per la capacità nativa in Usando @capgo/native-purchases, @capgo/capacitor-recensione-in-app per il dettaglio di implementazione in @capgo/capacitor-recensione-in-app, Usando @capgo/capacitor-recensione-in-app per la capacità nativa in Usando @capgo/capacitor-recensione-in-app, @capgo/capacitor-mercato-nativo per il dettaglio di implementazione in @capgo/capacitor-mercato-nativo, e Usando @capgo/capacitor-mercato-nativo per la capacità nativa in Usando @capgo/capacitor-mercato-nativo.