Instala paquetes de Google para Unity

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

• Paquetes de elementos:
  • Tener una extensión .unitypackage.
  • Realiza la instalación en el directorio Assets de tu proyecto.
  • Se puede importar a Unity 5 y versiones posteriores.
  • Generalmente, incluye paquetes dependientes.
• Paquetes de Unity Package Manager (UPM):
  • Tener una extensión .tgz.
  • Realiza la instalación en el directorio Packages de tu proyecto.
  • Se puede importar en Unity 2018.4 y versiones posteriores.
  • Haz referencia a paquetes dependientes que se deben instalar por separado.

La página Paquetes contiene los últimos archivos .unitypackage para todos los paquetes disponibles.

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

A continuación, puedes encontrar instrucciones sobre cómo instalar ambos tipos de paquetes, junto con instrucciones de migración para realizar la transición de un 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 para Firebase.

Importa paquetes de elementos con archivos .unitypackage

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

Nota: Si ya instalaste el paquete mediante la ventana Package Manager de Unity, desinstala la versión anterior del paquete antes de importar la nueva. Consulta la siguiente información para obtener instrucciones.

Importa paquetes de UPM con archivos .tgz (2018.4 y versiones posteriores)

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

manifest.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 instalaras com.google.firebase.storage y sus dependencias, tu manifest.json se vería de la siguiente manera:

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

6. Cuando Unity recupere el foco, se volverá a cargar el archivo manifest.json y se importarán los paquetes agregados recientemente.

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

1. Descomprime los archivos .tgz.
2. Coloca la carpeta extraída en la carpeta GooglePackages.

3. Edita el archivo manifest.json para usar la ruta de acceso a la carpeta extraída en lugar del archivo .tgz, de esta 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 de Unity Package Manager.

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.

   

3. Selecciona el archivo tarball que quieras en el navegador de archivos.

Algunas versiones anteriores de Unity no admiten agregar archivos tarball directamente. En ese caso, deberás hacer lo siguiente:

1. Descomprime el archivo .tgz.

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

   

   Nota: Unity 2018 coloca el ícono + en la esquina inferior izquierda del panel de lista de paquetes.

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 del archivo, en la sección del paquete que desees.

Por ejemplo, si instalaras com.google.firebase.storage, debes 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.

Nota: Si ya instalaste el paquete con un archivo .unitypackage, asegúrate de borrar esa versión del paquete antes de agregar una nueva. Consulta la siguiente información para obtener instrucciones.

Control de versión

Si usas un 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 de forma manual los manifest.json de tu proyecto (consulta las instrucciones anteriores) y hacer referencia a archivos .tgz locales con las rutas relativas.

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

Migra de paquetes de 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 Assets.

Asegúrate de quitar todos los paquetes de Google de Unity Package Manager con cualquiera de estos métodos:

IU del administrador de paquetes

1. Abre la ventana de Unity Package Manager.

2. Selecciona In Project en el menú desplegable de la parte superior izquierda.

   

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

   

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

manifest.json

1. Usa un editor de texto para abrir Packages/manifest.json en la carpeta de tu proyecto de Unity.
2. Verifica si hay algún paquete de Google en “dependencias”. El nombre del paquete debe comenzar con “com.google”, por ejemplo, “com.google.firebase.app”.
3. Borra esas líneas y guarda el archivo JSON.
4. Cuando Unity recupere el enfoque, volverá a cargar el archivo manifest.json y quitará los paquetes borrados.

Una vez que hayas desinstalado esos paquetes de Unity Package Manager, puedes descargar e 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 productos y hacerles un seguimiento con Unity Package Manager.

Si no sabes qué método de instalación usas, en la IU de Unity, verifica si los paquetes de Google deseados aparecen en la pestaña Project, en Assets.

Para migrar a paquetes de UPM, haz lo siguiente:

1. Asegúrate de que se quiten todos los paquetes de Google de la carpeta Recursos.

   • Para desinstalar paquetes de Firebase, sigue estas instrucciones.
   • Si quieres desinstalar los complementos de Play para Unity, borra la carpeta GooglePlayPlugins en Assets.

2. Instala los paquetes con Unity Package Manager, como se describió anteriormente.

Instrucciones de migración específicas de productos

Consulta las instrucciones de Firebase aquí.