Vai al contenuto

Configura il test sandbox Android

GitHub

Testare gli acquisti in-app richiede una configurazione corretta in Google Play Console. Questa guida ti illustra come impostare il sandbox testing per la tua app Android.

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 firmato di release caricato su Play Console: Necessario per test realistici di fatturazione Google Play.
  • Build di testing installata da Play: La build che i tester installano da una traccia interna o chiusa. Usala per il QA degli acquisti.

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

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

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

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

Finestra del terminale
bunx cap sync android
cd android
./gradlew bundleRelease

Assicurati che la firma di release Android sia già configurata prima di eseguire bundleRelease. Se non hai ancora impostato keystore, configurazione di firma o password di release, crea il bundle firmato da Android Studio con Build > Genera App Bundle / APK firmato, che ti chiederà di inserire quei valori.

  1. Aggiungi account di test

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

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

    Aggiungi account di test

  2. Scegli una Testing Track

    Vai su Test e rilascio > Test e scegli una di queste track:

    • Test interno: Percorso più rapido per QA e smoke test di fatturazione. I nuovi bundle sono normalmente disponibili entro pochi minuti.
    • Test chiuso: Ideale per test più ampi e obbligatorio prima della produzione per gli account di sviluppatori personali creati dopo il 13 novembre 2023.

    Per un primo rilascio, Play potrebbe mostrare un nome app temporaneo e informazioni di listing ai tester interni per un massimo di 48 ore.

    Crea track di test

  3. Crea elenco tester

    Dopo aver aperto la track, crea un elenco tester e aggiungi gli account Google che devono ricevere la build.

    Se stai lavorando per l'accesso alla produzione su un account personale appena creato, assicurati di usare test chiuso e mantieni almeno 12 tester iscritti per 14 giorni consecutivi.

    Crea elenco tester

  4. Carica una build di release firmata

    Crea una nuova release nella track di test selezionata e carica la tua .aab.

    Le nuove app su Google Play dovrebbero usare un Android App Bundle anziché un APK. Dopo il caricamento, salva la release, correggi eventuali blocchi di policy o store listing segnalati da Play, quindi pubblica la release nella track di test.

    Carica build di release

  5. Partecipa al programma di test

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

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

    Partecipa ai test

  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.”

    Acquisto di test

  • Per il QA della fatturazione, disinstalla qualsiasi copia dell'app installata tramite sideload prima di installare la build di test di Play.
  • Il testing interno è ottimo per smoke test rapidi, ma il testing chiuso è la fase decisiva per l'accesso alla produzione con account personali.
  • Gli account di test non verranno addebitati per gli acquisti
  • Gli acquisti di test utilizzano lo stesso flusso degli acquisti di produzione
  • Puoi testare tutte le funzionalità di abbonamento, inclusi trial e offerte introduttive
  • Le sottoscrizioni di test hanno periodi di rinnovo accelerati per test più rapidi
  • Usa lo stesso account Google in tutti e tre i punti: Play Store sul dispositivo, flusso di opt-in del tester e test della licenza

Prodotti non visualizzati in modalità di test:

  • Assicurati che la tua app sia caricata su una traccia di test
  • Verifica che l'account di test sia stato aggiunto ai test della licenza
  • Controlla che i prodotti siano attivi in Google Play Console
  • Conferma che la build è stata installata da Google Play, non tramite sideload locale

Errore “Item not available”:

  • Attendi 2-3 ore dopo aver creato i prodotti perché diventino disponibili
  • Assicurati che il package name della tua app corrisponda a quello in Play Console
  • Verifica di essere connesso con un account di test
  • Conferma di aver caricato la build di release firmata che punta allo stesso package name e catalogo prodotti

Acquisti di test che appaiono come addebiti reali:

  • Ricontrolla che l'account sia stato aggiunto a License testing
  • Assicurati di usare la build dalla track di test
  • Verifica che il banner di test compaia durante l'acquisto

Se stai usando Configura il test sandbox Android per pianificare l'approvazione e la distribuzione negli 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 Utilizzo di @capgo/capacitor-native-market.