Primeiros passos no Android

Este guia explica como iniciar o desenvolvimento com o Google Fit no Android.

Observação: o Google Fit faz parte do Google Play Services. Conheça os benefícios do app ao usar o Google Play Services.

Configuração

Antes de começar a criar seu app, siga as etapas nas seções a seguir.

Criar uma Conta do Google

Para usar as APIs do Google Fit, você precisa de uma Conta do Google. É possível criar uma nova conta ou usar uma existente. Crie uma conta separada para testar o app da perspectiva de um usuário.

Instalar o Google Play Services

Receba a biblioteca de cliente mais recente do Google Play Services no seu host de desenvolvimento:

1. Abra o Android SDK Manager.
2. Em SDK Tools, encontre Google Play Services.
3. Se o status desses pacotes não for Instalado, selecione-os e clique em Instalar pacotes.

Receber um ID do cliente OAuth 2.0

Para ativar a API Fitness, consiga um ID de cliente OAuth 2.0.

Criar e configurar seu projeto

Recomendamos usar o ambiente de desenvolvimento do Android Studio para criar um app com a API Fitness. Para ver detalhes sobre como criar um novo projeto e configurá-lo no Android Studio, consulte Criar um projeto.

Adicionar a biblioteca de cliente do Google Play Services

No Android Studio, abra o arquivo build.gradle do seu módulo e adicione a biblioteca de cliente do Google Play Services como uma dependência:

DSL do Kotlin

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.1.0")
        implementation("com.google.android.gms:play-services-auth:20.7.0")
}

DSL estiloso

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.1.0'
    implementation 'com.google.android.gms:play-services-auth:20.7.0'
}

Isso garante que o Gradle faça o download automático do SDK de condicionamento físico ao criar o app.

Criar e testar seu app

Depois de concluir as etapas de configuração, comece a criar seu app. Para começar, conheça os tipos de dados que seu app pode armazenar e ler. Saiba mais sobre como trabalhar com dados no Google Fit.

Receber as permissões necessárias do Android

Para ler e gravar alguns tipos de dados, seu app precisa solicitar permissões do Android.

Receber permissões OAuth

Os tipos de dados que seu app tem permissão para acessar correspondem aos escopos de autorização. Para solicitar essas permissões, você precisa adicionar a quais tipos de dados seu app precisa de acesso em uma instância FitnessOptions. Quando seu app solicita o uso de qualquer um dos tipos de dados do Google Fit, o SDK do Android verifica automaticamente a quais escopos ele pertence e solicita a autorização do usuário para esses escopos.

Criar um cliente de API

Crie um cliente de API e adicione os tipos de dados que seu app precisa acessar para gravar ou ler dados. Os seguintes endpoints estão disponíveis:

• SensorsClient: acesse diferentes fontes de dados de saúde e bem-estar de sensores de hardware no dispositivo local e em dispositivos complementares.
• RecordingClient: para coleta de dados do sensor em segundo plano, com pouca energia e sempre ativada.
• HistoryClient: inserir, excluir e ler dados históricos no Google Fit.
• SessionsClient: criar e gerenciar sessões da atividade do usuário.
• GoalsClient: ler as metas de Pontos cardio e passos criados pelos usuários no Google Fit.
• ConfigClient: acessar configurações e tipos de dados personalizados na plataforma Google Fit.

Veja um exemplo de como criar um cliente da API Fitness.

Fluxo de autorização do usuário resultante

Veja a seguir o fluxo de autorização resultante que os usuários vivenciam quando recebem solicitações de permissões:

Figura 1.O fluxo de autorização para os usuários.

1. Permissões do Android: os usuários veem quais permissões do Android seu app solicitou antes de fazer o download. Depois do download do app, ele solicita todas as permissões de execução necessárias e os usuários concedem ou negam essas permissões.
2. Verificar e conectar: seu app verifica se as permissões foram concedidas antes de solicitar acesso a outros tipos de dados.
3. Solicitação de escopos do OAuth: o Google solicita que o usuário conceda ao seu app os escopos do OAuth necessários para os tipos de dados que ele quer acessar.
4. Acesso aplicado: depois que o usuário concede permissões, seu app pode acessar os tipos de dados que pertencem aos escopos para os quais o usuário concedeu permissão.

Solicitar verificação

Depois de criar e testar o app, solicite a verificação com diferentes níveis de justificativa necessários para escopos restritos e sensíveis.