Introducción con Unity

  • Artículo
  • 2 minutos para leer

El SDK App Center usa una arquitectura modular para que pueda usar cualquiera o todos los servicios.

Vamos a empezar y a configurar el SDK App Center Unity para usar App Center Analytics y bloqueos. Para agregar App Center Distribute a la aplicación, consulte la documentación de App Center Distribute.

1. Prerrequisitos

Antes de empezar, asegúrese de que el proyecto está configurado en Unity 2018.1 o posterior.

El SDK App Center para Unity admite las siguientes plataformas:

  • iOS (9.0 o posterior)
  • Android (5.0/API 21 o posterior)
  • UWP (compilación 16299 o posterior)

Nota

La versión del entorno de ejecución de scripting de .NET 3.5 y el back-end de scripting de .NET ya no se admiten en la plataforma UWP.

Para obtener información sobre cómo usar coroutinas o devoluciones de llamada en lugar de con back-end, consulte las API asincrónicas en la sección SDK de async/await .NET 3.5 Unity de la documentación.

Además, el SDK App Center para Unity solo está disponible en C#.

2. Creación de la aplicación en App Center Portal para adquirir el secreto de la aplicación

Si ya ha creado la aplicación en el portal App Center, puede omitir este paso.

  1. Diríjase a appcenter.ms.
  2. Regístrese o inicie sesión en App Center.
  3. Haga clic en el botón azul de la esquina superior derecha del portal que dice Agregar nuevo y seleccione Agregar nueva aplicación en el menú desplegable.
  4. Escriba un nombre y una descripción opcional para la aplicación.
  5. Seleccione el sistema operativo y la plataforma adecuados en función del proyecto, tal y como se ha descrito anteriormente.
  6. Haga clic en el botón Agregar nueva aplicación en la parte inferior derecha de la página.

Una vez que haya creado una aplicación, puede obtener su secreto de aplicación en la Configuración del portal App Center aplicación. En la esquina superior derecha de la página Configuración, haga clic en los puntos verticales triples y Copy app secret seleccione para obtener el secreto de la aplicación.

3. Agregue el SDK App Center al proyecto.

3a Instalar el editor de extensiones

El SDK App Center se integra mediante la importación de paquetes de Unity en el proyecto. Para ello, primero instale el complemento App Center extensiones del editor de Unity. Abra las extensiones del editor mediante el menú unity: Window > App Center > Editor Extensions (Extensiones del editor de App Center editor) y seleccione "Install App Center SDK" (Instalar App Center SDK).

Nota

En las versiones 2019.1.2f1 y posteriores de Unity, podría haber errores en los registros durante la instalación, como Coroutine continue failure . Es un problema conocido de Unity y debe omitirlo.

3.1b Instalar paquetes individuales

Como alternativa, cada uno de los paquetes individuales de Unity se puede descargar e importar. Se encuentran en la página de App Center sdk GitHub Unity. Descargue la versión más reciente de los paquetes que desea usar. Su nombre debe tener el formato AppCenter{Analytics/Crashes/Distribute}-v{version}.unitypackage.

3.2b Importar el paquete

Abra el proyecto de Unity y haga doble clic en el paquete que descargó. Debe aparecer una ventana emergente en el proyecto de Unity que contenga una lista de archivos. Seleccione Importar y el SDK se agregará al proyecto. Repita este paso para cada paquete que descargó y planee usar en el proyecto.

3.3 Si usa la copia de seguridad automática para evitar obtener información incorrecta sobre el dispositivo, siga estos pasos:

Nota

Las aplicaciones destinadas a Android 6.0 (nivel de API 23) o superior tienen la copia de seguridad automática habilitada automáticamente.

Nota

Si ya tiene un archivo personalizado con regla de copia de seguridad, cambie al tercer paso.

a. Cree appcenter_backup_rule.xml archivo en la carpeta Assets/Plugins/Android/res/xml.

b. Abra el archivo de AndroidManifest.xmlproyecto. Agregue el android:fullBackupContent atributo al <application> elemento . Debe apuntar al archivo appcenter_backup_rule.xmlde recursos.

Nota

Si aún no tiene su propio archivoAndroidManifest.xml, cándalo en la carpeta Assets/Plugins/Android. Este manifiesto se combinará con el predeterminado creado por Unity en el momento de la compilación.

android:fullBackupContent="@xml/appcenter_backup_rule"

c. Agregue las siguientes reglas de copia de seguridad alappcenter_backup_rule.xml archivo:

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
    <exclude domain="sharedpref" path="AppCenter.xml"/>
    <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
    <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
    <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
    <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
</full-backup-content>

4. Habilitación del SDK

4.1 Crear un objeto de juego vacío

App Center funciona como un componente que se asocia a un objeto de juego en la escena en la que se inicia el juego. Vaya a esta escena y agregue un objeto de juego vacío. Asíétele un nombre descriptivo, como "App Center".

4.2 Asociación del script App Center script

En la Project, vaya a la carpeta "AppCenter" que se agregó al proyecto. Busque el script, denominado AppCenterBehavior, y arrástrelo al objeto de juego recién creado en la ventana Jerarquía.

Nota

No es necesario agregar App Center a todas las escenas en las que quiera usarla. Agregarla a la primera escena cargada es suficiente.

4.3 Configuración de App Center configuración

Haga clic en este nuevo objeto "App Center" y agregue los secretos de la aplicación a los campos correspondientes en la ventana Inspector. Asegúrese también de marcar las casillas "Use {service}" (Usar {service}) para cada App Center servicio que desea usar.

App Center de script

Nota

Si el proyecto no admite una de las tres plataformas enumeradas en la configuración, deje el campo de secreto de aplicación tal y como está. no tendrá ningún efecto. Si el proyecto admite plataformas App Center no admite, las API y la configuración no tendrán ningún efecto para esas plataformas.

Excelente, está todo listo para visualizar los datos de Análisis y diagnóstico (bloqueo y error) en el portal que el SDK recopilará automáticamente.

Consulte la documentación de App Center Analytics y App Center crashes para aprender a usar funcionalidades más avanzadas con ambos servicios.

Para obtener información sobre cómo empezar a trabajar con las actualizaciones desde la aplicación, lea la documentación de App Center Distribute.