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 seu app, conclua 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 conta ou usar uma já existente. Talvez você queira criar uma conta separada para testar seu app da perspectiva do usuário.

Instalar o Google Play Services

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

1. Abra o SDK Manager do Android.
2. Em SDK Tools, 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, receba um ID do 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 mais detalhes sobre como criar um 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:21.5.1")
}

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:21.5.1'
}

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

Criar e testar seu app

Depois de concluir as etapas de configuração, você pode começar a criar seu app. Para começar, saiba mais sobre 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 a escopos de autorização. Para pedir essas permissões, é necessário adicionar os tipos de dados que seu app precisa acessar em uma FitnessOptions instância. Quando seu 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 pede autorização ao usuário para esses escopos.

Criar um cliente da API

Crie um cliente da 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 de sensores em segundo plano, sempre ativada e de baixa potência.
• HistoryClient: insira, exclua e leia dados históricos no Google Fit.
• SessionsClient: crie e gerencie sessões de atividade do usuário.
• GoalsClient: leia as metas de Pontos cardio e de passos criadas pelos usuários no Google Fit.
• ConfigClient: acesse tipos de dados e configurações personalizados na plataforma Google Fit.

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

Fluxo de autorização do usuário resultante

A seguir, mostramos o fluxo de autorização resultante que os usuários têm quando são solicitadas 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 seu 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 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 pede ao usuário para conceder 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 a verificação

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