Options d'installation supplémentaires de Unity

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

Le site propose :

  • Individuelle .NET 4.X .unitypackage fichiers à installer des paquets actifs.
  • Individuels .tgz archives à installer Unity Package Manager.

Ceci est particulièrement utile lorsque votre application utilise un seul produit Firebase, puisque l'individu .unitypackage fichiers contiennent toutes les dépendances nécessaires, et les .tgz fichiers sont à côté connexes .tgz fichiers dont ils dépendent.

Cette page fournit des instructions concernant l' unité Package Manager, il est donc une bonne idée d' en apprendre davantage sur l'outil de la documentation Unity .

Installer les packages Firebase en tant qu'actifs

Lors de l' installation des produits Firebase de .unitypackage fichiers téléchargés à partir des API Google pour le site Unity , gardez à l' esprit les éléments 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'installation dans un même projet. Autrement dit, n'installez pas les produits Firebase avec le flux de package d'actifs et en utilisant le flux Unity Package Manager.

Après le téléchargement, pour installer :

  1. Dans votre projet open Unity, accédez à l' actif> Importer le package> Package personnalisé.

  2. Dans la fenêtre d' importation Package unité, cliquez sur Importer.

Installer les packages Firebase à l'aide du gestionnaire de packages Unity

Lors de l' installation des produits Firebase de .tgz fichiers téléchargés à partir des API Google pour l' unité des archives , gardez à l' esprit les éléments suivants:

  • Cette méthode n'est disponible qu'en 2018.3+.

  • 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'installation dans un même projet. Autrement dit, n'installez pas les produits Firebase avec le flux de package d'actifs et avec le flux Unity Package Manager.

  • Dépendances pour chaque produit .tgz fichier sont liés à côté dans leurs propres .tgz fichiers. Vous devez télécharger et installer le produit .tgz fichier et la dépendance .tgz fichiers, dans l'ordre:

    1. Gestionnaire Dépendance externe ( com.google.external-dependency-manager )
    2. Firebase de base ( com.google.firebase.app )
    3. Produits Firebase utilisés dans votre projet. Si vous utilisez la base de données en temps réel ou Cloud Storage, installez l' authentification ( com.google.firebase.auth ) d' abord.

Après le téléchargement, l' importation .tgz fichiers dans votre projet en utilisant l' une des méthodes suivantes:

Interface utilisateur du gestionnaire de packages

  1. Ouvrez la fenêtre Gestionnaire de packages de Unity.
  2. Cliquez sur le + icône dans le coin supérieur gauche de la fenêtre Package Manager et sélectionnez Add package from tarball un Add package from tarball à Add package from tarball pour ouvrir le navigateur de fichiers.
  3. Sélectionnez l'archive tar souhaitée dans le navigateur de fichiers.

Certaines anciennes versions d'Unity 2019 ne prennent pas en charge l'ajout direct d'archives tar. Dans ce cas, vous devrez :

  1. Décompressez le .tgz fichier.
  2. Cliquez sur le + icône dans le coin supérieur gauche de la fenêtre Package Manager et sélectionnez Add package from disk à Add package from disk du Add package from disk pour ouvrir le navigateur de fichiers.
  3. Sélectionnez le dossier extrait dans le navigateur de fichiers.

manifest.json

  1. Créer un nouveau dossier à côté de votre projet Packages dossier et nommez - le GooglePackages .
  2. Placez les .tgz fichiers dans ce dossier.
  3. Utilisez un éditeur de texte pour ouvrir Packages/manifest.json dans votre dossier de projet Unity.
  4. Ajoutez une entrée pour chaque package que vous souhaitez installer, en mappant le nom du package à l'emplacement sur le disque. Assurez - vous de append file: au .tgz chemin du fichier. Par exemple, si vous installez com.google.firebase.storage et ses dépendances de la, votre manifest.json ressemblerait à ceci:

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

  6. Lorsque Regagne Unity se concentrer , il rechargera le manifest.json et importer les paquets nouvellement ajoutés.

Certaines versions plus anciennes de l' unité ne prennent pas en charge .tgz fichiers dans le manifest.json . Dans ce cas, vous devez :

  1. Décompressez le .tgz fichier.
  2. Modifier votre manifest.json pour utiliser le chemin d'accès au dossier extrait, au lieu du .tgz fichier, 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 de Unity Package Manager vers des packages d'actifs

Dans certains cas, vous pouvez passer d'Unity Package Manager pour le suivi des produits Firebase, à l' installation de produits sous l' Assets dossier.

Si vous n'êtes pas sûr de la méthode d' installation que vous utilisez, dans votre dossier de projet Unity, ouvrez le fichier Packages/manifest.json . Si le fichier contient des entrées commençant par com.google.firebase , votre projet Unity utilisé Package Manager pour l' installation.

Pour migrer vers des packages d'éléments :

  1. Notez les versions actuelles du package Firebase dans votre projet et supprimez-les.

    1. Dans le menu Fenêtre, sélectionnez Gestionnaire de package. Dans la fenêtre Package Manager, assurez - vous « Paquets: Projet In » est sélectionné.
    2. Notez les versions des packages Firebase installés.
    3. Cliquez sur chaque nom de package, puis cliquez sur Supprimer. Assurez - vous de supprimer le paquet de dépendance externe Manager ( .com.google.external-dependency-manager ) ainsi que des forfaits Firebase.
  2. Télécharger et remplacement des importations .unitypackage fichiers. Vous avez deux options :

    • Si vous pouvez passer à la dernière version de chaque paquet, téléchargez le fichier zip Unity Firebase SDK et installer comme décrit dans Ajouter Firebase à votre projet Unity .
    • Si vous devez conserver en cours .unitypackage versions, vous pouvez télécharger et installer des paquets individuels comme décrit ci - dessus sur cette page.

Migrer des packages d'actifs vers Unity Package Manager

Dans certains cas, vous pouvez passer de l' installation des produits sous les Assets dossier pour l' installation et le suivi des produits avec Unity Package Manager.

Si vous n'êtes pas sûr de la méthode d' installation que vous utilisez, dans votre dossier de projet Unity, ouvrez le fichier Packages/manifest.json . Si le fichier contient des entrées commençant par com.google.firebase votre projet utilise déjà Unity Package Manager pour l' installation.

Pour migrer vers Unity Package Manager :

  1. Assurez - vous que tous les paquets Firebase et le package de dépendance externe Manager sont retirés de l' Assets dossier, en utilisant l'une des méthodes suivantes.

    Interface utilisateur du gestionnaire de packages

    1. Dans votre projet open Unity, accédez à l' actif> Gestionnaire de Dépendance externe> Version gestionnaire> Désinstaller Managed packages.
    2. Sélectionnez tous les packages Firebase et External Dependency Manager.
    3. Cliquez sur Désinstaller package sélectionné.

    Suppression manuelle

    À l'aide des outils du 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. Installez les paquets en utilisant Unity Package Manager, comme décrit ci - dessus sur cette page.