Prerequisiti

Prima di iniziare l'integrazione con l'API Google Wallet, completa i seguenti passaggi:

1. Creare un account emittente API Google Wallet

Per creare e distribuire le tessere per Google Wallet è necessario un account emittente. Recupera il tuo account emittente registrandoti a Google Pay e Wallet Console. Dopo la registrazione, vai alla pagina dell'API Google Wallet e fai clic su Crea il tuo primo pass. Dopo aver accettato i Termini di servizio, puoi iniziare a creare una classe per la tessera.

Dopo il passaggio precedente, puoi anche provare il codelab.

2. Acquisisci familiarità con lo sviluppo di applicazioni sulla piattaforma Android

Ai fini di questo tutorial, acquisisci familiarità con i concetti e le competenze di base dello sviluppo di applicazioni per la piattaforma Android. Se hai bisogno di informazioni sullo sviluppo Android prima di iniziare, segui alcune lezioni nella formazione per sviluppatori Android.

3. Ottenere le credenziali per autorizzare la tua app

Per utilizzare correttamente l'API Google Wallet per Android nella tua app per Android, devi autorizzare l'app. Puoi farlo con l'impronta SHA1 presente nella chiave dello sviluppatore e nel nome del pacchetto.

Per ottenere l'approvazione della tua applicazione, devi ottenere l'impronta SHA1 del certificato. Per trovare l'impronta, apri una finestra del terminale ed esegui l'utilità Keytool:

keytool -alias androiddebugkey -keystore path_to_debug_or_production_keystore -list -v

L'archivio chiavi di debug si trova in genere all'indirizzo ~/.android/debug.keystore e la password è android.

Keytool stampa l'impronta sulla shell. Ad esempio:

$ keytool -alias androiddebugkey -keystore ~/.android/debug.keystore -list -v
Enter keystore password: Type "android" if using debug.keystore
Alias name: androiddebugkey
Creation date: Aug 27, 2012
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 503bd581
Valid from: Mon Aug 27 13:16:01 PDT 2012 until: Wed Aug 20 13:16:01 PDT 2042
Certificate fingerprints:
   MD5:  1B:2B:2D:37:E1:CE:06:8B:A0:F0:73:05:3C:A3:63:DD
   SHA1: D8:AA:43:97:59:EE:C5:95:26:6A:07:EE:1C:37:8E:F4:F0:C8:05:C8
   SHA256: F3:6F:98:51:9A:DF:C3:15:4E:48:4B:0F:91:E3:3C:6A:A0:97:DC:0A:3F:B2:D2:E1:FE:23:57:F5:EB:AC:13:30
   Signature algorithm name: SHA1withRSA
   Version: 3

4. Autorizza la tua app nella console di Google Pay e Wallet

Copia l'impronta SHA1, evidenziata nell'esempio precedente. L'impronta e il nome del pacchetto dell'app sono necessari per autorizzare l'app. Per autorizzare l'app, procedi nel seguente modo:

  1. Vai alla console Google Pay e Wallet.
  2. Seleziona API Google Wallet nel menu a sinistra
  3. Seleziona la scheda Funzionalità aggiuntive
  4. Scorri verso il basso fino alla sezione Autorizzazioni app.
  5. Fai clic sul pulsante Aggiungi un'app.
  6. Inserisci il nome del pacchetto e la fingerprint della chiave di firma
  7. Fai clic sul pulsante Aggiungi applicazione.
Dopo aver completato questi passaggi, il pacchetto dell'applicazione sarà autorizzato e potrai visualizzare il pacchetto nella sezione Autorizzazioni app.

5. Configura Google Play Services

Se non hai ancora Android Studio, scarica e installa Android Studio.

Google Wallet per Android fa parte di Google Play Services. Per importare le librerie di Google Play Services, segui le istruzioni per configurare Google Play Services.

In particolare, per importare l'API Google Wallet per Android, aggiungi quanto segue al blocco delle dipendenze al file build.gradle nel modulo dell'app:

dependencies {
  implementation 'com.google.android.gms:play-services-pay:16.0.3'
}

6. Creare una classe per i pass

Prima di poter creare e aggiungere una carta d'imbarco, devi creare un FlightClass. A tale scopo, accedi alla console Google Pay e Wallet, vai alla pagina dell'API Google Wallet e crea un nuovo FlightClass.

  1. Assicurati di essere nella scheda Gestisci.
  2. Se è la prima volta che crei un pass, dovresti vedere il messaggio "Sei in modalità demo".
  3. In modalità demo, fai clic su "Configura account di prova" per aggiungere account di prova. Solo questi account potranno salvare le tessere mentre l'account emittente è in modalità demo.
  4. Fai clic su Crea un corso.
  5. Scegli Imbarco
  6. Compila tutti i campi obbligatori contrassegnati con *
  7. Fai clic su Crea corso

Ripeti i passaggi precedenti se ti servono più carte d'imbarco.

Ora che hai creato correttamente un FlightClass, puoi passare ad Aggiungere tessere a Google Wallet.