Introdução ao Android

O App Center SDK 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 App Center dados coletados por SDKs doApp Center, Regulamento Geral sobre a Proteção de Dados e páginas de perguntas frequentes.

Vamos começar a configurar o App Center SDK do Android em seu aplicativo para usar App Center Analytics e App Center Falhas. Para adicionar App Center Distribuir ao seu aplicativo, 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á definido em 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 App Center para obter o Segredo do Aplicativo

Se você já tiver criado seu aplicativo no portal App Center, ignore esta etapa.

  1. Vá para o appcenter.ms.
  2. Inscreva-se ou faça logoff 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 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 Ponto de Partida abaixo de 2. Inicie o SDK. Ou, você pode clicar 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 App Center SDK

  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 que você deseja em seu projeto. Cada módulo do SDK precisa ser adicionado como uma dependência separada nesta seção. Se você quiser usar o App Center Analytics e Falhas, adicione as seguintes linhas:
dependencies {
    def appCenterSdkVersion = '4.1.0'
    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 palavra implementação por compilar.

Observação

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

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

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

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

Observação

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 a regra de backup, mude para a terceira etapa.

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

b. Abra o arquivo deAndroidManifest.xml projeto. Adicione o android:fullBackupContent atributo ao <application> elemento . Ele deve apontar para o arquivoappcenter_backup_rule.xml recurso.

android:fullBackupContent="@xml/appcenter_backup_rule"

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

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

4. Iniciar o SDK

4.1 Adicionar o método start()

Para usar App Center, você deve optar pelo(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 retorno de chamada da classe de atividade principal do aplicativo para usar App Center Analytics e onCreate App Center Falhas:

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

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

  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 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 na classe personalizada do aplicativo ou em cada ponto start de entrada. No último caso, verifique se 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 Substituir o espaço reservado pelo segredo do aplicativo

Substitua o texto {Your App Secret} pelo valor real do aplicativo. O Segredo do Aplicativo pode ser encontrado na página Ponto de Partida ou Configurações página no portal App Center aplicativo.

A Ponto de Partida página contém o exemplo de código acima com o Segredo do Aplicativo, basta copiar e colar o exemplo inteiro.

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

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, você não poderá usar esse App Center serviço. Além disso, a 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 start() estarão disponíveis.

Por exemplo: se você quiser apenas fazer a integração com o App Center Analytics, modifique a chamada start() à API da seguinte forma:

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

Android Studio sugere automaticamente as instruções de importação necessárias depois de inserir o 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 start() 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.

Veja a documentação do App Center Analytics e App Center falhas 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 Distribuir.