Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Opciones adicionales de instalación de Unity

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En lugar de descargar un gran archivo .zip 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 .unitypackage individuales de .NET 4.X para importar como paquetes de recursos.
  • Archivos .tgz individuales para importar usando Unity Package Manager.

Esto es especialmente útil cuando su aplicación usa un solo 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 Unity Package Manager, 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 usa 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 de activos y usando el flujo de Unity Package Manager.

Después de descargar, para importar:

  1. En su proyecto de Unity abierto, vaya a Activos > Importar paquete > Paquete personalizado .

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

Importar paquetes de Firebase usando Unity Package Manager

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

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

  • Si usa 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 de activos 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 de Firebase utilizados en su proyecto. Si usa 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 usando uno de los siguientes métodos:

Interfaz de usuario del administrador de paquetes

  1. Abra la ventana 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 tarballs directamente. En este caso, deberá:

  1. Descomprima 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. Use un editor de texto para abrir Packages/manifest.json en su carpeta de 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 estuviera importando com.google.firebase.storage y sus dependencias, su 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, volverá a cargar manifest.json e importará los paquetes recién agregados.

Algunas versiones anteriores de Unity no admiten archivos .tgz en manifest.json . En este caso, usted debe:

  1. Descomprima 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 de Unity Package Manager a paquetes de activos

En algunos casos, es posible que desee cambiar de usar 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á usando, 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 usó Unity Package Manager para la importación.

Para migrar a paquetes de activos:

  1. Tenga en cuenta las versiones actuales del paquete de Firebase en su proyecto y elimínelas.

    1. En el menú Ventana , seleccione Administrador de paquetes . En la ventana 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 dependencias externas ( .com.google.external-dependency-manager ), así como los paquetes de Firebase.

  2. Descargue e importe archivos .unitypackage reemplazo. Tienes dos opciones:

    • Si puede actualizar a la versión más reciente 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 de .unitypackage , puede descargar e importar paquetes individuales como se describe anteriormente en esta página.

Migrar de paquetes de activos a Unity Package Manager

En algunos casos, es posible que desee cambiar de la importación de productos en la carpeta Assets a la importación y el seguimiento de productos con Unity Package Manager.

Si no está seguro de qué método de importación está usando, 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 está usando 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 del Administrador de dependencias externas se eliminen de la carpeta Assets mediante cualquiera de los siguientes métodos.

    Interfaz de usuario del administrador de paquetes

    1. En su proyecto de Unity abierto, vaya a 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

    Con 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 usando Unity Package Manager, como se describe anteriormente en esta página.