Introducción a WPF/WinForms

  • Artículo

Importante

Visual Studio App Center está programado para retirarse el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.

Obtenga más información sobre las escalas de tiempo y las alternativas de soporte técnico.

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 la 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:

  • El proyecto tiene como destino .NET Framework 4.6.2 (o superior) o .NET Core 3.1 (o superior).
  • .NET Core solo se admite cuando la aplicación WPF/WinForms se ejecuta en Windows.
  • Si usa el SDK desde una biblioteca portátil, debe tener como destino .NET Standard 2.0 o superior (no se admite PCL).
  • Tipo de proyecto PackageReference. Este requisito procede de la SQLitePCL.raw biblioteca. Más información en https://github.com/ericsink/SQLitePCL.raw/issues/537.
  • Hay un problema conocido al integrar el SDK en proyectos de VSTO. Para obtener más detalles, visite https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

2. Creación de la aplicación en el portal de App Center para obtener el secreto de la 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 según el 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. Adición de 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.

Nota

El SDK de App Center usa ensamblados con nombre seguro para la compatibilidad con aplicaciones que usan un signo con nombre seguro.

Visual Studio

  • Abra 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>Consola del Administrador> de paquetes NuGet Administrador de paquetes.
  • Escriba los comandos siguientes:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Nota

Si usa el SDK de App Center en un proyecto portátil, debe instalar los paquetes en cada uno de los proyectos: portable y el proyecto que ejecuta la aplicación WPF/WinForms. Para ello, debe abrir cada subproyecto y seguir los pasos correspondientes descritos en la sección Visual Studio .

4. Iniciar el SDK

Para usar App Center, opte por los módulos que quiera 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.

4.1 Agregar el Start() método

WPF

Para la aplicación WPF, modifique y App.xaml.cs agregue las siguientes instrucciones using:

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

A continuación, en el mismo archivo, agregue el código siguiente en el OnStartup método :

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

Si el App.xaml.cs archivo no tiene el OnStartup método , puede agregar el Application.OnStartup(StartupEventArgs) método . El App.xaml.cs archivo debe tener un aspecto similar al siguiente:

public partial class App : Application
{
    protected override void OnStartup(StartupEventArgs e)
    {
      base.OnStartup(e);
      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. Configure o inícielo con el secreto de aplicación.
  2. Si se puede llamar al código varias veces, compruebe 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)); 
}

WinForms

Para la aplicación WinForms, modifique el Program.cs archivo y agregue las siguientes instrucciones using:

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

A continuación, en el mismo archivo, agregue el código siguiente en el Main método , antes de la Application.Run instrucción .

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

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

  1. Configure o inícielo con el secreto de aplicación.
  2. Si se puede llamar al código varias veces, compruebe 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)); 
}

Advertencia

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

4.2 Reemplace el marcador de posición por el secreto de la aplicación

Asegúrese de reemplazar {Your App Secret} texto por el valor real de la aplicación. El secreto de 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 los bloqueos 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.