Introdução à UWP/WinUI

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:

Para o projeto UWP:

• Seu projeto está configurado no Visual Studio 2017 Atualização 15.9 ou posterior.
• Você está direcionando dispositivos que executam o Windows 10 build 16299 ou posterior.
• Seu projeto faz referência à Plataforma Universal do Windows 6.2.8 ou posterior (este pacote normalmente é referenciado implicitamente).
• NuGet 4.3 ou posterior.

Para o projeto WinUI:

• Seu projeto está configurado no Visual Studio 2019 Atualização 16.9 ou posterior.
• Está a direcionar para dispositivos com o Windows 10 build 17763 ou posterior.
• Seu projeto faz referência ao WinUI 3 0.8.0 ou posterior.

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.

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

Agora que você integrou o SDK em seu aplicativo, é hora de iniciar o SDK e usar os serviços do App Center.

4. Adicione a capacidade de Internet (Client)

No Gerenciador de soluções do Visual Studio, clique duas vezes no arquivo Package.appxmanifest para seu aplicativo. Clique na guia Recursos e verifique o recurso Internet (Cliente ).

5. Inicie o SDK

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

5.1 Adicionar as diretivas de utilização

Adicione os namespaces apropriados antes de usar nossas APIs.

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

5.2 Adicionar o Start() método

Adicione a seguinte chamada ao construtor do seu aplicativo:

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)); 
}

5.3 Substitua o marcador de posição pelo Segredo da Aplicação

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 o Analytics 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.