Configura il test di sandbox Android

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

Usa 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 su Console di Gioco: Richiesto per test realistiche di fatturazione Google Play.
• Build di testing installato su Play: La build che i tuoi tester installano da un track interno o chiuso. Utilizza questa per la verifica degli acquisti.

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

Requisiti preliminari

• Un account di sviluppatore per Google Play Console. Se non hai ancora creato uno, inizia da iscrizione a Play Console.
• Un record dell'app creato in Play Console con il tuo nome del pacchetto Android finale
• I tuoi prodotti in-app o le tue sottoscrizioni create in Play Console
• Un account Gmail di prova che puoi aggiungere per le prove di licenza
• Un file di rilascio firmato pronto per l'upload

Prima di spendere tempo sulla configurazione dei costi, crea l'app in Play Console e decidi se sarà gratuito o a pagamento. Google ti consente di spostare un'app a pagamento in gratuita successivamente, ma una volta che un'app è stata offerta gratuitamente, non può essere cambiata in a pagamento.

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

bunx cap sync android
cd android
./gradlew bundleRelease

Assicurati di aver configurato già la firma di rilascio Android 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 per applicazioni / APK, che ti chiederà di fornire quei valori.

Procedura di configurazione

1. Aggiungi account di testing

   In Console di Play, apri Impostazioni > Test di licenza e aggiungi il principale account Google utilizzato sul tuo dispositivo di test Android.

   Ciò assicura che le acquisizioni visualizzino il flusso di test di Play al posto di tentare una carica reale.

   

2. Scegli un percorso di testing

   Vai a Test e rilascio > Testing e scegli uno di questi percorsi:

   • Test interni: Percorso più veloce per i test di QA e fumo di fatturazione. Le nuove raccolte sono normalmente disponibili in pochi minuti.
   • Test chiusi: Migliore per test più ampi, e richiesto prima della produzione per gli account di sviluppatore personali creati dopo il 13 novembre 2023.

   For una prima rilascio, Play potrebbe visualizzare un nome di app temporaneo e informazioni di elenco per i testatori interni per fino a 48 ore.

   

3. Creare lista di testatori

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

   Se stai lavorando verso l'accesso alla produzione su un account personale appena creato, assicurati di utilizzare test di chiusura e mantenere almeno 12 testatori iscritti per 14 giorni consecutivi.

   

4. Caricare una Build di Rilascio Firmata

   Creare un nuovo rilascio nel track di testing selezionato e caricare la tua build firmata .aab.

   Nuove app di Google Play dovrebbero utilizzare un Bundle di App Android piuttosto che un APK. Dopo il caricamento, salva il rilascio, risolvi eventuali blocchi di politica o di elenco di store segnalati da Play, quindi pubblica il rilascio nel track di testing.

   

5. Unisciti al Programma di Test

   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 dei prodotti Play creata da quel flusso di opt-in, non da un APK esportato localmente.

   

6. Costruisci e Testa

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

   “Questo è un ordine di test; non sarai addebitato.”

   

Nota importante

• For la fatturazione QA, disinstalla qualsiasi copia caricata manualmente dell'app prima di installare l'edizione di testing del Play.
• La testing interna è ottima per test veloci di fumo, ma la testing chiusa è la pista che conta per l'accesso alla produzione per conto proprio.
• Gli account di testing non saranno addebitati per le spese
• Gli acquisti di testing utilizzano lo stesso flusso degli acquisti di produzione
• Potrai testare tutte le funzionalità delle sottoscrizioni, compresi i trial e gli offerti introduttivi
• Gli abbonamenti di testing hanno periodi di rinnovo accelerati per un testing più veloce
• Utilizza lo stesso account Google per tutti e tre i posti: la Store di Google sul dispositivo, il flusso di opt-in per i tester e la testing di License

Risolvere i problemi

Gli prodotti non vengono visualizzati in modalità di testing:

• Assicurati che l'app sia caricata su una pista di testing
• Verifica che l'account di testing sia aggiunto alla testing di License
• Verifica che i prodotti siano attivi nel Console di Google Play
• Conferma che l'installazione è stata effettuata da Google Play e non caricata localmente

Errore "Item not available":

• 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 Console di Google Play
• 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 al catalogo dei prodotti

Acquisti in prova che vengono visualizzati come carichi reali:

• Verifica di aver aggiunto l'account al testing di licenza
• Assicurati di utilizzare il build dal track di testing
• Verifica che compare la bandiera di testing 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 della store, connettilo con Utilizza @capgo/native-purchases per la capacità nativa in Utilizza @capgo/native-purchases, @capgo/capacitor-recensione in-app per i dettagli di implementazione in @capgo/capacitor-in-app-review, Utilizzando @capgo/capacitor-in-app-review per i dettagli di implementazione in @capgo/capacitor-native-market, @capgo/capacitor-native-market per i dettagli di implementazione in @capgo/capacitor-native-market, e Utilizzando @capgo/capacitor-native-market per i dettagli di implementazione in @capgo/capacitor-native-market.