Ulteriori opzioni di installazione di Unity

Anziché scaricare un file .zip di grandi dimensioni contenente tutti i file .unitypackage per .NET 3.X e .NET 4.X, puoi scaricare i singoli pacchetti dal sito API Google per Unity.

Il sito fornisce:

  • Singoli file .NET 4.X .unitypackage da importare come pacchetti di asset.
  • Archivi .tgz singoli da importare utilizzando Unity Package Manager.

Questo è particolarmente utile quando la tua app utilizza un singolo prodotto Firebase, poiché i singoli file .unitypackage contengono tutte le dipendenze necessarie e i file .unitypackage sono elencati insieme ai file .tgz correlati da cui dipendono.

Questa pagina fornisce istruzioni relative al gestore pacchetti Unity, quindi ti consigliamo di approfondire lo strumento nella documentazione di Unity.

Importa pacchetti Firebase come asset

Quando importi i prodotti Firebase dai file .unitypackage scaricati dal sito API di Google per Unity, tieni presente quanto segue:

  • Se utilizzi più prodotti Firebase nel tuo progetto, devi scaricare tutti i prodotti Firebase ed eseguire l'upgrade alla stessa versione.

  • Non mescolare metodi di importazione in un progetto. Vale a dire, non importare i prodotti Firebase con il flusso Pacchetti di asset e utilizzando il flusso Unity Package Manager.

Dopo il download, per eseguire l'importazione:

  1. Nel progetto Unity aperto, vai ad Asset > Importa pacchetto > Pacchetto personalizzato.

  2. Nella finestra Importa il pacchetto Unity, fai clic su Importa.

Importa i pacchetti Firebase utilizzando Unity Package Manager

Quando importi i prodotti Firebase dai file .tgz scaricati dall'archivio delle API di Google per Unity, tieni presente quanto segue:

  • Questo metodo è disponibile solo in 2018.3 e versioni successive.

  • Se utilizzi più prodotti Firebase nel tuo progetto, devi scaricare tutti i prodotti Firebase ed eseguire l'upgrade alla stessa versione.

  • Non combinare i metodi di importazione in un solo progetto. Vale a dire, non importare i prodotti Firebase con il flusso dei pacchetti di asset e con il flusso del gestore di pacchetti Unity.

  • Le dipendenze per ogni file .tgz dei prodotti sono collegate tra loro nei rispettivi file .tgz. Devi scaricare e importare il file .tgz del prodotto e i file .tgz delle dipendenze nell'ordine corretto:

    1. External Dependency Manager (com.google.external-dependency-manager)
    2. Firebase Core (com.google.firebase.app)
    3. Prodotti Firebase utilizzati nel progetto. Se utilizzi Realtime Database o Cloud Storage, importa prima Authentication (com.google.firebase.auth).

Dopo il download, importa i file .tgz nel progetto utilizzando uno dei seguenti metodi:

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 di Gestione 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 2019 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.
  3. Seleziona la cartella estratta nel browser di file.

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 da importare, mappando il nome del pacchetto alla posizione sul disco. Assicurati di aggiungere file: al percorso del file .tgz. Ad esempio, se importi com.google.firebase.storage e le sue dipendenze, manifest.json avrà il seguente aspetto:

    {
  "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. Decomprimi il file .tgz.

  2. Modifica manifest.json per 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...
  }
}

Eseguire la migrazione da Unity Package Manager ai pacchetti di asset

In alcuni casi, potresti voler passare dall'utilizzo di Unity Package Manager per monitorare i prodotti Firebase all'importazione dei prodotti nella cartella Assets.

Se non sai quale metodo di importazione stai utilizzando, apri il file Packages/manifest.json nella cartella del progetto Unity. Se il file contiene voci che iniziano con com.google.firebase, il tuo progetto ha utilizzato il gestore pacchetti Unity per l'importazione.

Per eseguire la migrazione ai pacchetti di asset:

  1. Prendi nota delle versioni attuali dei pacchetti Firebase nel tuo progetto e rimuovile.

    1. Dal menu Finestra, seleziona Gestore pacchetti. Nella finestra Package Manager, assicurati che sia selezionata l'opzione "Pacchetti: nel progetto".
    2. Prendi nota delle versioni dei pacchetti Firebase importati.
    3. Fai clic sul nome di ciascun pacchetto, quindi su Rimuovi. Assicurati di rimuovere il pacchetto External Dependency Manager (.com.google.external-dependency-manager) nonché i pacchetti Firebase.

  2. Scarica e importa i file .unitypackage sostitutivi. Sono disponibili due opzioni:

    • Se puoi eseguire l'upgrade alla versione più recente di ogni pacchetto, scarica il file ZIP dell'SDK Firebase Unity e importalo come descritto in Aggiungere Firebase al progetto Unity.
    • Se devi conservare le versioni attuali di .unitypackage, puoi scaricare e importare i singoli pacchetti come descritto sopra in questa pagina.

Eseguire la migrazione dai pacchetti di asset a Unity Package Manager

In alcuni casi, potresti voler passare dall'importazione dei prodotti nella Assets alla loro importazione e monitoraggio con Unity Package Manager.

Se non sai quale metodo di importazione stai utilizzando, apri il file Packages/manifest.json nella cartella del progetto Unity. Se il file contiene voci che iniziano con com.google.firebase, il tuo progetto utilizza già il gestore pacchetti Unity per l'importazione.

Per eseguire la migrazione al gestore di pacchetti Unity:

  1. Assicurati che tutti i pacchetti Firebase e il pacchetto External Dependency Manager siano rimossi dalla cartella Assets utilizzando uno dei seguenti metodi.

    Interfaccia utente EDM4U

    1. Nel progetto Unity aperto, vai ad Asset > Gestore dipendenze esterne > Gestore versioni > Disinstalla pacchetti gestiti.
    2. Seleziona tutti i pacchetti Firebase e External Dependency Manager.
    3. Fai clic su Disinstalla pacchetto selezionato.

    Rimozione manuale

    Utilizzando gli strumenti del file system, elimina manualmente le seguenti cartelle:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase

  2. Importa i pacchetti utilizzando Unity Package Manager, come descritto sopra in questa pagina.