Autres options d'installation d'Unity

Plutôt que de télécharger un grand fichier .zip contenant tous les fichiers .unitypackage pour .NET 3.X et .NET 4.X, vous pouvez télécharger des packages individuels sur le site des API Google pour Unity.

Le site fournit les éléments suivants:

  • Fichiers .unitypackage .NET 4.X individuels à importer en tant que packages d'éléments.
  • Archives .tgz individuelles à importer à l'aide du Gestionnaire de packages Unity.

Cela est particulièrement utile lorsque votre application utilise un seul produit Firebase, car les fichiers .unitypackage individuels contiennent toutes les dépendances nécessaires et les fichiers .tgz sont listés à côté des fichiers .tgz associés sur lesquels ils dépendent.

Cette page fournit des instructions concernant le gestionnaire de paquets Unity. Il est donc recommandé de consulter la documentation Unity pour en savoir plus sur cet outil.

Importer des packages Firebase en tant qu'éléments

Lorsque vous importez des produits Firebase à partir de fichiers .unitypackage téléchargés sur le site des API Google pour Unity, gardez à l'esprit les points suivants:

  • Si vous utilisez plusieurs produits Firebase dans votre projet, vous devez télécharger et mettre à niveau tous les produits Firebase vers la même version.

  • Ne mélangez pas les méthodes d'importation dans un même projet. Autrement dit, n'importez pas de produits Firebase avec le flux de package d'éléments et le flux du Gestionnaire de packages Unity.

Après avoir téléchargé le fichier, procédez comme suit pour l'importer:

  1. Dans votre projet Unity ouvert, accédez à Assets (Éléments) > Import Package (Importer un package) > Custom Package (Package personnalisé).

  2. Dans la fenêtre Import Unity Package (Importer un package Unity) qui s'ouvre, cliquez sur Import (Importer).

Importer des packages Firebase à l'aide de Unity Package Manager

Lorsque vous importez des produits Firebase à partir de fichiers .tgz téléchargés depuis l'archive des API Google pour Unity, gardez à l'esprit les points suivants:

  • Cette méthode n'est disponible que dans la version 2018.3 ou ultérieure.

  • Si vous utilisez plusieurs produits Firebase dans votre projet, vous devez télécharger et mettre à niveau tous les produits Firebase vers la même version.

  • Ne mélangez pas les méthodes d'importation dans un même projet. Autrement dit, n'importez pas de produits Firebase avec le flux de package d'éléments ni avec le flux du Gestionnaire de paquets Unity.

  • Les dépendances de chaque fichier .tgz de produit sont associées dans leurs propres fichiers .tgz. Vous devez télécharger et importer le fichier .tgz du produit et les fichiers .tgz des dépendances dans l'ordre suivant:

    1. Gestionnaire de dépendances externes (com.google.external-dependency-manager)
    2. Firebase Core (com.google.firebase.app)
    3. Produits Firebase utilisés dans votre projet Si vous utilisez Realtime Database ou Cloud Storage, importez d'abord Authentication (com.google.firebase.auth).

Après le téléchargement, importez les fichiers .tgz dans votre projet à l'aide de l'une des méthodes suivantes:

UI du gestionnaire de paquets

  1. Ouvrez la fenêtre du gestionnaire de paquets d'Unity.
  2. Cliquez sur l'icône + en haut à gauche de la fenêtre du Gestionnaire de paquets, puis sélectionnez Add package from tarball pour ouvrir le navigateur de fichiers.
  3. Sélectionnez le fichier tarball souhaité dans l'explorateur de fichiers.

Certaines anciennes versions d'Unity 2019 ne permettent pas d'ajouter directement des fichiers tarballs. Dans ce cas, vous devez:

  1. Décompressez le fichier .tgz.
  2. Cliquez sur l'icône + en haut à gauche de la fenêtre du Gestionnaire de paquets, puis sélectionnez Add package from disk pour ouvrir le navigateur de fichiers.
  3. Sélectionnez le dossier extrait dans l'explorateur de fichiers.

manifest.json

  1. Créez un dossier à côté du dossier Packages de votre projet et nommez-le GooglePackages.
  2. Placez les fichiers .tgz dans ce dossier.
  3. Utilisez un éditeur de texte pour ouvrir Packages/manifest.json dans le dossier de votre projet Unity.

  4. Ajoutez une entrée pour chaque package que vous souhaitez importer, en mappant le nom du package à l'emplacement sur le disque. Veillez à ajouter file: au chemin d'accès au fichier .tgz. Par exemple, si vous importez com.google.firebase.storage et ses dépendances, votre manifest.json se présente comme suit:

    {
  "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. Enregistrez le fichier manifest.json.

  6. Lorsque Unity récupère le focus, il recharge le manifest.json et importe les packages nouvellement ajoutés.

Certaines anciennes versions d'Unity ne sont pas compatibles avec les fichiers .tgz dans le manifest.json. Dans ce cas, vous devez:

  1. Décompressez le fichier .tgz.

  2. Modifiez votre manifest.json pour utiliser le chemin d'accès au dossier extrait au lieu du fichier .tgz, comme suit:

    {
  "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...
  }
}

Migrer du Gestionnaire de paquets Unity vers les packages d'éléments

Dans certains cas, vous pouvez passer de l'utilisation du Gestionnaire de paquets Unity au suivi des produits Firebase, puis à l'importation de produits dans le dossier Assets.

Si vous ne savez pas quelle méthode d'importation vous utilisez, ouvrez le fichier Packages/manifest.json dans le dossier de votre projet Unity. Si le fichier contient des entrées commençant par com.google.firebase, votre projet a utilisé Unity Package Manager pour l'importation.

Pour migrer vers les packs d'éléments:

  1. Notez les versions actuelles des packages Firebase dans votre projet, puis supprimez-les.

    1. Dans le menu Window (Fenêtre), sélectionnez Package Manager (Gestionnaire de paquets). Dans la fenêtre Package Manager (Gestionnaire de paquets), assurez-vous que l'option "Packages: In Project" (Paquets : dans le projet) est sélectionnée.
    2. Notez les versions des packages Firebase importés.
    3. Cliquez sur chaque nom de package, puis sur Supprimer. Assurez-vous de supprimer le package External Dependency Manager (.com.google.external-dependency-manager) ainsi que les packages Firebase.

  2. Téléchargez et importez les fichiers .unitypackage de remplacement. Deux possibilités s'offrent à vous :

    • Si vous pouvez passer à la dernière version de chaque package, téléchargez le fichier ZIP du SDK Unity Firebase et importez-le comme décrit dans Ajouter Firebase à votre projet Unity.
    • Si vous devez conserver les versions actuelles de .unitypackage, vous pouvez télécharger et importer des packages individuels comme décrit ci-dessus sur cette page.

Migrer des packs d'éléments vers le Gestionnaire de paquets Unity

Dans certains cas, vous pouvez passer de l'importation de produits dans le dossier Assets à l'importation et au suivi des produits avec Unity Package Manager.

Si vous ne savez pas quelle méthode d'importation vous utilisez, ouvrez le fichier Packages/manifest.json dans le dossier de votre projet Unity. Si le fichier contient des entrées commençant par com.google.firebase, votre projet utilise déjà le gestionnaire de packages Unity pour l'importation.

Pour migrer vers le Gestionnaire de paquets Unity:

  1. Assurez-vous que tous les packages Firebase et le package du gestionnaire de dépendances externes sont supprimés du dossier Assets à l'aide de l'une des méthodes suivantes.

    Interface utilisateur EDM4U

    1. Dans votre projet Unity ouvert, accédez à Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages (Éléments > Gestionnaire de dépendances externe > Gestionnaire de versions > Désinstaller les packages gérés).
    2. Sélectionnez tous les packages Firebase et le gestionnaire de dépendances externes.
    3. Cliquez sur Désinstaller le package sélectionné.

    Suppression manuelle

    À l'aide d'outils de système de fichiers, supprimez manuellement les dossiers suivants:

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

  2. Importez des packages à l'aide du Gestionnaire de packages Unity, comme décrit ci-dessus sur cette page.