Ulteriori opzioni di installazione di Unity

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

Il sito fornisce:

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

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

Questa pagina fornisce istruzioni relative a Unity Package Manager, quindi è una buona idea conoscere lo strumento dalla documentazione di Unity .

Importa pacchetti Firebase come risorse

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

  • Se utilizzi più prodotti Firebase nel tuo progetto, devi scaricare e aggiornare tutti i prodotti Firebase alla stessa versione.

  • Non mescolare metodi di importazione in un unico progetto. Vale a dire, non importare prodotti Firebase con il flusso del pacchetto Asset e utilizzando il flusso di Gestione pacchetti Unity.

Dopo il download, per importare:

  1. Nel tuo progetto Unity aperto, vai a Assets > Import Package > Custom Package .

  2. Nella finestra Importa pacchetto Unity , fare clic su Importa .

Importa pacchetti Firebase utilizzando Unity Package Manager

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

  • Questo metodo è disponibile solo nella versione 2018.3+.

  • Se utilizzi più prodotti Firebase nel tuo progetto, devi scaricare e aggiornare tutti i prodotti Firebase alla stessa versione.

  • Non mescolare metodi di importazione in un unico progetto. Vale a dire, non importare prodotti Firebase con il flusso del pacchetto Asset e con il flusso del Gestore pacchetti Unity.

  • Le dipendenze per ciascun file .tgz del prodotto sono collegate insieme nei rispettivi file .tgz . È necessario scaricare e importare il file .tgz del prodotto e i file .tgz delle dipendenze, nell'ordine corretto:

    1. Gestore delle dipendenze esterno ( com.google.external-dependency-manager )
    2. Firebase Core ( com.google.firebase.app )
    3. Prodotti Firebase utilizzati nel tuo progetto. Se utilizzi Realtime Database o Cloud Storage, importa prima l'autenticazione ( com.google.firebase.auth ).

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

Interfaccia utente del 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 dei file.
  3. Selezionare il tarball desiderato nel browser dei file.

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

  1. Decomprimere 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 dei file.
  3. Seleziona la cartella estratta nel browser dei file.

manifest.json

  1. Crea una nuova cartella accanto alla cartella Packages del tuo progetto e chiamala GooglePackages .
  2. Inserisci i file .tgz in quella 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 desideri importare, mappando il nome del pacchetto nella posizione su disco. Assicurati di aggiungere file: al percorso del file .tgz . Ad esempio, se stavi importando com.google.firebase.storage e le sue dipendenze, il tuo manifest.json sarebbe simile a questo:

    {
  "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 il focus, ricaricherà manifest.json e importerà i pacchetti appena aggiunti.

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

  1. Decomprimere il file .tgz .

  2. Modifica il tuo manifest.json per utilizzare il percorso della cartella estratta, invece 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...
  }
}

Migrazione da Unity Package Manager ai pacchetti Asset

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

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

Per eseguire la migrazione ai pacchetti Asset:

  1. Prendi nota delle versioni attuali del pacchetto Firebase nel tuo progetto e rimuovile.

    1. Dal menu Finestra , seleziona Gestione pacchetti . Nella finestra Gestione pacchetti , assicurati che "Pacchetti: nel progetto" sia selezionato.
    2. Prendi nota delle versioni dei pacchetti Firebase importati.
    3. Fare clic sul nome di ciascun pacchetto, quindi fare clic su Rimuovi . Assicurati di rimuovere il pacchetto Gestione dipendenze esterne ( .com.google.external-dependency-manager ) e i pacchetti Firebase.

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

    • Se puoi eseguire l'aggiornamento alla versione più recente di ciascun pacchetto, scarica il file zip dell'SDK Firebase Unity e importalo come descritto in Aggiungere Firebase al tuo progetto Unity .
    • Se è necessario preservare le versioni correnti .unitypackage , è possibile scaricare e importare singoli pacchetti come descritto sopra in questa pagina.

Migrazione dai pacchetti Asset a Unity Package Manager

In alcuni casi, potresti voler passare dall'importazione di prodotti nella cartella Assets all'importazione e al monitoraggio dei prodotti con Unity Package Manager.

Se non sei sicuro del metodo di importazione che stai utilizzando, nella cartella del progetto Unity, apri il file Packages/manifest.json . Se il file contiene voci che iniziano con com.google.firebase il tuo progetto sta già utilizzando Unity Package Manager per l'importazione.

Per migrare a Unity Package Manager:

  1. Assicurati che tutti i pacchetti Firebase e il pacchetto Gestione dipendenze esterne siano rimossi dalla cartella Assets , utilizzando uno dei seguenti metodi.

    Interfaccia utente EDM4U

    1. Nel progetto Unity aperto, vai a Asset > Gestione dipendenze esterne > Gestore versione > Disinstalla pacchetti gestiti .
    2. Seleziona tutti i pacchetti Firebase e il Gestore delle dipendenze esterno.
    3. Fare clic su Disinstalla pacchetto selezionato .

    Rimozione manuale

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

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

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