Catch up on highlights from Firebase at Google I/O 2023. Learn more

Opzioni di installazione aggiuntive di Unity

Anziché 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 delle API di Google per Unity .

Il sito fornisce:

  • Singoli file .NET 4.X .unitypackage da importare come pacchetti di risorse.
  • Singoli archivi .tgz 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 i pacchetti Firebase come risorse

Quando importi prodotti Firebase da file .unitypackage scaricati dal sito delle 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 i metodi di importazione in un progetto. Ovvero, non importare i prodotti Firebase con il flusso del pacchetto di risorse e utilizzando il flusso Unity Package Manager.

Dopo il download, per importare:

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

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

Importa i pacchetti Firebase utilizzando Unity Package Manager

Quando importi prodotti Firebase da file .tgz scaricati dall'archivio delle 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 i metodi di importazione in un progetto. Ovvero, non importare i prodotti Firebase con il flusso del pacchetto Asset e con il flusso Unity Package Manager.

  • Le dipendenze per ogni file .tgz del prodotto sono collegate insieme nei propri 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 di Gestione pacchetti

  1. Apri la finestra Gestione pacchetti di Unity.
  2. Fare clic sull'icona + nell'angolo in alto a sinistra della finestra Gestione pacchetti e selezionare 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. Fare clic sull'icona + nell'angolo in alto a sinistra della finestra Gestione pacchetti e selezionare 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. Metti i file .tgz in quella cartella.
  3. Utilizzare 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 alla 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 riacquista lo stato attivo, ricaricherà manifest.json e importerà i pacchetti appena aggiunti.

Alcune versioni precedenti di Unity non supportano i file .tgz in 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...
  }
}

Migrare da Unity Package Manager ai pacchetti di risorse

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

Se non sei sicuro del metodo di importazione che stai usando, 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 di 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 External Dependency Manager ( .com.google.external-dependency-manager ) così come i pacchetti Firebase.

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

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

Migrare dai pacchetti di risorse a Unity Package Manager

In alcuni casi, potresti voler passare dall'importazione dei 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 usando, 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 External Dependency Manager siano rimossi dalla cartella Assets , utilizzando uno dei seguenti metodi.

    Interfaccia utente di EDM4U

    1. Nel progetto Unity aperto, vai su Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages .
    2. Seleziona tutti i pacchetti Firebase e External Dependency Manager.
    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 i pacchetti utilizzando Unity Package Manager, come descritto sopra in questa pagina.