Opciones adicionales de instalación de Unity

En lugar de descargar un archivo .zip grande que contiene todos los archivos .unitypackage para .NET 3.X y .NET 4.X, puede descargar paquetes individuales desde el sitio de API de Google para Unity .

El sitio proporciona:

  • Archivos individuales .NET 4.X .unitypackage para importar como paquetes de activos.
  • Archivos .tgz individuales para importar usando Unity Package Manager.

Esto es especialmente útil cuando su aplicación utiliza un único producto de Firebase, ya que los archivos .unitypackage individuales contienen todas las dependencias necesarias y los archivos .tgz se enumeran junto con los archivos .tgz relacionados de los que dependen.

Esta página proporciona instrucciones relacionadas con el Administrador de paquetes de Unity, por lo que es una buena idea obtener información sobre la herramienta en la documentación de Unity .

Importar paquetes de Firebase como activos

Al importar productos de Firebase desde archivos .unitypackage descargados del sitio de API de Google para Unity , tenga en cuenta lo siguiente:

  • Si utiliza varios productos de Firebase en su proyecto, debe descargar y actualizar todos los productos de Firebase a la misma versión.

  • No mezcle métodos de importación en un proyecto. Es decir, no importe productos de Firebase con el flujo del paquete Asset y utilizando el flujo del Administrador de paquetes de Unity.

Después de la descarga, para importar:

  1. En su proyecto abierto de Unity, navegue hasta Activos > Importar paquete > Paquete personalizado .

  2. En la ventana Importar paquete de Unity , haga clic en Importar .

Importe paquetes de Firebase usando Unity Package Manager

Al importar productos de Firebase desde archivos .tgz descargados del archivo de API de Google para Unity , tenga en cuenta lo siguiente:

  • Este método solo está disponible en 2018.3+.

  • Si utiliza varios productos de Firebase en su proyecto, debe descargar y actualizar todos los productos de Firebase a la misma versión.

  • No mezcle métodos de importación en un proyecto. Es decir, no importe productos de Firebase con el flujo de paquetes Asset y con el flujo de Unity Package Manager.

  • Las dependencias de cada archivo .tgz de producto están vinculadas en sus propios archivos .tgz . Debe descargar e importar el archivo .tgz del producto y los archivos .tgz de dependencia, en el orden correcto:

    1. Administrador de dependencias externas ( com.google.external-dependency-manager )
    2. Núcleo de Firebase ( com.google.firebase.app )
    3. Productos Firebase utilizados en su proyecto. Si utiliza Realtime Database o Cloud Storage, primero importe la autenticación ( com.google.firebase.auth ).

Después de la descarga, importe archivos .tgz a su proyecto utilizando uno de los siguientes métodos:

Interfaz de usuario del administrador de paquetes

  1. Abra la ventana del Administrador de paquetes de Unity.
  2. Haga clic en el ícono + en la esquina superior izquierda de la ventana del Administrador de paquetes y seleccione Add package from tarball para abrir el explorador de archivos.
  3. Seleccione el tarball deseado en el explorador de archivos.

Algunas versiones anteriores de Unity 2019 no admiten la adición de archivos tar directamente. En este caso, necesitarás:

  1. Descomprime el archivo .tgz .
  2. Haga clic en el ícono + en la esquina superior izquierda de la ventana del Administrador de paquetes y seleccione Add package from disk para abrir el explorador de archivos.
  3. Seleccione la carpeta extraída en el explorador de archivos.

manifiesto.json

  1. Cree una nueva carpeta junto a la carpeta Packages de su proyecto y asígnele el nombre GooglePackages .
  2. Coloque los archivos .tgz en esa carpeta.
  3. Utilice un editor de texto para abrir Packages/manifest.json en la carpeta de su proyecto de Unity.
  4. Agregue una entrada para cada paquete que desee importar, asignando el nombre del paquete a la ubicación en el disco. Asegúrese de agregar file: a la ruta del archivo .tgz . Por ejemplo, si importaras com.google.firebase.storage y sus dependencias, tu manifest.json se vería así:

    {
      "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. Guarde el archivo manifest.json .

  6. Cuando Unity recupere el foco, recargará manifest.json e importará los paquetes recién agregados.

Algunas versiones anteriores de Unity no admiten archivos .tgz en manifest.json . En este caso, deberías:

  1. Descomprime el archivo .tgz .
  2. Edite su manifest.json para usar la ruta a la carpeta extraída, en lugar del archivo .tgz , así:

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

Migrar desde Unity Package Manager a paquetes de activos

En algunos casos, es posible que desees pasar del uso de Unity Package Manager para realizar un seguimiento de los productos de Firebase a importar productos en la carpeta Assets .

Si no está seguro de qué método de importación está utilizando, en la carpeta de su proyecto de Unity, abra el archivo Packages/manifest.json . Si el archivo contiene entradas que comienzan con com.google.firebase , su proyecto utilizó Unity Package Manager para la importación.

Para migrar a paquetes de activos:

  1. Anota las versiones actuales del paquete Firebase en tu proyecto y elimínalas.

    1. En el menú Ventana , seleccione Administrador de paquetes . En la ventana del Administrador de paquetes , asegúrese de que esté seleccionado "Paquetes: en proyecto".
    2. Tenga en cuenta las versiones de los paquetes de Firebase importados.
    3. Haga clic en el nombre de cada paquete, luego haga clic en Eliminar . Asegúrese de eliminar el paquete del Administrador de dependencia externa ( .com.google.external-dependency-manager ), así como los paquetes de Firebase.
  2. Descargue e importe archivos .unitypackage de reemplazo. Tienes dos opciones:

    • Si puede actualizar a la última versión de cada paquete, descargue el archivo zip del SDK de Firebase Unity e impórtelo como se describe en Agregar Firebase a su proyecto de Unity .
    • Si necesita conservar las versiones actuales .unitypackage , puede descargar e importar paquetes individuales como se describe arriba en esta página.

Migrar desde paquetes de activos a Unity Package Manager

En algunos casos, es posible que desee pasar de importar productos en la carpeta Assets a importar y rastrear productos con Unity Package Manager.

Si no está seguro de qué método de importación está utilizando, en la carpeta de su proyecto de Unity, abra el archivo Packages/manifest.json . Si el archivo contiene entradas que comienzan con com.google.firebase su proyecto ya utiliza Unity Package Manager para la importación.

Para migrar a Unity Package Manager:

  1. Asegúrese de que todos los paquetes de Firebase y el paquete de External Dependency Manager se eliminen de la carpeta Assets mediante cualquiera de los siguientes métodos.

    Interfaz de usuario de EDM4U

    1. En su proyecto abierto de Unity, navegue hasta Activos > Administrador de dependencias externas > Controlador de versiones > Desinstalar paquetes administrados .
    2. Seleccione todos los paquetes de Firebase y el Administrador de dependencias externas.
    3. Haga clic en Desinstalar paquete seleccionado .

    eliminación manual

    Utilizando las herramientas del sistema de archivos, elimine manualmente las siguientes carpetas:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase
  2. Importe paquetes utilizando Unity Package Manager, como se describe arriba en esta página.