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. 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 nova conta ou usar uma existente. É recomendável criar uma conta separada para testar o app da perspectiva do usuário.

Instalar o Google Play Services

Acesse 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 Install, selecione-os e clique em Install Packages.

Gerar 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 o uso do ambiente de desenvolvimento do Android Studio para criar um app com a API Fitness. Para saber mais 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 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.2.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.2.0'
}

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

Criar e testar seu app

Depois de concluir as etapas de configuração, comece a criar o 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.

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 quais tipos de dados seu app precisa acessar em uma instância FitnessOptions. Quando seu app pede para usar qualquer um dos tipos de dados do Google Fit, o SDK do Android verifica automaticamente a que escopos eles pertencem e pede 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 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 dos sensores de hardware do dispositivo local e dos complementares.
• RecordingClient: para coleta de dados do sensor em segundo plano sempre ativada e com baixo consumo de energia.
• HistoryClient: inserir, excluir e ler dados históricos no Google Fit.
• SessionsClient: criar e gerenciar Sessões de atividade do usuário.
• GoalsClient: leia as metas de Pontos cardio e passos criadas por usuários no Google Fit.
• ConfigClient: acesse tipos de dados personalizados e configurações na plataforma Google Fit.

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

Fluxo de autorização do usuário resultante

Confira a seguir o fluxo de autorização resultante que aparece para os usuários quando as permissões são solicitadas:

Figura 1.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. Após o download do app, ele solicita 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, é necessário solicitar a verificação com diferentes níveis de justificativa necessários para escopos sensíveis e restritos.