Primeiros passos no Android

Este guia explica como começar a desenvolver 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 a seguir.

Criar uma Conta do Google

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

Instalar o Google Play Services

Instale 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 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 saber como criar e configurar um novo projeto 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.2.0")
        implementation("com.google.android.gms:play-services-auth:21.3.0")
}

DSL do Groovy

apply plugin: 'com.android.application'

...

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

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

Criar e testar seu app

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

Conseguir as permissões necessárias do Android

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

Receber permissões do OAuth

Os tipos de dados que o app tem permissão para acessar correspondem aos escopos de autorização. Para solicitar essas permissões, é necessário adicionar os tipos de dados que o app precisa acessar em uma instância de FitnessOptions. Quando o app solicita o uso de qualquer um dos tipos de dados do Google Fit, o SDK do Android verifica automaticamente a qual escopo eles pertencem 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 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 coletar dados de sensores em segundo plano com pouca energia e sempre ativados.
• HistoryClient: insira, exclua e leia dados históricos no Google Fit.
• SessionsClient: crie e gerencie sessões de atividade do usuário.
• GoalsClient: ler as metas de passos e pontos cardio criadas pelos usuários no Google Fit.
• ConfigClient: acesse tipos de dados e configurações personalizadas na plataforma Google Fit.

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

Fluxo de autorização do usuário resultante

O exemplo a seguir mostra o fluxo de autorização resultante que os usuários encontram quando são solicitados para conceder permissões:

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

1. Permissões do Android: os usuários podem conferir as permissões do Android que seu app solicitou antes de fazer o download. Depois que o app é transferido por download, 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: 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 solicita 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 permissões, o 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 restritos e confidenciais.