Primeiros passos no Android

Este guia explica como começar o desenvolvimento com o Google Fit no Android.

Observação: o Google Fit faz parte do Google Play Services. Saiba mais sobre os benefícios que seu app recebe ao usar o Google Play Services.

Configuração

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

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 que já existe. Talvez seja interessante criar uma conta separada para testar o app da perspectiva de um usuário.

Instalar o Google Play Services

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

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

Receber um ID do cliente OAuth 2.0

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

Criar e configurar o projeto

Recomendamos usar o ambiente de desenvolvimento do Android Studio para criar um app com a API Fitness. Para saber 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 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.3.0")
        implementation("com.google.android.gms:play-services-auth:22.0.0")
}

DSL do Groovy

apply plugin: 'com.android.application'

...

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

Isso garante que o Gradle faça o download automático do SDK de fitness ao criar o app.

Criar e testar o app

Depois de concluir as etapas de configuração, você pode começar 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 do OAuth

Os tipos de dados que seu app tem permissão para acessar correspondem aos escopos de autorização. Para solicitar essas permissões, adicione os tipos de dados que o app precisa acessar em uma instância FitnessOptions. Quando o app pede para usar qualquer um dos tipos de dados do Google Fit, o SDK do Android verifica automaticamente a quais escopos eles pertencem e solicita ao usuário autorização para esses escopos.

Criar um cliente de API

Crie um cliente de API e adicione os tipos de dados que o 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, sempre ativa e de baixo consumo de energia.
• HistoryClient: insira, exclua e leia dados históricos no Google Fit.
• SessionsClient: criar e gerenciar sessões de atividade do usuário.
• GoalsClient: ler as metas de Pontos Cardio e passos criadas pelos usuários no Google Fit.
• ConfigClient: acesse tipos de dados e configurações 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 experimentam quando recebem solicitações de permissões:

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

1. Permissões do Android: os usuários veem quais permissões do Android o app solicitou antes de fazer o download. Depois que o app é baixado, ele solicita as permissões de execução necessárias, e os usuários as concedem ou negam.
2. Verificar e conectar: o 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 pede que o usuário conceda ao 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 as 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, você precisa solicitar a verificação com diferentes níveis de justificativa necessários para escopos sensíveis e restritos.