Installa i pacchetti Google per Unity

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

• Pacchetti di asset:
  .
  • Avere un'estensione di tipo .unitypackage.
  • Installa nella directory Assets del progetto.
  • L'importazione può essere eseguita in Unity 5 e versioni successive.
  • In genere sono inclusi i pacchetti dipendenti.
• Pacchetti Unity Package Manager (UPM):
  .
  • Avere un'estensione di tipo .tgz.
  • Installa nella directory Packages del progetto.
  • Può essere importato in Unity 2018.4 e versioni successive.
  • Fai riferimento a pacchetti dipendenti che devono essere installati separatamente.

La pagina Pacchetti contiene gli ultimi .unitypackage file per tutti i pacchetti disponibili e .tgz file per alcuni di essi.

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

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

Dopo aver preso dimestichezza con queste opzioni di installazione, consulta ulteriori istruzioni specifiche per il prodotto per Firebase.

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

Importa il file .unitypackage selezionando l'opzione di menu Unity Assets > Import package > Custom Package e importazione di tutti gli elementi. In questo modo, i contenuti del pacchetto vengono aggiunti al tuo progetto nella sezione Asset .

Nota: se hai già installato il pacchetto utilizzando Unity’s Package Manager, disinstalla la versione precedente del pacchetto prima importando quello nuovo. Consulta di seguito per istruzioni.

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

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

manifest.json

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

4. Aggiungi una voce per ogni pacchetto da installare, mappando il nome del pacchetto. alla posizione sul disco rispetto al file Packages/manifest.json. Assicurati di aggiungere file: al percorso del file .tgz. Per Ad esempio, se stavi installando com.google.firebase.storage e i suoi , 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 torna a essere attivo, ricarica il file manifest.json e importa 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 per utilizzare il percorso della cartella estratta del 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 del gestore di pacchetti

1. Apri la finestra Gestore 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 superiore sinistro di Gestione pacchetti e seleziona Add package from disk per aprire il browser di file.

   

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

3. Seleziona la cartella estratta nel browser dei file.

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

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

1. Gestore dipendenze esterno (com.google.external-dependency-manager)
2. Firebase Core (com.google.firebase.app)
3. Autorizzazione Firebase (com.google.firebase.auth)
4. Spazio di archiviazione Firebase (com.google.firebase.storage)

Se preferisci aggiungere tutti i file .tgz in una volta sola, senza preoccuparti relative all'ordine, puoi seguire le istruzioni scheda manifest.json.

Nota: se hai già installato il pacchetto con un .unitypackage assicurati di eliminare quella versione del pacchetto prima aggiungerne uno nuovo. Consulta di seguito per istruzioni.

Controllo delle versioni

Se utilizzi un software di controllo della versione per gestire i file di progetto, consiglia di aggiungere i file .tgz pertinenti al controllo della versione. Puoi eseguire manualmente modifica manifest.json del progetto (vedi vedi le istruzioni riportate sopra) e fai riferimento ai file .tgz locali utilizzando percorsi relativi.

Se utilizzi Git, ti consigliamo 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 Gestore di pacchetti Unity per gestire i pacchetti Google e installarli nella cartella Risorse.

Assicurati che tutti i pacchetti Google vengano rimossi dal gestore di pacchetti Unity utilizzando uno dei seguenti metodi:

UI del gestore di pacchetti

1. Apri la finestra 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 pacchetti Google.

   

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

manifest.json

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

Dopo avere disinstallato questi pacchetti da Unity Package Manager, puoi: scarica e importa i file .unitypackage sostitutivi dall'archivio alla pagina di destinazione.

Migrazione da pacchetti di asset a pacchetti UPM

In alcuni casi potresti voler passare dall'installazione di prodotti all'interno Struttura ad albero per l'installazione e il monitoraggio dei prodotti con il gestore pacchetti Unity.

Se non sai con certezza quale metodo di installazione stai utilizzando, nella UI di Unity: verifica che i pacchetti Google desiderati vengano visualizzati nella scheda Progetto, sotto Asset.

Per eseguire la migrazione a pacchetti UPM:

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

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

2. Installa i pacchetti utilizzando il gestore pacchetti Unity, come descritto sopra.

Istruzioni per la migrazione specifiche per i prodotti

Consulta qui le istruzioni per Firebase.