Primeiros passos no Android

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

Configuração

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

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.

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.

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

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.

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 KotlinDSL do Groovy
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")
}
 
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.

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

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.

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.

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.