Compartir a través de

Introducción a UWP/WinUI

Importante

Visual Studio App Center se retiró el 31 de marzo de 2025, excepto las características de análisis y diagnóstico, que seguirán siendo compatibles hasta el 30 de junio de 2026. Más información.

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

Empecemos a configurar el SDK de App Center en tu aplicación para usar App Center Analytics y App Center Crashes.

1. Prerrequisitos

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

Para el proyecto de UWP:

  • El proyecto está configurado en Visual Studio 2017 Update 15.9 o posterior.
  • Tiene como destino dispositivos que ejecutan la compilación 16299 o posterior de Windows 10.
  • El proyecto hace referencia a la Plataforma universal de Windows 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 está configurado en Visual Studio 2019 Update 16.9 o posterior.
  • Tiene como destino dispositivos que ejecutan la compilación 17763 o posterior de Windows 10.
  • El proyecto hace referencia a WinUI 3 0.8.0 o posterior.

Nota:

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

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

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

  1. Regístrese o inicie sesión y presione el botón azul en 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 ha descrito 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 del portal de App Center. 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 del SDK de App Center

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

Visual Studio

  • Abre Visual Studio.
  • Haga clic en Abrir archivo>y elija la solución.
  • En el navegador de soluciones, haga clic con el botón derecho en Referencias y elija Administrar paquetes NuGet.
  • 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>Administrador de paquetes NuGet>Consola del Administrador de Paquetes.
  • Escriba los siguientes comandos:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Ahora que ha integrado el SDK en la aplicación, es hora de iniciar el SDK y usar 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 subproyecto y seguir los pasos correspondientes descritos en la sección Visual Studio .

4. Agregar la Internet (Client) funcionalidad

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

5. Iniciar el 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 Agregar las directivas using

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

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

5.2 Agregar el Start() método

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

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

Advertencia

No se recomienda insertar el secreto de aplicación en el código fuente.

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

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

5.3 Reemplaza el marcador de posición con el secreto de tu aplicación

Asegúrese de reemplazar el texto {Your App Secret} por el valor real para su aplicación. El secreto de la aplicación se puede encontrar en la página Introducción o en la página Configuración del portal de App Center.

La página Introducción contiene el ejemplo de código anterior con el secreto de aplicación en ella, puede copiar y pegar todo el ejemplo.

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 servicio de App Center. Además, la Start() 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 llamada.

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

Consulte la documentación de App Center Analytics y App Center Crashes para obtener información sobre cómo personalizar y usar funcionalidades más avanzadas de ambos servicios.