Introducción con UWP/WinUI

  • 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 a configurar el SDK App Center en la aplicación para usar App Center Analytics y App Center bloqueos.

1. Prerrequisitos

Asegúrese de que se cumplen los siguientes requisitos previos antes de empezar:

Para el proyecto de UWP:

  • El proyecto se configura en Visual Studio 2017 Update 15.9 o posterior.
  • Tiene como destino dispositivos que ejecutan Windows 10 compilación 16299 o posterior.
  • El proyecto hace referencia a Universal Windows Platform 6.2.8 o posterior (normalmente se hace referencia a este paquete implícitamente).
  • NuGet 4.3 o posterior.

Para el proyecto WinUI:

  • El proyecto se configura en Visual Studio 2019 Update 16.9 o posterior.
  • Tiene como destino dispositivos que ejecutan Windows 10 compilación 17763 o posterior.
  • El proyecto hace referencia a WinUI 3 0.8.0 o posterior.

Nota

Si quiere usar Xamarin.Forms para UWP, siga la documentación de introducción de Xamarin en lugar de esta.

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

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

  1. Regístrese o inicie sesión y pulse 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.
  2. Escriba un nombre y una descripción opcional para la aplicación.
  3. Seleccione el sistema operativo y la plataforma adecuados en función del proyecto, tal y como se describió anteriormente.
  4. Presione el botón situado en la parte inferior derecha que indica Agregar nueva aplicación.

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

3. Agregar los módulos App Center SDK

El SDK App Center se puede integrar mediante Visual Studio o la Administrador de paquetes consola.

Visual Studio

  • Abra Visual Studio.
  • Haga clic en Archivo > abierto y elija la solución.
  • En el navegador de soluciones, haga clic con el botón derecho en Referencias y elija Administrar NuGet paquetes.
  • En la pestaña Examinar, busque App Center e instale los paquetes Microsoft.AppCenter.Analytics y Microsoft.AppCenter.Crashes.

Consola del Administrador de paquetes

  • Abra la consola en Visual Studio. Para ello, elija Herramientas > NuGet Administrador de paquetes > Administrador de paquetes consola.
  • Escriba los comandos siguientes:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Ahora que ha integrado el SDK en la aplicación, es el momento de iniciar el SDK y hacer uso de los servicios de App Center.

Nota

Si usa el SDK de App Center en un proyecto portátil (como Xamarin.Forms), debe instalar los paquetes en cada uno de los proyectos: los portátiles, Android e iOS. Para ello, debe abrir cada subprovee y seguir los pasos correspondientes descritos en Visual Studio sección.

4. Adición Internet (Client) de la funcionalidad

En Visual Studio explorador de soluciones, haga doble clic en el archivo Package.appxmanifest de la aplicación. Haga clic en la pestaña Funcionalidades y compruebe la funcionalidad Internet (cliente).

5. Inicio del SDK

Para usar App Center, debe participar en los módulos que desea usar. De forma predeterminada, no se inicia ningún módulo y debe llamar explícitamente a cada uno de ellos al iniciar el SDK.

5.1 Adición de las directivas using

Agregue los espacios de nombres adecuados antes de usar nuestras API.

using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

5.2 Adición del Start() método

Agregue la siguiente llamada al constructor de la aplicación:

AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));

Si necesita iniciar los servicios App Center por separado, debe hacer lo siguiente:

  1. Configúrelo o inéntelo con el secreto de aplicación.
  2. Si se puede llamar al código varias veces, compruebe si el App Center ya está configurado.
  3. Inicie los servicios necesarios sin el secreto de aplicación.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

5.3 Reemplazar el marcador de posición por el secreto de aplicación

Asegúrese de reemplazar el {Your App Secret} texto por el valor real de la aplicación. El secreto de la aplicación se puede encontrar en la Tareas iniciales o en Configuración en App Center portal.

La Tareas iniciales contiene el ejemplo de código anterior con el secreto de aplicación, puede copiar y pegar el ejemplo completo.

En el ejemplo anterior se muestra cómo usar el Start() método e incluye App Center Analytics.

A menos que especifique explícitamente cada servicio como parámetros en el método start, no puede usar ese App Center servicio. Además, la API solo se puede usar una vez en el ciclo de vida de la aplicación: todas las demás llamadas registrarán una advertencia en la consola y solo estarán disponibles los servicios incluidos en la primera Start() llamada.

Excelente, está todo listo para visualizar Analytics en el portal que el SDK recopila automáticamente.

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