Compartilhar via

Introdução ao Android

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, com exceção dos recursos de Análise e Diagnóstico, que continuarão com suporte até 30 de junho de 2026. Saiba mais.

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 sobre 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 Android do App Center em seu aplicativo para usar o App Center Analytics e o App Center Crashes. Para adicionar o App Center Distribute ao seu app, confira a documentação do App Center Distribute.

1. Pré-requisitos

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

  • Seu projeto android está configurado no Android Studio.
  • Você está direcionando dispositivos que executam o Android Versão 5.0 (nível de API 21) ou posterior.

2. Criar 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. Vá para 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 dropdown.
  3. Insira um nome e uma descrição opcional para seu aplicativo.
  4. Selecione o Android como o sistema operacional e o Java como uma 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 abaixo de 2. Inicie o SDK. Ou, você pode clicar em Configurações e, no canto superior direito, clicar nos pontos verticais triplos e selecionar Copiar segredo do aplicativo para obter o Segredo do Aplicativo.

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

  1. Abra o arquivo build.gradle no nível do 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 do SDK precisa ser adicionado como uma dependência separada nesta seção. Se você quiser usar Análises e Incidentes do App Center, 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 plug-in do Android Gradle for menor que 3.0.0, você precisará substituir a palavra implementation por compile.

Observação

Devido ao encerramento do suporte do jCenter , todos os nossos assemblies foram movidos para o repositório Maven Central. Siga este guia sobre a migração do jCenter para o Maven Central. Observe que o Maven Central não contém módulos preteridos. Verifique se o projeto não tem dependências de módulos preteridos do SDK do App Center.

  1. Certifique-se de disparar uma sincronização do Gradle no Android Studio.

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

4. Iniciar o SDK

4.1 Adicionar o método start()

Para usar o App Center, você deve aceitar os módulos 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 principal de atividade do aplicativo para usar o onCreate e o 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)

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 a Chave Secreta do Aplicativo.
  2. Se o código puder ser chamado várias vezes, verifique se o App Center já está configurado.
  3. Inicie os serviços necessários sem o Segredo do Aplicativo.
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 você tiver mais de um ponto de entrada para seu aplicativo (por exemplo, uma atividade de link direto, um serviço ou um receptor de broadcast), chame start na classe personalizada do aplicativo ou em cada ponto de entrada. No ú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 pela chave secreta do aplicativo

Certifique-se de substituir o texto {Your App Secret} 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 Segredo do Aplicativo nele, basta copiar e colar todo o exemplo.

O exemplo acima mostra como usar o método start() 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 inicial, não é possível usar esse serviço do App Center. Além disso, a start() API pode ser usada apenas uma vez no ciclo de vida do aplicativo. Todas as outras chamadas registrarão um aviso no console e somente os módulos incluídos na primeira chamada estarão disponíveis.

Por exemplo: se você quiser apenas integrar o App Center Analytics, modifique a start() chamada à 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 de 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 de Análise e Falhas no portal que o SDK coleta automaticamente.

Examine 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 aprender como começar com atualizações dentro do aplicativo, leia a documentação da Distribuição do App Center.

5. Regras de backup (somente Android)

Observação

Os aplicativos destinados ao Android 6.0 (nível de API 23) ou superior têm o Backup Automático habilitado 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 .
  1. Abra o arquivoAndroidManifest.xmldo projeto. Adicione o android:fullBackupContent atributo ao <application> elemento. Ele deve apontar para o arquivo de recurso appcenter_backup_rule.xml .
android:fullBackupContent="@xml/appcenter_backup_rule"
  1. 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 .
  1. Abra o arquivoAndroidManifest.xmldo projeto. Adicione o android:dataExtractionRules atributo ao <application> elemento. Ele deve apontar para o arquivo de recurso appcenter_backup_rule.xml .
android:dataExtractionRules="@xml/appcenter_backup_rule"
  1. 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>