Introdução ao WPF/WinForms

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, exceto para os recursos de Análise e Diagnóstico, que continuarão a ter suporte até 30 de junho de 2026. Mais informações.

• Androide
• iOS
• Extensões iOS
• Reagir Nativo
• MAUI/Xamarin
• UWP (Plataforma Universal do Windows)
• WPF/WinForms
• Unidade
• macOS
• Extensões macOS
• tvOS

O SDK do App Center usa uma arquitetura modular para que você possa usar qualquer um ou todos os serviços.

Vamos começar a configurar o SDK do App Center em seu aplicativo para usar o App Center Analytics e o App Center Crashes.

1. Pré-requisitos

Antes de começar, certifique-se de que os seguintes pré-requisitos são atendidos:

• Seu projeto está direcionado ao .NET Framework 4.6.2 (ou superior) ou ao .NET Core 3.1 (ou superior).
• O .NET Core é suportado somente quando o aplicativo WPF/WinForms é executado no Windows.
• Se você usar o SDK de uma biblioteca portátil, ele deverá ter como destino o .NET standard 2.0 ou superior (PCL não é suportado).
• Tipo de projeto PackageReference. Este requisito vem da SQLitePCL.raw biblioteca. Mais informações em https://github.com/ericsink/SQLitePCL.raw/issues/537.
• Há um problema conhecido ao integrar o SDK em projetos VSTO. Para mais detalhes, visite https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

2. Crie seu aplicativo no Portal do App Center para obter o Segredo do Aplicativo

Se já tiver criado a sua aplicação no portal do App Center, pode ignorar este passo.

1. Inscreva-se ou faça login e pressione o botão azul no canto superior direito do portal que diz Adicionar novo e selecione Adicionar novo aplicativo no menu suspenso.
2. Insira um nome e uma descrição opcional para seu aplicativo.
3. Selecione o sistema operacional e a plataforma apropriados, dependendo do seu projeto, conforme descrito acima.
4. Pressione o botão no canto inferior direito que diz Adicionar novo aplicativo.

Depois de criar um aplicativo, você pode obter seu Segredo do Aplicativo na página Configurações do Portal do App Center. No canto superior direito da página Configurações , clique nos três pontos verticais e selecione Copy app secret para obter seu Segredo do aplicativo.

3. Adicione os módulos do SDK do App Center

O SDK do App Center pode ser integrado usando o Visual Studio ou o Console do Gerenciador de Pacotes.

Observação

O SDK do App Center usa assemblies de nome forte para compatibilidade com aplicativos que usam sinal de nome forte.

Visual Studio

• Abra o Visual Studio.
• Clique em Abrir arquivo> e escolha sua solução.
• No navegador da solução, clique com o botão direito do mouse em Referências e escolha Gerenciar pacotes NuGet.
• No separador Navegar, procure por App Center e instale os pacotes Microsoft.AppCenter.Analytics e Microsoft.AppCenter.Crashes.

Console do Gestor de Pacotes

• Abra o console no Visual Studio. Para fazer isso, escolha Ferramentas>Gerenciador de Pacotes NuGet>Console do Gerenciador de Pacotes.
• Escreva os seguintes comandos:

Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Observação

Se você usar o SDK do App Center em um projeto portátil, deverá instalar os pacotes em cada um dos projetos: o portátil e o projeto que está executando o aplicativo WPF/WinForms. Para fazer isso, você deve abrir cada subprojeto e seguir as etapas correspondentes descritas na seção Visual Studio .

4. Inicie o SDK

Para utilizar o App Center, opte por aceder ao(s) módulo(s) que pretende utilizar. Por padrão, nenhum módulo é iniciado e você deve chamar explicitamente cada um deles ao iniciar o SDK.

4.1 Adicionar o Start() método

WPF

Para o seu aplicativo WPF, modifique o App.xaml.cs e adicione as seguintes instruções using:

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

Em seguida, no mesmo arquivo, adicione o seguinte código no OnStartup método:

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

Se o App.xaml.cs ficheiro não tiver o método OnStartup, pode adicionar o método Application.OnStartup(StartupEventArgs). O seu App.xaml.cs ficheiro deve ter o seguinte aspeto:

public partial class App : Application
{
    protected override void OnStartup(StartupEventArgs e)
    {
      base.OnStartup(e);
      AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));
    }
  }
}

Advertência

Não é recomendado incorporar o segredo do aplicativo no código-fonte.

Se precisar iniciar os serviços do App Center separadamente, você deve:

1. Configure ou inicie-o com o Segredo do aplicativo.
2. Se o código puder ser chamado várias vezes, verifique se o App Center já está configurado.
3. Inicie o(s) serviço(s) necessário(s) sem o Segredo da Aplicação.

AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

WinForms

Para a sua aplicação WinForms, modifique o arquivo Program.cs, e adicione as seguintes instruções 'using':

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

Em seguida, no mesmo ficheiro, adicione o seguinte código no método Main, antes da instrução Application.Run.

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

Se precisar iniciar os serviços do App Center separadamente, você deve:

1. Configure ou inicie-o com o Segredo do aplicativo.
2. Se o código puder ser chamado várias vezes, verifique se o App Center já está configurado.
3. Inicie o(s) serviço(s) necessário(s) sem o Segredo da Aplicação.

AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

Advertência

Não é recomendado incorporar o segredo do aplicativo no código-fonte.

4.2 Substitua o marcador de posição pelo Segredo da App

Certifique-se de substituir {Your App Secret} o texto pelo valor real do seu aplicativo. O Segredo do Aplicativo pode ser encontrado na página Introdução ou na página Configurações no portal do App Center.

A página Introdução contém o exemplo de código acima com o seu Segredo de Aplicativo, você pode copiar e colar o exemplo inteiro.

O exemplo acima mostra como usar o Start() método e inclui o App Center Analytics.

A menos que você especifique explicitamente cada serviço como parâmetros no método start, não poderá usar esse serviço do App Center. Além disso, a Start() API pode ser usada apenas uma vez no ciclo de vida do seu aplicativo – todas as outras chamadas registrarão um aviso no console e apenas os serviços incluídos na primeira chamada estarão disponíveis.

Ótimo, você está pronto para visualizar falhas no portal que o SDK coleta automaticamente.

Consulte a documentação do App Center Analytics e do App Center Crashes para saber como personalizar e usar funcionalidades mais avançadas de ambos os serviços.