O Mobile Analysis Service (MAS) usa o SDK do cliente para instrumentação. O SDK coleta dados, como comportamento do usuário e desempenho do aplicativo, gera logs e os envia ao servidor. O servidor extrai dados válidos dos logs enviados com base em um formato predefinido. Esse processo permite monitorar e analisar diversas métricas do cliente.
Este tópico descreve como integrar rapidamente o componente Mobile Analysis Service (MAS) a um cliente Android. O componente MAS oferece dois tipos de integração: integração nativa AAR e integração baseada em componentes.
O processo completo de integração consiste nas seis etapas a seguir:
Pré-requisitos
Se você usar a integração nativa AAR, primeiro adicione o mPaaS ao seu projeto.
Caso utilize a integração nativa AAR, adicione o mPaaS ao seu projeto antes de continuar.
Ao optar pela integração baseada em componentes, conclua previamente o processo de integração.
Para a integração baseada em componentes, finalize primeiro o processo de integração baseada em componentes.
Adicionar o SDK
Integração nativa AAR
Use o Component Management (AAR) para instale o componente Logging (LOGGING) no seu projeto. Para mais informações, consulte Gerencie dependências de componentes (AAR nativo) e Gerenciamento de componentes AAR.
Integração baseada em componentes
Nos projetos Portal e Bundle, instale o componente Logging (LOGGING) por meio do Component Management. Para obter mais detalhes, veja processo de integração e adicionar dependências de componentes.
Inicializar o mPaaS
Integração nativa AAR
Na integração nativa AAR, é obrigatório inicializar o mPaaS.
Para isso, adicione o código abaixo ao objeto Application:
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// Initialize mPaaS
MP.init(this);
}
}Para mais informações, consulte Inicializar o mPaaS.
Integração baseada em componentes
No modelo de integração baseada em componentes, o framework mPaaS é inicializado automaticamente. Nenhuma ação adicional é necessária.
Adicionar configurações
Enviar logs
O envio de logs requer acesso à rede. Declare as seguintes permissões no arquivo AndroidManifest.
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />Diagnóstico de logs
Para usar o recurso de diagnóstico de logs, declare a permissão abaixo no arquivo AndroidManifest. Além disso, solicite essa permissão dinamicamente em tempo de execução em dispositivos com Android 6.0 ou superior.
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />Os logs de diagnóstico são salvos no cartão SD do dispositivo. Sem essa permissão, talvez não seja possível recuperar os logs de diagnóstico.
Defina um ID de canal
Para diferenciar dados de APKs de canais distintos no console, defina um ID de canal para cada APK.
Crie um arquivo channel.config na pasta assets do seu projeto e modifique o valor de channel_id.
# Identifies the current distribution channel
channel_id=alipaySe você não crie o arquivo channel.config, o ID de canal assumirá o valor padrão mpaas_default.
Obter IMEI/IMSI
Em versões anteriores ao Android 10, o sistema obtém o IMEI e o IMSI do dispositivo por padrão, desde que as permissões necessárias sejam concedidas. Para desativar completamente esse comportamento, adicione a seguinte configuração ao arquivo AndroidManifest:
<meta-data
android:name="imei.switch"
android:value="off" />Esta configuração aplica-se apenas à baseline 10.2.3.6 e posteriores. Após adicionar esta configuração, o Mobile Analysis Service, o Message Push Service e o Mobile Sync Service deixarão de obter o IMEI e o IMSI do dispositivo.
Ative detecção de autoinicialização de serviço
Para resolver o problema em que o TianyanLoggingService reinicia automaticamente em certos dispositivos mesmo após o encerramento forçado manual do aplicativo, adicione a seguinte configuração ao AndroidManifest.xml para desativar a inicialização automática:
<meta-data
android:name="open_service_self_start_detection"
android:value="true" />Esta configuração aplica-se apenas à baseline 10.2.3.77 e posteriores.
Adicionar logs
Após integrar o SDK, adicione o código necessário para gerar os seguintes tipos de logs:
Visualize logs locais
Para obter instruções sobre como visualizar informações de logs locais, consulte Visualize logs locais.
Reportar logs
Para sincronizar logs dos arquivos locais do cliente com o servidor de logs, consulte Reportar logs.