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.
- Hanno un'estensione
- 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.
- Hanno un'estensione
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.
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
- Crea una nuova cartella accanto alla cartella
Packages
del tuo progetto e assegnale il nomeGooglePackages
. - Inserisci i file
.tgz
in questa cartella. - Utilizza un editor di testo per aprire
Packages/manifest.json
nella cartella del progetto Unity. 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 aggiungerefile:
al percorso del file di.tgz
. Ad esempio, se stessi installandocom.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... } }
Salva il file manifest.json.
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:
- Decomprimi i file
.tgz
. - Inserisci la cartella estratta nella cartella
GooglePackages
. 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
- Apri la finestra Gestione pacchetti di Unity.
Fai clic sull'icona
+
nell'angolo in alto a sinistra della finestra Gestione pacchetti e selezionaAdd package from tarball
per aprire il browser di file.Seleziona il tarball desiderato nel browser di file.
Alcune versioni precedenti di Unity non supportano l'aggiunta diretta di tarball. In questo caso, dovrai:
- Decomprimi il file
.tgz
. Fai clic sull'icona
+
nell'angolo in alto a sinistra della finestra Gestione pacchetti e selezionaAdd package from disk
per aprire il browser di file.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:
- Gestore delle dipendenze esterno (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - Autenticazione Firebase (
com.google.firebase.auth
) - 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.
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
- Apri la finestra Gestione pacchetti di Unity.
Seleziona
In Project
nel menu a discesa in alto a sinistra.Digita
com.google
nella barra di ricerca per filtrare in base ai pacchetti di Google.Fai clic sul nome di ciascun pacchetto, quindi fai clic su
Remove
.
manifest.json
- Utilizza un editor di testo per aprire
Packages/manifest.json
nella cartella del progetto Unity. - 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".
- Elimina queste righe e salva il file JSON.
- 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:
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
inAssets
.
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.