Instala paquetes de Google para Unity

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

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

La página Packages contiene los últimos .unitypackage archivos para todos los paquetes disponibles y archivos .tgz para algunos de los paquetes.

La página Archivo contiene archivos .unitypackage y .tgz para todas las versiones del paquete.

A continuación, encontrarás instrucciones para instalar ambos tipos de paquetes, junto con con instrucciones de migración para hacer la transición de un tipo a otro.

Una vez que te familiarices con estas opciones de instalación, asegúrate de consultar instrucciones específicas del producto adicionales para Firebase.

Importa paquetes de recursos con archivos .unitypackage

Selecciona la opción del menú de Unity para importar el archivo .unitypackage. Assets > Import package > Custom Package e importando todos los elementos. De esta forma, se agregará el contenido del paquete a tu proyecto en la sección Recursos .

Nota: Si ya instalaste el paquete con el paquete de Unity Ventana del administrador, desinstala la versión anterior del paquete antes importando el nuevo. Consulta la siguiente información para obtener instrucciones.

Importación de paquetes de UPM con archivos .tgz (2018.4+)

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 un nombre GooglePackages
2. Coloca los archivos .tgz en esa carpeta.
3. Usa un editor de texto para abrir Packages/manifest.json en tu proyecto de Unity carpeta.

4. Agrega una entrada para cada paquete que quieras 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 del archivo .tgz. Para Por ejemplo, si instalas com.google.firebase.storage y su 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. Guarda el archivo manifest.json.

6. Cuando Unity recupere el enfoque, volverá a cargar el archivo manifest.json y, luego, importará 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. 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 de Unity Package Manager.

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

   

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

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

1. Descomprime el archivo .tgz.

2. Haz clic en el ícono + ubicado en la esquina superior izquierda 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 de la 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 de archivo debajo de a la sección del paquete deseado.

Por ejemplo, si instalaras com.google.firebase.storage, tendrías que hacer lo siguiente: instala 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 sobre el pedido, puedes seguir las instrucciones pestaña manifest.json.

Nota: Si ya instalaste el paquete con un .unitypackage asegúrate de borrar esa versión del paquete antes 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, se recomienda agregar los archivos .tgz relevantes al control de versión. Puedes edita el manifest.json de tu proyecto (consulta de las instrucciones anteriores) y hacer referencia a los archivos .tgz locales mediante las rutas de acceso relativas.

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

Migra de paquetes de UPM a paquetes de recursos

En algunos casos, es posible que quieras dejar de usar Unity Package Manager desde la administración de paquetes de Google hasta la instalación de paquetes en la carpeta Assets.

Asegúrate de que se quiten todos los paquetes de Google de Unity Package Manager con cualquiera de los siguientes 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 tu proyecto de Unity carpeta.
2. Verifica si hay paquetes de Google en "dependencias". El 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 lo quitará los paquetes borrados.

Una vez que hayas desinstalado esos paquetes de Unity Package Manager, puedes descarga e importa los archivos .unitypackage de reemplazo del archivo .

Migra de paquetes de recursos a paquetes de UPM

En algunos casos, es posible que desees dejar de instalar productos en el Árbol de recursos para instalar productos y hacerles un seguimiento con Unity Package Manager.

Si no sabes qué método de instalación estás usando, en la IU de Unity, haz lo siguiente: comprobar si los paquetes de Google deseados aparecen en la pestaña Project, en Recursos.

Sigue estos pasos para migrar a paquetes de UPM:

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

   • Sigue estos pasos para desinstalar paquetes de Firebase: estas instrucciones.
   • Para desinstalar los complementos de Play para Unity, borra la carpeta GooglePlayPlugins. por debajo de Assets.

2. Instala los paquetes con Unity Package Manager, como se describe. más arriba.

Instrucciones de migración específicas del producto

Consulta las instrucciones de Firebase aquí.