Introdução ao Android

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.

Você pode encontrar informações sobre dados coletados pelo App Center em Dados coletados por SDKs do App Center, Regulamento Geral de Proteção de Dados e páginas de perguntas frequentes .

Vamos começar a configurar o SDK do App Center Android em seu aplicativo para usar o App Center Analytics e o App Center Crashes. Para adicionar o App Center Distribute ao seu aplicativo, consulte a documentação do App Center Distribute.

1. Pré-requisitos

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

• Seu projeto Android está configurado no Android Studio.
• Você está segmentando dispositivos que executam o Android Versão 5.0 (nível de API 21) 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. Dirija-se a appcenter.ms.
2. Inscreva-se ou faça login e clique no botão Adicionar novo no canto superior direito da página e selecione Adicionar novo aplicativo no menu suspenso.
3. Insira um nome e uma descrição opcional para seu aplicativo.
4. Selecione Android como sistema operacional e Java como plataforma.
5. Clique no botão Adicionar novo aplicativo .

Depois de criar um aplicativo, você pode obter seu Segredo do aplicativo na página Introdução em 2. Inicie o SDK. Em alternativa, pode clicar em Definições e, no canto superior direito, clicar nos três pontos verticais e selecionar Copiar segredo da aplicação para obter o segredo da aplicação.

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

1. Abra o arquivo build.gradle de nível de aplicativo do projeto (app/build.gradle) e adicione as seguintes linhas após apply plugin. Inclua as dependências desejadas em seu projeto. Cada módulo SDK precisa ser adicionado como uma dependência separada nesta seção. Se quiser utilizar o App Center Analytics and Crashes, adicione as seguintes linhas:

dependencies {
    def appCenterSdkVersion = '5.0.6'
    implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
    implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
}

Observação

Se a versão do seu plugin Android Gradle é inferior a 3.0.0, então você precisa substituir a palavra implementação por compilar.

Observação

Devido ao término do suporte do jCenter , todas as nossas montagens foram movidas para o repositório do Maven Central. Siga este guia sobre migração do jCenter para o Maven Central. Observe que o Maven Central não contém módulos preteridos. Certifique-se de que seu projeto não tenha dependências de módulos SDK do App Center preteridos.

2. Certifique-se de acionar uma sincronização Gradle no Android Studio.

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

4. Inicie o SDK

4.1 Adicionar o método start()

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.
Insira a seguinte linha dentro do callback da classe de atividade principal do seu aplicativo para usar onCreate e App Center Crashes:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);

AppCenter.start(application, "{Your App Secret}", Analytics::class.java, Crashes::class.java)

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(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics.class);
    AppCenter.start(Crashes.class);
}

AppCenter.configure(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics::class.java);
    AppCenter.start(Crashes::class.java);
}

Se tiver mais de um ponto de entrada para a sua aplicação (por exemplo, uma atividade de link profundo, um serviço ou um recetor de broadcast), chame start na classe personalizada da aplicação ou em cada ponto de entrada. Neste último caso, verifique se o App Center já está configurado antes da start chamada:

if (!AppCenter.isConfigured())) {
  AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);
}

if (!AppCenter.isConfigured()) {
  AppCenter.start(application, "{Your App Secret}", Analytics::class.java, Crashes::class.java)
}

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 simplesmente copiar e colar o exemplo inteiro.

O exemplo acima mostra como usar o start() método e incluir o App Center Analytics e o App Center Crashes.

Se você não quiser usar um dos dois serviços, remova o parâmetro correspondente da chamada de método acima.

A menos que você especifique explicitamente cada módulo 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 módulos incluídos na primeira chamada estarão disponíveis.

Por exemplo - Se você quiser apenas integrar ao App Center Analytics, modifique a chamada de start() API da seguinte maneira:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class);

AppCenter.start(application, "{Your App Secret}", Analytics::class.java)

O Android Studio sugere automaticamente as instruções de importação necessárias depois de inserir o start() método, mas se você vir um erro informando que os nomes de classe não são reconhecidos, adicione as seguintes linhas às instruções de importação em sua classe de atividade:

import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.analytics.Analytics;
import com.microsoft.appcenter.crashes.Crashes;

import com.microsoft.appcenter.AppCenter
import com.microsoft.appcenter.analytics.Analytics
import com.microsoft.appcenter.crashes.Crashes

Você está pronto para visualizar dados do Google Analytics e Crashes 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.

Para saber como começar a usar atualizações no aplicativo, leia a documentação do App Center Distribute.

5. Regras de backup (somente Android)

Observação

As aplicações destinadas ao Android 6.0 (nível de API 23) ou superior têm a Cópia de Segurança Automática ativada automaticamente. 

Observação

Se você já tiver um arquivo personalizado com regra de backup, alterne para a terceira etapa.

Se você usar o backup automático para evitar obter informações incorretas sobre dispositivos, siga as próximas etapas:

5.1. Para Android 11 (nível de API 30) ou inferior.

1. Crie appcenter_backup_rule.xml arquivo na pasta res/xml .

2. Abra o arquivo AndroidManifest.xml do projeto. Adicione o android:fullBackupContent atributo ao <application> elemento . Ele deve apontar para o arquivo de recursoappcenter_backup_rule.xml .

android:fullBackupContent="@xml/appcenter_backup_rule"

3. Adicione as seguintes regras de backup ao arquivo appcenter_backup_rule.xml :

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. Para Android 12 (nível de API 31) ou superior.

1. Crie appcenter_backup_rule.xml arquivo na pasta res/xml .

2. Abra o arquivo AndroidManifest.xml do projeto. Adicione o android:dataExtractionRules atributo ao <application> elemento . Ele deve apontar para o arquivo de recursoappcenter_backup_rule.xml .

android:dataExtractionRules="@xml/appcenter_backup_rule"

3. Adicione as seguintes regras de backup ao arquivo appcenter_backup_rule.xml :

<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>