Configurazione delle licenze

Prima di iniziare ad aggiungere la verifica della licenza alla tua applicazione, devi configurare il tuo account di pubblicazione Google Play, il tuo ambiente di sviluppo e tutti gli account di test necessari per verificare l'implementazione.

Configurazione di un account editore

Se non hai ancora un account publisher per Google Play, devi registrarne uno utilizzando il tuo Account Google e accettare i Termini di servizio di Google Play.

Per saperne di più, consulta Inizia a pubblicare.

Se hai già un account publisher su Google Play, utilizza Play Console per configurare le licenze.

Con Google Play Console puoi:

  • Ottieni una chiave pubblica specifica per l'app per le licenze
  • Eseguire il debug e testare l'implementazione delle licenze di un'applicazione prima di pubblicarla
  • Pubblica le applicazioni a cui hai aggiunto il supporto per le licenze

Impostazioni amministrative per le licenze

Puoi gestire diversi controlli amministrativi per le licenze di Google Play in Play Console. I controlli ti consentono di:

  • Configura più "account di prova", identificati dall'indirizzo email. Il server di licenze consente agli utenti che hanno eseguito l'accesso agli account di test su un dispositivo o un emulatore di inviare controlli delle licenze e ricevere risposte di test statiche. Puoi configurare gli account nella pagina Dettagli account di Play Console.
  • Configura le risposte di test statiche inviate dal server quando riceve un controllo della licenza per un'applicazione caricata nell'account publisher da un utente che ha eseguito l'accesso all'account publisher o a un account di test. Puoi impostare le risposte di test nella pagina dei dettagli dell'account di Play Console.
  • Ottieni la chiave pubblica dell'app per le licenze. Quando implementi le licenze in un'applicazione, devi copiare la stringa della chiave pubblica nell'applicazione. Puoi ottenere la chiave pubblica dell'app per le licenze nella pagina Servizi e API (in Tutte le applicazioni).

Figura 1. Il codice licenza di un'app è disponibile nella pagina Servizi e API di Play Console.

Per saperne di più su come utilizzare gli account di test e le risposte di test statiche, consulta Configurazione di un ambiente di test.

Configurazione dell'ambiente di sviluppo

La configurazione dell'ambiente per le licenze prevede le seguenti attività:

  1. Configurazione dell'ambiente di runtime per lo sviluppo
  2. Download della Licensing Verification Library (LVL) nell'SDK
  3. Configurazione della Licensing Verification Library
  4. Includere il progetto della libreria LVL nell'applicazione

Le sezioni seguenti descrivono queste attività. Al termine della configurazione, puoi iniziare ad aggiungere le licenze alla tua app.

Per iniziare, devi configurare un ambiente di runtime appropriato in cui puoi eseguire, eseguire il debug e testare l'implementazione del controllo e dell'applicazione delle licenze della tua applicazione.

Configurazione dell'ambiente di runtime

Come descritto in precedenza, le applicazioni controllano lo stato delle licenze non contattando direttamente il server di licenza, ma associandosi a un servizio fornito dall'applicazione Google Play e avviando una richiesta di controllo della licenza. Il servizio Google Play gestisce quindi la comunicazione diretta con il server di licenza e infine indirizza la risposta alla tua applicazione. Per eseguire il debug e testare le licenze nella tua applicazione, devi configurare un ambiente di runtime che includa i Google Play Services necessari, in modo che l'applicazione possa inviare richieste di controllo della licenza al server di licenza.

Puoi utilizzare due tipi di ambiente di runtime:

  • Un dispositivo Android che include l'applicazione Google Play oppure
  • Un emulatore Android che esegue il componente aggiuntivo API di Google, livello API 8 (release 2) o versioni successive

Esecuzione su un dispositivo

Per utilizzare un dispositivo Android per il debug e il test delle licenze, il dispositivo deve:

  • Eseguire una versione compatibile della piattaforma Android 1.5 o versioni successive (livello API 3 o superiore) e
  • Esegui un'immagine di sistema su cui è preinstallata l'applicazione client Google Play.

Se Google Play non è preinstallato nell'immagine di sistema, l'applicazione non potrà comunicare con il server di licenza di Google Play.

Per informazioni generali su come configurare un dispositivo da utilizzare per lo sviluppo di app per Android, consulta Utilizzo dei dispositivi hardware.

Esecuzione su un emulatore Android

Se non hai un dispositivo disponibile, puoi utilizzare un emulatore Android per il debug e il test delle licenze.

Poiché le piattaforme Android fornite nell'SDK Android non includono Google Play, devi scaricare la piattaforma del componente aggiuntivo API di Google, livello API 8 (o versioni successive), dal repository dell'SDK. Dopo aver scaricato il componente aggiuntivo, devi creare una configurazione AVD che utilizzi l'immagine di sistema.

Il componente aggiuntivo API di Google non include il client Google Play completo. Tuttavia, fornisce:

  • Un servizio in background di Google Play che implementa l'interfaccia remota ILicensingService, in modo che la tua applicazione possa inviare controlli delle licenze tramite la rete al server di licenza.
  • Un insieme di servizi dell'account sottostanti che ti consentono di aggiungere un Account Google sull'AVD e di accedere utilizzando le credenziali del tuo account editore o di test.

    L'accesso con il tuo account publisher o di test ti consente di eseguire il debug e testare la tua applicazione senza doverla pubblicare. Per saperne di più, consulta Accedi a un account autorizzato.

Tramite SDK Manager sono disponibili diverse versioni del componente aggiuntivo API di Google, ma solo la versione per Android 2.2 e versioni successive include i servizi Google Play necessari.

Per configurare un emulatore per l'aggiunta delle licenze a un'applicazione, segui questi passaggi:

  1. Avvia SDK Manager Android, disponibile nel menu Strumenti di Android Studio (Strumenti > Android > SDK Manager) o eseguendo <sdk>/tools/android sdk.
  2. Seleziona e scarica le API di Google per la versione di Android che vuoi scegliere come target (deve essere Android 2.2 o versioni successive).
  3. Al termine del download, apri Gestione AVD, disponibile nel menu Strumenti di Android Studio (Strumenti > Android > Gestione AVD) o eseguendo <sdk>/tools/android avd.
  4. Nella finestra Android Virtual Device Manager, seleziona + Create Virtual Device per impostare i dettagli di configurazione del nuovo AVD.
  5. Nella finestra Virtual Device Configuration (Configurazione dispositivo virtuale), seleziona l'hardware del dispositivo, quindi seleziona Next (Avanti).
  6. Seleziona un'API di Google come immagine di sistema da eseguire sul nuovo AVD, quindi seleziona Avanti.
  7. Assegna un nome descrittivo all'AVD e imposta gli altri dettagli di configurazione in base alle tue esigenze.
  8. Seleziona Fine per creare la nuova configurazione AVD, che verrà visualizzata nell'elenco degli Android Virtual Device disponibili.

Se non hai dimestichezza con gli AVD o con il loro utilizzo, consulta Gestione dei dispositivi virtuali.

Aggiornamento della configurazione del progetto

Dopo aver configurato un ambiente di runtime che soddisfa i requisiti descritti sopra, su un dispositivo reale o su un emulatore, assicurati di aggiornare il progetto dell'applicazione o gli script di build in base alle esigenze, in modo che i file .apk compilati che utilizzano le licenze vengano distribuiti in quell'ambiente. In particolare, se sviluppi in Android Studio, assicurati di configurare una configurazione di esecuzione/debug che abbia come target il dispositivo o l'AVD appropriato.

Non è necessario apportare modifiche alla configurazione di compilazione dell'applicazione, a condizione che il progetto sia già configurato per la compilazione con una libreria Android 1.5 (livello API 3) o versioni successive standard. L'aggiunta di licenze a un'applicazione non dovrebbe avere alcun impatto sulla configurazione di compilazione dell'applicazione.

Configurazione della libreria di verifica delle licenze

Dovrai configurare LVL nel tuo ambiente di sviluppo, come progetto di libreria Android o copiando (o importando) le origini della libreria direttamente nel pacchetto dell'applicazione esistente. In generale, è consigliabile utilizzare la LVL come progetto di libreria, perché consente di riutilizzare il codice di licenza in più applicazioni e di mantenerlo nel tempo. Tieni presente che la LVL non è progettata per essere compilata separatamente e aggiunta a un'applicazione come file .jar statico.

Il modo consigliato per utilizzare la LVL è configurarla come nuovo progetto di libreria Android. Un progetto di libreria è un tipo di progetto di sviluppo che contiene codice sorgente e risorse Android condivisi. Altri progetti di app per Android possono fare riferimento al progetto di libreria e, in fase di build, includere le relative origini compilate nei file .apk. Nel contesto delle licenze, ciò significa che puoi eseguire la maggior parte dello sviluppo delle licenze una sola volta, in un progetto di libreria, per poi includere le origini della libreria nei vari progetti di applicazioni. In questo modo, puoi mantenere un'implementazione uniforme delle licenze in tutti i tuoi progetti e gestirla centralmente. Se non hai familiarità con i progetti di libreria o con il loro utilizzo, consulta Gestione dei progetti.

Se lavori in Android Studio, devi aggiungere la LVL al tuo progetto come nuovo modulo.

  1. Utilizza la finestra "Importa modulo dall'origine" per importare un modulo della libreria selezionando File > Nuovo > Importa modulo.
  2. Nella finestra Import Module from Source, in Source directory, inserisci la directory di origine library di LVL (la directory contenente il file AndroidManifest.xml della libreria) come directory principale del progetto (<sdk>/extras/google/play_licensing/library/AndroidManifest.xml), quindi seleziona Next.
  3. Seleziona Fine per importare il modulo della libreria.

Per saperne di più su come utilizzare i moduli della libreria in Android Studio, consulta Crea una libreria Android.

Includere le origini del progetto della libreria LVL nell'applicazione

Se vuoi utilizzare le origini LVL come progetto di libreria, devi aggiungere un riferimento al progetto di libreria LVL nelle proprietà del progetto dell'applicazione. In questo modo, gli strumenti di build includono le origini del progetto della libreria LVL nell'applicazione in fase di compilazione. La procedura per aggiungere un riferimento a un progetto di libreria dipende dal tuo ambiente di sviluppo, come descritto di seguito.

Se stai sviluppando in Android Studio, dovresti aver già aggiunto il modulo della libreria al tuo progetto, come descritto nella sezione precedente. Se non l'hai ancora fatto, fallo ora prima di continuare.

Se stai sviluppando utilizzando gli strumenti a riga di comando dell'SDK, vai alla directory contenente il progetto dell'applicazione e apri il file project.properties. Aggiungi una riga al file che specifica la chiave android.library.reference.<n> e il percorso della libreria. Ad esempio:

android.library.reference.1=path/to/library_project

In alternativa, puoi utilizzare questo comando per aggiornare le proprietà del progetto, incluso il riferimento al progetto della libreria:

android update lib-project
--target <target_ID> \
--path path/to/my/app_project \
--library path/to/my/library_project

Per ulteriori informazioni sull'utilizzo dei progetti di libreria, consulta Configurazione di un progetto di libreria.

Configurazione dell'ambiente di test

Google Play Console fornisce strumenti di configurazione che consentono a te e ad altri utenti di testare le licenze sulla tua applicazione prima che venga pubblicata. Durante l'implementazione delle licenze, puoi utilizzare gli strumenti di Play Console per testare le norme della tua applicazione e la gestione delle diverse risposte alle licenze e delle condizioni di errore.

I componenti principali dell'ambiente di test per le licenze includono:

  • Una configurazione "Risposta di test" nel tuo account publisher che ti consente di impostare la risposta di licenza statica restituita quando il server elabora un controllo della licenza per un'applicazione caricata nell'account publisher da un utente che ha eseguito l'accesso all'account publisher o a un account di test.
  • Un insieme facoltativo di account di test che riceveranno la risposta di test statica quando controllano la licenza di un'applicazione che hai caricato (indipendentemente dal fatto che l'applicazione sia pubblicata o meno).
  • Un ambiente di runtime per l'applicazione che include l'applicazione Google Play o il componente aggiuntivo API di Google, su cui l'utente ha eseguito l'accesso all'account editore o a uno degli account di test.

La configurazione corretta dell'ambiente di test prevede:

  1. Impostazione di risposte di test statiche restituite dal server di licenza.
  2. Configurare gli account di test in base alle esigenze.
  3. Accedere correttamente a un emulatore o dispositivo prima di avviare un test di controllo della licenza.

Le sezioni seguenti forniscono ulteriori informazioni.

Impostazione delle risposte di test per i controlli delle licenze

Google Play fornisce un'impostazione di configurazione nel tuo account publisher che ti consente di eseguire l'override della normale elaborazione di un controllo della licenza e di restituire un codice di risposta statico specificato. L'impostazione è solo per i test e si applica solo ai controlli delle licenze per le applicazioni che hai caricato, eseguiti da qualsiasi utente che ha eseguito l'accesso a un emulatore o a un dispositivo utilizzando le credenziali dell'account editore o di un account di test registrato. Per gli altri utenti, il server elabora sempre i controlli della licenza in base alle regole normali.

Per impostare una risposta di test per il tuo account, accedi al tuo account publisher e fai clic su "Modifica profilo". Nella pagina del profilo, individua il menu Risposta di test nel riquadro Licenze, mostrato di seguito. Puoi scegliere tra l'insieme completo di codici di risposta del server validi per controllare la risposta o la condizione che vuoi testare nella tua applicazione.

In generale, devi assicurarti di testare l'implementazione delle licenze della tua applicazione con ogni codice di risposta disponibile nel menu Test Response (Risposta di test). Per una descrizione dei codici, consulta Codici di risposta del server nel Riferimento per le licenze.

Figura 2. Il riquadro Test delle licenze della pagina dei dettagli dell'account ti consente di configurare gli account di test e gestire le risposte di test.

Tieni presente che la risposta di test configurata viene applicata a livello di account, ovvero non a una singola applicazione, ma a tutte le applicazioni associate all'account publisher. Se stai testando più applicazioni contemporaneamente, la modifica della risposta di test influirà su tutte queste applicazioni al successivo controllo della licenza (se l'utente ha eseguito l'accesso all'emulatore o al dispositivo utilizzando l'account editore o un account di test).

Per ricevere correttamente una risposta di test per un controllo della licenza, devi accedere al dispositivo o all'emulatore su cui è installata l'applicazione e da cui viene eseguita la query sul server. In particolare, devi accedere utilizzando il tuo account editore o uno degli account di prova che hai configurato. Per saperne di più sugli account di prova, consulta la sezione successiva.

Consulta Codici di risposta del server per un elenco delle risposte di test disponibili e dei relativi significati.

Configurazione degli account di prova

In alcuni casi, potresti voler consentire a più team di sviluppatori di testare le licenze su applicazioni che verranno pubblicate tramite il tuo account publisher, ma senza concedere loro l'accesso alle credenziali di accesso del tuo account publisher. Per soddisfare questa esigenza, Google Play Console ti consente di configurare uno o più account di test facoltativi, ovvero account autorizzati a eseguire query sul server di licenze e a ricevere risposte di test statiche dal tuo account publisher.

Gli account di test sono Account Google standard che registri nel tuo account publisher, in modo che ricevano la risposta di test per le applicazioni che hai caricato. Gli sviluppatori possono quindi accedere ai propri dispositivi o emulatori utilizzando le credenziali dell'account di test e avviare i controlli delle licenze dalle applicazioni installate. Quando il server di licenze riceve un controllo della licenza da un utente di un account di test, restituisce la risposta di test statica configurata per l'account publisher.

Naturalmente, esistono limitazioni all'accesso e alle autorizzazioni concesse agli utenti che hanno eseguito l'accesso tramite account di test, tra cui:

  • Gli utenti degli account di test possono eseguire query sul server di licenze solo per le applicazioni che sono già state caricate nell'account editore.
  • Gli utenti dell'account di prova non hanno l'autorizzazione per caricare applicazioni nel tuo account editore.
  • Gli utenti dell'account di test non dispongono dell'autorizzazione per impostare la risposta di test statica dell'account editore.

La tabella seguente riassume le differenze di funzionalità tra l'account editore, un account di test e qualsiasi altro account.

Tabella 1. Differenze nei tipi di account per i test delle licenze.

Tipo di account Posso controllare la licenza prima del caricamento? Può ricevere una risposta di test? Può impostare la risposta al test?
Account editore Sì Sì Sì
Testa l'account No Sì No
Altro No No No

Registrazione degli account di test nell'account publisher

Per iniziare, devi registrare ogni account di prova nel tuo account editore. Come mostrato nella Figura 2, registri gli account di test nel riquadro Licenze della pagina Modifica profilo del tuo account publisher. Basta inserire gli account come elenco delimitato da virgole e fare clic su Salva per salvare le modifiche al profilo.

Puoi utilizzare qualsiasi Account Google come account di prova. Se vuoi possedere e controllare gli account di test, puoi crearli tu e distribuire le credenziali ai tuoi sviluppatori o tester.

Gestione del caricamento e della distribuzione delle applicazioni per gli utenti dell'account di test

Come accennato in precedenza, gli utenti degli account di test possono ricevere solo risposte di test statiche per le applicazioni caricate nell'account editore. Poiché questi utenti non hanno l'autorizzazione per caricare applicazioni, in qualità di publisher dovrai collaborare con loro per raccogliere le app da caricare e distribuire le app caricate per i test. Puoi gestire la raccolta e la distribuzione nel modo che preferisci.

Una volta caricata un'applicazione e resa nota al server di licenza, gli sviluppatori e i tester possono continuare a modificarla nel loro ambiente di sviluppo locale, senza dover caricare nuove versioni. Devi caricare una nuova versione solo se l'applicazione locale incrementa l'attributo versionCode nel file manifest.

Distribuzione della chiave pubblica agli utenti dell'account di test

Il server di licenza gestisce le risposte di test statiche nel modo consueto, inclusa la firma dei dati della risposta di licenza e l'aggiunta di parametri aggiuntivi. Per supportare gli sviluppatori che implementano le licenze utilizzando account di test anziché l'account publisher, dovrai distribuire loro la chiave pubblica dell'app per le licenze. Gli sviluppatori che non hanno accesso a Play Console non hanno accesso alla chiave pubblica dell'app e, senza la chiave, non potranno verificare le risposte di licenza.

Tieni presente che se decidi di generare una nuova coppia di chiavi di licenza per l'app per qualche motivo, devi informare tutti gli utenti degli account di test. Per i tester, puoi incorporare la nuova chiave nel pacchetto dell'applicazione e distribuirla agli utenti. Per gli sviluppatori, dovrai distribuire la nuova chiave direttamente a loro.

Accesso a un account autorizzato nell'ambiente di runtime

Il servizio di licenza è progettato per determinare se un determinato utente è autorizzato a utilizzare una determinata applicazione. Durante un controllo della licenza, l'applicazione Google Play raccoglie l'ID utente dall'account principale sul sistema e lo invia al server, insieme al nome del pacchetto dell'applicazione e ad altre informazioni. Tuttavia, se non sono disponibili informazioni sull'utente, il controllo della licenza non può andare a buon fine, pertanto l'applicazione Google Play termina la richiesta e restituisce un errore all'applicazione.

Durante i test, per assicurarti che la tua applicazione possa eseguire correttamente query sul server di licenze, devi assicurarti di accedere a un account sul dispositivo o sull'emulatore utilizzando:

  • Le credenziali di un account publisher o
  • Le credenziali di un account di test registrato con un account editore

L'accesso con un account publisher offre il vantaggio di consentire alle tue applicazioni di ricevere risposte di test statiche anche prima che vengano caricate su Play Console.

Se fai parte di un'organizzazione più grande o lavori con gruppi esterni su applicazioni che verranno pubblicate tramite il tuo sito, è più probabile che tu voglia distribuire account di test, quindi utilizzarli per accedere durante i test.

Per accedere su un dispositivo o un emulatore, segui i passaggi riportati di seguito. L'approccio preferito è accedere come account principale. Tuttavia, se sul dispositivo o sull'emulatore sono già in uso altri account, puoi creare un account aggiuntivo e accedervi utilizzando le credenziali dell'account publisher o di test.

  1. Apri Impostazioni > Account e sincronizzazione.
  2. Seleziona Aggiungi account e scegli di aggiungere un Account Google.
  3. Seleziona Avanti e poi Accedi.
  4. Inserisci il nome utente e la password dell'account editore o di un account di prova registrato nell'account editore.
  5. Seleziona Accedi. Il sistema ti consente di accedere al nuovo account.

Una volta eseguito l'accesso, puoi iniziare a testare le licenze nella tua applicazione (se hai completato i passaggi di integrazione di LVL descritti sopra). Quando l'applicazione avvia un controllo della licenza, riceve una risposta contenente la risposta di test statica configurata nell'account editore.

Tieni presente che, se utilizzi un emulatore, dovrai accedere all'account publisher o all'account di test ogni volta che cancelli i dati quando riavvii l'emulatore.

Una volta completate le procedure di configurazione, vai alla sezione Aggiunta delle licenze all'app.