Introdução ao Android

  • 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.

Você pode encontrar informações sobre os 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 a Análise do App Center e falhas do App Center. Para adicionar o app App Center Distribute a você, 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. 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. Vá para appcenter.ms.
  2. Inscreva-se ou faça logon 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 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 a Análise e falhas do App Center, adicione as seguintes linhas:
dependencies {
    def appCenterSdkVersion = '5.0.4'
    implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
    implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
}

Observação

Se a versão do plug-in do Android Gradle for inferior à 3.0.0, você precisará substituir a implementação da palavra por compilação.

Observação

Devido ao encerramento do suporte do jCenter , todos os 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 ao 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 retorno de chamada da classe onCreatede atividade main do aplicativo para usar a Análise do App Center e falhas do App Center:

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 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(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 profundo, um serviço ou um receptor de difusão), chame start na classe personalizada do aplicativo ou em cada ponto de entrada. No último caso, marcar se o App Center já estiver 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 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, basta copiar e colar o exemplo inteiro.

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

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 somente 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 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 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 de Análise e 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.

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

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 arquivo AndroidManifest.xml do 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 arquivo AndroidManifest.xml do 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>