Configura il testing del sandbox Android

Richiede una configurazione appropriata nel Google Play Console per testare gli acquisti in-app. 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.
• AAB di rilascio firmato caricato nel Console di Play: Richiesto per testare realisticamente le fatture Google Play.
• Build di testing installato da 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, 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.

Requisiti

• Un account di sviluppatore del Google Play Console. Se non l'avete ancora creato, iniziate da Registrazione del Console di Gioco.
• Un record dell'app creato nel Console di Gioco con il vostro nome del pacchetto Android finale
• I vostri prodotti in-app o le sottoscrizioni creati nel Console di Gioco
• Un account Gmail di test che potete aggiungere per la verifica dei test di licenza
• Un build rilasciato firmato pronto per l'upload

Prima di spendere tempo sulla configurazione dei costi, create l'app nel Console di Gioco e decidete se sarà gratuito o context. Google vi consente di spostare un'applicazione a pagamento in gratuita in un secondo momento, ma una volta che un'app è stata offerta gratuitamente, non può essere cambiata in una a pagamento.

Utilizza un bundle di applicazione Android (.aab) per nuove applicazioni del negozio Play:

bunx cap sync android
cd android
./gradlew bundleRelease

Assicurati di avere già configurato 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 o APKche ti chiederà di fornire quei valori.

Processo di configurazione

1. Aggiungi account di testing

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

   Ciò assicura che le acquisti mostrino il flusso di test di Play al posto di tentare un carico reale.

   

2. Scegli un Tracciato di Test

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

   • Test interni: Percorso più veloce per i test di QA e del fumo dei pagamenti. Gli ultimi pacchetti sono normalmente disponibili in pochi minuti.
   • Test chiusi: Migliore per test più ampi, e richiesta prima della produzione per conti sviluppatori 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 tester interni per fino a 48 ore.

   

3. Creare 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 nuovo conto personale creato, assicurati di utilizzare chiuso testing e mantenere almeno 12 tester opt-in 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 negozio 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

   Avvia il build Play installato sul dispositivo di test e tenta un acquisto. Dovresti vedere un messaggio come:

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

   

Nota importante

• Per la fatturazione QA, disinstallare qualsiasi copia caricata manualmente dell'app prima di installare l'edizione di testing del Play.
• La testing interna è ottima per i test di fumo veloci, ma la testing chiusa è il percorso che conta per l'accesso alla produzione con account personale.
• Gli account di testing non saranno addebitati per le spese
• Gli acquisti di testing utilizzano lo stesso flusso degli acquisti di produzione
• È possibile testare tutte le funzionalità delle sottoscrizioni, compresi i periodi di prova e le offerte introduttive
• Gli abbonamenti di testing hanno periodi di rinnovo accelerati per un testing più rapido
• Utilizzare lo stesso account Google per tutti e tre i luoghi: il negozio Play sul dispositivo, il flusso di opt-in per i tester e la testing di licenza

Risolvere i problemi

I prodotti non vengono visualizzati in modalità di testing:

• Assicurarsi che l'app sia caricata su un percorso di testing
• Verifica che l'account di test sia stato aggiunto alla licenza di testing
• Controlla che i prodotti siano attivi nel Console di Google Play
• Conferma che l'edizione è stata installata da Google Play e non caricata localmente

Errore "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 Console di Google Play
• Verifica di essere connesso con un account di test
• Conferma di aver caricato l'edizione rilasciata firmata che punta allo stesso nome del pacchetto e al catalogo dei prodotti

Acquisti in corso che vengono visualizzati come carichi reali:

• Duplica la verifica dell'aggiunta dell'account alla licenza di testing
• Assicurati di utilizzare l'edizione dalla track di testing
• Verifica che il banner di testing venga visualizzato durante l'acquisto

Risorse Aggiuntive

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

Continua da Configurazione del testing sandbox Android

Configurazione del testing sandbox Android per pianificare l'approvazione e la distribuzione della store, connettilo con Utilizzare @__CAPGO_KEEP_0__/native-purchases per la capacità nativa in Utilizzare @capgo/native-purchases, Utilizzare @capgo/native-purchases @capgo/capacitor-in-app-review for the implementation detail in @capgo/capacitor-in-app-review, Using @capgo/capacitor-in-app-review for the native capability in Using @capgo/capacitor-in-app-review, @capgo/capacitor-native-market for the implementation detail in @capgo/capacitor-native-market, and Using @capgo/capacitor-native-market for the native capability in Using @capgo/capacitor-native-market.