Installa i pacchetti Google per Unity

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

• Pacchetti di asset:
  • Hanno un'estensione .unitypackage.
  • Esegui l'installazione nella directory Assets del progetto.
  • Può essere importato in Unity 5 e versioni successive.
  • In genere includono pacchetti dipendenti.
• Pacchetti di gestione dei pacchetti Unity (UPM):
  • Hanno un'estensione .tgz.
  • Esegui l'installazione 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.

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

Di seguito sono riportate le istruzioni su come installare entrambi i tipi di pacchetti, oltre a istruzioni per la migrazione per eseguire la transizione da un tipo all'altro.

Una volta che avrai acquisito familiarità con queste opzioni di installazione, assicurati di consultare ulteriori istruzioni specifiche del prodotto per Firebase.

Importazione di pacchetti di asset con .unitypackage file in corso...

Importa il file .unitypackage selezionando l'opzione di menu Unity Assets > Import package > Custom Package e importa 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 Gestione pacchetti di Unity, disinstalla la versione precedente prima di importare quella nuova. Leggi le istruzioni di seguito.

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

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

manifest.json

1. Crea una nuova cartella accanto alla cartella Packages del tuo 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 da installare, mappando il nome del pacchetto al percorso sul disco relativo al file Packages/manifest.json. Assicurati di aggiungere file: al percorso del file di .tgz. Ad esempio, se stessi installando com.google.firebase.storage e le sue dipendenze, il file manifest.json sarebbe 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 sarà nuovamente attivo, ricarica il file manifest.json e importerà i pacchetti appena aggiunti.

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

1. Decomprimi 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, in questo modo:

   {
     "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...
     }
   }
   

UI gestore pacchetti

1. Apri la finestra Gestione pacchetti di Unity.

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

   

3. Seleziona il tarball desiderato 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 Gestione pacchetti e seleziona Add package from disk per aprire il browser di file.

   

   Nota: per Unity 2018, l'icona + viene posizionata 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, elencati nella pagina dell'archivio nella sezione del pacchetto desiderato.

Ad esempio, se installi com.google.firebase.storage, devi installare questi file .tgz nel seguente ordine:

1. Gestore delle dipendenze esterno (com.google.external-dependency-manager)
2. Firebase Core (com.google.firebase.app)
3. Autenticazione Firebase (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 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 per il controllo della versione per gestire i file di progetto, ti consigliamo di aggiungere i file .tgz pertinenti al controllo della versione. Puoi modificare manualmente l'oggetto manifest.json del progetto (consulta le istruzioni sopra) e fare riferimento a file .tgz locali utilizzando percorsi relativi.

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

Migrazione da pacchetti UPM a pacchetti di asset

In alcuni casi, potresti voler passare dall'utilizzo di Gestione pacchetti Unity 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:

UI gestore pacchetti

1. Apri la finestra Gestione 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 in base ai pacchetti di Google.

   

4. Fai clic sul nome di ciascun pacchetto, quindi fai clic su Remove.

manifest.json

1. Utilizza un editor di testo per aprire Packages/manifest.json nella cartella del progetto Unity.
2. Controlla se ci sono 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 sarà nuovamente attivo, ricaricherà il file manifest.json e rimuoverà i pacchetti eliminati.

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

Migrazione da pacchetti di asset a 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 il gestore di pacchetti Unity.

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

Per eseguire la migrazione ai pacchetti UPM:

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

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

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

Istruzioni per la migrazione specifiche del prodotto

Consulta questa pagina per le istruzioni di Firebase.