Instala paquetes de Google para Unity

Los paquetes de Google para Unity se distribuyen en dos formatos diferentes:

  • Paquetes de elementos:
    • Tienen una extensión de .unitypackage.
    • Instala en el directorio Assets de tu proyecto.
    • Se puede importar en Unity 5 y versiones posteriores.
    • Incluye generalmente paquetes dependientes.
  • Paquetes de Unity Package Manager (UPM):
    • Tienen una extensión de .tgz.
    • Instala en el directorio Packages de tu proyecto.
    • Se puede importar en Unity 2018.4 y versiones posteriores.
    • Referencia a paquetes dependientes que se deben instalar por separado.

La página Paquetes contiene los archivos .unitypackage más recientes de todos los paquetes disponibles.

La página Archivo contiene los archivos .unitypackage y .tgz para todas las versiones de paquetes.

A continuación, encontrarás instrucciones para instalar ambos tipos de paquetes, junto con instrucciones de migración para pasar del tipo a otro.

Una vez que estés familiarizado con estas opciones de instalación, asegúrate de consultar las instrucciones específicas del producto adicionales para Firebase.

Importando archivos Asset con .unitypackage archivos

Para importar el archivo .unitypackage, selecciona la opción Assets > Import package > Custom Package del menú de Unity y, luego, importa todos los elementos. Esto agrega el contenido del paquete a tu proyecto en el directorio Assets.

Importa paquetes de UPM con archivos .tgz (2018.4+)

Importa archivos .tgz a tu proyecto mediante uno de los siguientes métodos:

manifiesto.json

  1. Crea una carpeta nueva junto a la carpeta Packages de tu proyecto y asígnale el nombre GooglePackages.
  2. Coloca los archivos .tgz en esa carpeta.
  3. Usa un editor de texto para abrir Packages/manifest.json en la carpeta de tu proyecto de Unity.
  4. Agrega una entrada para cada paquete que desees instalar y asigna el nombre del paquete a la ubicación en el disco, en relación con el archivo Packages/manifest.json. Asegúrate de agregar file: a la ruta de acceso del archivo .tgz. Por ejemplo, si instalas com.google.firebase.storage y sus dependencias, tu manifiesto.json tendrá el siguiente aspecto:

    {
      "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, se volverá a cargar el manifiesto.json y se importarán los paquetes recién agregados.

Algunas versiones anteriores de Unity no admiten archivos .tgz en el archivo manifest.json. En este caso, debes hacer lo siguiente:

  1. Descomprime los archivos .tgz.
  2. Coloca la carpeta extraída en la carpeta GooglePackages.
  3. Edita tu manifiesto.json para usar la ruta de acceso a la carpeta extraída, en lugar del archivo .tgz, de la siguiente manera:

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

IU del administrador de paquetes

  1. Abre la ventana del Administrador de paquetes de Unity.
  2. Haz clic en el ícono + en la esquina superior izquierda de la ventana del Administrador de paquetes y selecciona Add package from tarball para abrir el navegador de archivos.

    Captura de pantalla de la ventana de Unity Package Manager con el

  3. Selecciona el archivo comprimido deseado en el navegador de archivos.

Algunas versiones anteriores de Unity no admiten la adición directa de archivos comprimidos. En este caso, deberá hacer lo siguiente:

  1. Descomprime el archivo .tgz.
  2. Haz clic en el ícono + en la esquina superior izquierda de la ventana de Package Manager y selecciona Add package from disk para abrir el navegador de archivos.

    Captura de pantalla de la ventana de Unity Package Manager con el

  3. Selecciona la carpeta extraída en el navegador de archivos.

Asegúrate de importar también los archivos .tgz para las dependencias del paquete, que puedes encontrar en la página de archivos de la sección del paquete deseado.

Por ejemplo, si estuvieras instalando com.google.firebase.storage, deberías instalar estos archivos .tgz en el siguiente orden:

  1. External Dependency Manager (com.google.external-dependency-manager)
  2. Firebase Core (com.google.firebase.app)
  3. Firebase Auth (com.google.firebase.auth)
  4. Firebase Storage (com.google.firebase.storage)

Si prefieres agregar todos los archivos .tgz a la vez, sin preocuparte por el orden, puedes seguir las instrucciones de la pestaña manifest.json.

Control de versión

Si usas software de control de versión para administrar los archivos de tu proyecto, te recomendamos que agregues los archivos .tgz relevantes al control de versión. Puedes editar manualmente el manifest.json de tu proyecto (consulta las instrucciones anteriores) y hacer referencia a archivos .tgz locales mediante rutas relativas.

Si usas git, te recomendamos Git Large File Storage (LFS) para administrar archivos .tgz grandes.

Cómo migrar de paquetes UPM a paquetes de elementos

En algunos casos, es posible que quieras dejar de usar Unity Package Manager para administrar paquetes de Google y comenzar a instalar paquetes en la carpeta Elementos.

Asegúrate de que todos los paquetes de Google se quiten de Unity Package Manager con uno de los siguientes métodos:

IU del administrador de paquetes

  1. Abre la ventana del Administrador de paquetes de Unity.
  2. Selecciona In Project en el menú desplegable de la parte superior izquierda.

    Captura de pantalla de la ventana de Unity Package Manager con el

  3. Escribe com.google en la barra de búsqueda para filtrar los paquetes de Google.

    Captura de pantalla de la ventana de Unity Package Manager con

  4. Haz clic en el nombre de cada paquete y, luego, en Remove.

manifiesto.json

  1. Usa un editor de texto para abrir Packages/manifest.json en la carpeta de tu proyecto de Unity.
  2. Comprueba si hay paquetes de Google en "dependencias". El nombre del paquete debe comenzar con “&comt;com.google”.
  3. Borra esas líneas y guarda el archivo json.
  4. Cuando Unity recupere el foco, se volverá a cargar el archivo manifest.json y se quitarán los paquetes borrados.

Una vez que hayas desinstalado esos paquetes de Unity Package Manager, puedes descargar y, luego, importar archivos .unitypackage de reemplazo desde la página de archivo.

Migra de paquetes de elementos a paquetes de UPM

En algunos casos, es posible que quieras dejar de instalar productos en el árbol de recursos y comenzar a instalar y hacer un seguimiento de los productos con Unity Package Manager.

Si no estás seguro del método de instalación que usas, en la IU de Unity, comprueba si los paquetes de Google deseados aparecen en la pestaña Proyectos.

Sigue estos pasos para migrar a paquetes de UPM:

  1. Asegúrate de quitar todos los paquetes de Google de la carpeta Elementos.

    • Para desinstalar paquetes de Firebase, sigue estas instrucciones.
    • A fin de desinstalar los complementos de Play para Unity, borra la carpeta GooglePlayPlugins en Assets.
  2. Instala los paquetes con Unity Package Manager como se describió antes.

Instrucciones para la migración específicas del producto

Haga clic aquí para obtener instrucciones de Firebase.