Installa i pacchetti Google per Unity

I pacchetti Google per Unity sono distribuiti in due diversi formati:

• Pacchetti di asset:
  • Avere un'estensione .unitypackage.
  • Installa il pacchetto nella directory Assets del progetto.
  • Possono essere importati in Unity 5 e versioni successive.
  • Generalmente includono i pacchetti dipendenti.
• Pacchetti Unity Package Manager (UPM):
  • Avere un'estensione .tgz.
  • Installa il pacchetto nella directory Packages del progetto.
  • Può essere importato in Unity 2018.4 e versioni successive.
  • Fai riferimento ai pacchetti dipendenti che devono essere installati separatamente.

La pagina Pacchetti contiene i file .unitypackage più recenti per tutti i pacchetti disponibili e i file .tgz per alcuni dei pacchetti.

La pagina Archivio contiene file .unitypackage e .tgz per tutte le versioni del pacchetto.

Di seguito puoi trovare le istruzioni su come installare entrambi i tipi di pacchetti, nonché le istruzioni per la migrazione da un tipo all'altro.

Una volta acquisita familiarità con queste opzioni di installazione, consulta le istruzioni specifiche per i prodotti per Firebase.

Importazione dei pacchetti utilizzando OpenUPM

Puoi aggiungere pacchetti esterni al tuo progetto Unity utilizzando il registry OpenUPM. OpenUPM ospita molti SDK e plug-in utili, come il plug-in Google Play Integrity, che aiuta a proteggere la tua app da attività fraudolente e abusi.

Ecco come aggiungere, ad esempio, il plug-in Google Play Integrity utilizzando OpenUPM.

OpenUPM-CLI

Se hai installato l'interfaccia a riga di comando OpenUPM, puoi installare il registry OpenUPM con il seguente comando:

openupm add com.google.play.integrity

OpenUPM

1. Apri le impostazioni del gestore dei pacchetti selezionato l'opzione di menu di Unity Modifica > Impostazioni progetto > Gestore dei pacchetti.

2. Aggiungi OpenUPM come registry con ambito alla finestra Gestione pacchetti:

   Name: package.openupm.com
   URL: https://package.openupm.com
   Scopes: com.google.external-dependency-manager
    com.google.play.common
    com.google.play.core
    com.google.play.integrity
   

3. Apri il menu del gestore dei pacchetti selezionando l'opzione di menu di Unity Finestra > Gestore dei pacchetti.

4. Imposta il menu a discesa Ambito gestore in modo da selezionare I miei registry.

   

5. Seleziona il pacchetto Plug-in di integrità di Google Play per Unity dall'elenco dei pacchetti e premi Installa.

Importare pacchetti di asset con file .unitypackage

Importa il file .unitypackage selezionando l'opzione del menu UnityAssets > Import package > Custom Package e importando tutti gli elementi. In questo modo, i contenuti del pacchetto vengono aggiunti al progetto nella directory Asset.

Nota: se hai già installato il pacchetto utilizzando la finestra Package Manager di Unity, disinstalla la vecchia versione del pacchetto prima di importarne la nuova. Leggi le istruzioni di seguito.

Importazione di pacchetti UPM con file .tgz (2018.4 e versioni successive)

Importa i file .tgz nel progetto utilizzando uno dei seguenti metodi:

manifest.json

1. Crea una nuova cartella accanto alla cartella Packages del progetto e assegnale il nome GooglePackages.
2. Inserisci i file .tgz in questa cartella.
3. Utilizza un editor di testo per aprire Packages/manifest.json nella cartella del progetto Unity.

4. Aggiungi una voce per ogni pacchetto che vuoi installare, mappando il nome del pacchetto alla posizione sul disco, in base al file Packages/manifest.json. Assicurati di aggiungere file: al percorso del file .tgz. Ad esempio, se installi com.google.firebase.storage e le relative dipendenze, il file manifest.json sarà simile al seguente:

   {
     "dependencies": {
       "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz",
       "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0.tgz",
       "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz",
       "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz",
       // com.unity package entries...
     }
   }
   

5. Salva il file manifest.json.

6. Quando Unity riprende lo stato attivo, ricarica il file manifest.json e importa i pacchetti appena aggiunti.

Alcune versioni precedenti di Unity non supportano i file .tgz in manifest.json. In questo caso, devi:

1. Decomprimere i file .tgz.
2. Inserisci la cartella estratta nella cartella GooglePackages.

3. Modifica il file manifest.json in modo da utilizzare il percorso della cartella estratta anziché il file .tgz, come segue:

   {
     "dependencies": {
       "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164",
       "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0",
       "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0",
       "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0",
       // com.unity package entries...
     }
   }
   

Interfaccia utente del gestore dei pacchetti

1. Apri la finestra del Gestore pacchetti di Unity.

2. Fai clic sull'icona + nell'angolo in alto a sinistra della finestra del gestore pacchetti e seleziona Add package from tarball per aprire il browser di file.

   

3. Seleziona il file tarball che ti interessa nel browser di file.

Alcune versioni precedenti di Unity non supportano l'aggiunta diretta di tarball. In questo caso, dovrai:

1. Decomprimi il file .tgz.

2. Fai clic sull'icona + nell'angolo in alto a sinistra della finestra del gestore dei pacchetti e seleziona Add package from disk per aprire il browser dei file.

   

   Nota: Unity 2018 posiziona l'icona + nell'angolo in basso a sinistra del riquadro dell'elenco dei pacchetti.

3. Seleziona la cartella estratta nel browser di file.

Assicurati di importare anche i file .tgz per le dipendenze del pacchetto, che puoi trovare elencati nella pagina dell'archivio nella sezione del pacchetto desiderato.

Ad esempio, se stai installando com.google.firebase.storage, devi installare i seguenti file com.google.firebase.storage nell'ordine seguente:.tgz

1. External Dependency Manager (com.google.external-dependency-manager)
2. Firebase Core (com.google.firebase.app)
3. Firebase Auth (com.google.firebase.auth)
4. Firebase Storage (com.google.firebase.storage)

Se preferisci aggiungere tutti i file .tgz contemporaneamente, senza preoccuparti dell'ordine, puoi seguire le istruzioni riportate nella scheda manifest.json.

Nota: se hai già installato il pacchetto con un file .unitypackage, assicurati di eliminare quella versione del pacchetto prima di aggiungerne una nuova. Leggi le istruzioni di seguito.

Controllo delle versioni

Se utilizzi un software di controllo della versione per gestire i file del progetto, ti consigliamo di aggiungere i file .tgz pertinenti al controllo della versione. Puoi modificare manualmente il file manifest.json del progetto (vedi le istruzioni precedenti) e fare riferimento ai file .tgz locali utilizzando percorsi relativi.

Se utilizzi git, ti consigliamo di utilizzare Git Large File Storage (LFS) per gestire file .tgz di grandi dimensioni.

Migrazione dai pacchetti UPM ai pacchetti di asset

In alcuni casi, potresti voler passare dall'utilizzo di Unity Package Manager per gestire i pacchetti Google all'installazione dei pacchetti nella cartella Asset.

Assicurati che tutti i pacchetti Google vengano rimossi da Unity Package Manager utilizzando uno dei seguenti metodi:

Interfaccia utente del gestore dei pacchetti

1. Apri la finestra del Gestore pacchetti di Unity.

2. Seleziona In Project nel menu a discesa in alto a sinistra.

   

3. Digita com.google nella barra di ricerca per filtrare i risultati in base ai pacchetti Google.

   

4. Fai clic su ciascun nome del pacchetto e poi su Remove.

manifest.json

1. Utilizza un editor di testo per aprire Packages/manifest.json nella cartella del progetto Unity.
2. Controlla se sono presenti pacchetti di Google nella sezione "dipendenze". Il nome del pacchetto deve iniziare con "com.google", ad esempio "com.google.firebase.app".
3. Elimina queste righe e salva il file JSON.
4. Quando Unity riprende il controllo, ricarica il file manifest.json e rimuove i pacchetti eliminati.

Dopo aver disinstallato questi pacchetti da Unity Package Manager, puoi scaricare e importare i file .unitypackage sostituti dalla pagina dell'archivio.

Migrazione dai pacchetti di asset ai pacchetti UPM

In alcuni casi, potresti voler passare dall'installazione dei prodotti nella struttura ad albero degli asset all'installazione e al monitoraggio dei prodotti con Unity Package Manager.

Se non sai quale metodo di installazione stai utilizzando, nell'interfaccia utente di Unity controlla se i pacchetti Google desiderati sono visualizzati nella scheda Progetto, in Risorse.

Per eseguire la migrazione ai pacchetti UPM:

1. Assicurati che tutti i pacchetti Google siano rimossi dalla cartella Asset.

   • Per disinstallare i pacchetti Firebase, segui queste istruzioni.
   • Per disinstallare i plug-in di Google Play per Unity, elimina la cartella GooglePlayPlugins in Assets.

2. Installa i pacchetti utilizzando Unity Package Manager, come descritto sopra.

Istruzioni di migrazione specifiche per il prodotto

Consulta questa pagina per le istruzioni su Firebase.