Crea la configurazione di testing del sandbox Android

Richiede una configurazione appropriata nel Console di Google Play per effettuare 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.
• Build di rilascio firmato AAB caricato nel Console di Google Play: Richiesto per test realistiche delle fatture di 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, 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 hai ancora creato uno, inizia da Registrazione del Console di gioco.
• Un record dell'app creato nel Console di gioco con il tuo nome del pacchetto Android finale
• I tuoi prodotti o abbonamenti in-app creati nel Console di gioco
• Un account Gmail di test che puoi aggiungere per la verifica dei test di licenza
• Un build di rilascio firmato pronto per l'upload

Prima di spendere tempo sulla configurazione dei costi, crea l'app nel Console di gioco e decidi se sarà gratuito o context. Google ti 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 app di Store Play:

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 di applicazione / APKche ti chiederà di inserire quei valori.

Procedura 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 acquisizioni visualizzino 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 fumo di fatturazione. Gli ultimi pacchetti sono normalmente disponibili in pochi minuti.
   • Test chiusi: Migliore per testare in modo più ampio, e richiesta prima della produzione per conti sviluppatori personali creati dopo il 13 novembre 2023.

   Per una prima rilascio, Play potrebbe visualizzare un nome e informazioni di lista temporanei 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 per ottenere l'accesso alla produzione su un conto personale appena creato, assicurati di utilizzare il testing chiuso e mantieni almeno 12 tester opt-in per 14 giorni consecutivi.

   

4. Caricare una Build di Rilascio Firmata

   Creare una nuova rilascio nel track di testing selezionato e caricare la tua build firmata .aab.

   Nuove app Google Play dovrebbero utilizzare un bundle per app Android piuttosto che un APK. Dopo il caricamento, salva la rilascio, risolvi eventuali blocchi di politica o di lista di store segnalati da Play, quindi pubblica la 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 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 test 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 delle spese 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: la Store di Google 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 "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 Console di Google Play
• Verifica di essere connesso con un account di test
• Conferma di aver caricato la versione rilasciata firmata che punta allo stesso nome del pacchetto e al catalogo dei prodotti

Acquisti mostrati come carichi reali:

• Controlla nuovamente che l'account sia stato aggiunto alla licenza di testing
• Assicurati di utilizzare l'edizione dal track di testing
• Verifica che il banner di testing apparisca 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 del sandbox Android

Se stai utilizzando Configurazione del testing del sandbox Android per pianificare l'approvazione e la distribuzione della store, connettilo con Utilizzando @capgo/native-purchases per la capacità nativa in Utilizzando @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.