Introdução ao WPF/WinForms

  • Artigo

Importante

O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar migrar.

Saiba mais sobre linhas do tempo e alternativas de suporte.

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 a Análise do App Center e falhas do App Center.

1. Pré-requisitos

Antes de começar, verifique se os seguintes pré-requisitos são cumpridos:

  • Seu projeto tem como destino .NET Framework 4.6.2 (ou superior) ou .NET Core 3.1 (ou superior).
  • O .NET Core só tem suporte 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 (não há suporte para PCL).
  • Tipo de projeto PackageReference. Esse 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 obter 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 você já criou seu aplicativo no portal do App Center, ignore esta etapa.

  1. Inscreva-se ou faça logon 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 projeto, conforme descrito acima.
  4. Pressione o botão na parte inferior direita que diz Adicionar novo aplicativo.

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

3. Adicionar 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.
  • Na guia Procurar, pesquise o App Center e instale os pacotes Microsoft.AppCenter.Analytics e Microsoft.AppCenter.Crashes .

Console do Gerenciador de Pacotes

  • Abra o console no Visual Studio. Para fazer isso, escolha FerramentasConsole do Gerenciador dePacotes>>NuGet.
  • Digite 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. Iniciar o SDK

Para usar o App Center, aceite os módulos que você deseja usar. 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 seu aplicativo WPF, modifique e App.xaml.cs adicione o seguinte usando instruções:

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 arquivo não tiver o OnStartup método , você poderá adicionar o Application.OnStartup(StartupEventArgs) método . Seu App.xaml.cs arquivo deve ser semelhante a:

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

Aviso

Não é recomendável inserir o Segredo do Aplicativo no código-fonte.

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

  1. Configure ou inicie-o com o Segredo do Aplicativo.
  2. Se o código puder ser chamado várias vezes, marcar se o App Center já estiver configurado.
  3. Inicie os serviços necessários sem o Segredo do Aplicativo.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

WinForms

Para seu aplicativo WinForms, modifique o Program.cs arquivo 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 código a Main seguir no método , antes da instrução Application.Run .

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

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

  1. Configure ou inicie-o com o Segredo do Aplicativo.
  2. Se o código puder ser chamado várias vezes, marcar se o App Center já estiver configurado.
  3. Inicie os serviços necessários sem o Segredo do Aplicativo.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

Aviso

Não é recomendável inserir o Segredo do Aplicativo no código-fonte.

4.2 Substitua o espaço reservado pelo segredo do aplicativo

{Your App Secret} Substitua o texto pelo valor real do 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 seu Segredo do Aplicativo, você pode copiar e colar todo o exemplo.

O exemplo acima mostra como usar o Start() método e inclui a Análise do App Center.

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.

Examine a documentação da Análise do App Center e falhas do App Center para saber como personalizar e usar funcionalidades mais avançadas de ambos os serviços.