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 puede importar en Unity 5 y versiones posteriores.
  • Por lo general, incluyen paquetes dependientes.
• Paquetes de Unity Package Manager (UPM):
  • Tener una extensión .tgz
  • Instala en el directorio Packages de tu proyecto.
  • Se puede importar en Unity 2018.4 y versiones posteriores.
  • Hace referencia a paquetes dependientes que deben instalarse por separado.

La página Packages contiene los archivos .unitypackage más recientes para todos los paquetes disponibles y los archivos .tgz para algunos de los paquetes.

La página Archivo contiene 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 de un tipo al otro.

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

Cómo importar paquetes con OpenUPM

Puedes agregar paquetes externos a tu proyecto de Unity con el registro de OpenUPM. OpenUPM aloja muchos complementos y SDKs útiles, como el complemento Google Play Integrity, que ayuda a proteger tu app del fraude y el abuso.

A continuación, te mostramos cómo agregar, por ejemplo, el complemento de Google Play Integrity con OpenUPM.

OpenUPM-CLI

Si tienes instalada la CLI de OpenUPM, puedes instalar el registro de OpenUPM con el siguiente comando:

openupm add com.google.play.integrity

OpenUPM

1. Para abrir la configuración del administrador de paquetes, selecciona la opción de menú de Unity Edit > Project Settings > Package Manager.

2. Agrega OpenUPM como un registro con alcance a la ventana del Administrador de paquetes:

   Name: package.openupm.com
   URL: https://package.openupm.com
   Scopes: com.google.external-dependency-manager
    com.google.play.common
    com.google.play.core
    com.google.play.integrity
   

3. Para abrir el menú del administrador de paquetes, selecciona la opción de menú de Unity Window > Package Manager.

4. Establece el menú desplegable de alcance del administrador para seleccionar Mis registros.

   

5. Selecciona el paquete Google Play Integrity plugin for Unity de la lista de paquetes y presiona Install.

Importa paquetes de recursos con archivos .unitypackage

Importa el archivo .unitypackage. Para ello, selecciona la opción del 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 de activos.

Nota: Si ya instalaste el paquete con la ventana de Package Manager de Unity, desinstala la versión anterior del paquete antes de importar el nuevo. Consulta más abajo para obtener instrucciones.

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

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

manifest.json

1. Crea una carpeta nueva junto a la carpeta Packages de tu proyecto y nómbrala GooglePackages.
2. Coloca los archivos .tgz en ella.
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 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 de acceso del archivo .tgz. Por ejemplo, si quieres instalar com.google.firebase.storage y sus dependencias, tu manifest.json tendría 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. Guarda el archivo manifest.json.

6. Cuando Unity vuelva a estar en primer plano, se volverá a cargar el manifest.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 archivo manifest.json para usar la ruta de acceso a la carpeta extraída en vez 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 de Package Manager

1. Abre la ventana de Unity Package Manager.

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

Por ejemplo, si instalaras com.google.firebase.storage, instalarías 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 uno nuevo. Consulta más abajo para obtener instrucciones.

Control de versión

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

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

Cómo migrar de paquetes de UPM a paquetes de recursos

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 los siguientes métodos:

IU de Package Manager

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 vuelva a estar en primer plano, 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 e importar archivos .unitypackage de reemplazo desde la página del archivo.

Cómo migrar de paquetes de recursos a paquetes de UPM

En algunos casos, tal vez quieras dejar de instalar productos en el árbol de recursos y comenzar a instalar y supervisar los productos 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.

Sigue estos pasos para migrar a paquetes de UPM:

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

   • Para desinstalar los paquetes de Firebase, sigue estas instrucciones.
   • Para 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 del producto

Consulta aquí para obtener instrucciones sobre Firebase.