Primeiros passos no Android

Este guia explica como iniciar o desenvolvimento com o Google Fit no Android.

Configuração

Antes de começar a criar seu app, conclua as etapas abaixo em outras seções.

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

Receba a biblioteca de cliente mais recente do Google Play Services para seu desenvolvimento host:

  1. Abra o Android SDK Manager.
  2. Em SDK Tools, localize 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, consiga um ID do cliente do OAuth 2.0.

Recomendamos usar o ambiente de desenvolvimento do Android Studio para criar um app com a API Fitness. Para sobre 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 dependência:

DSL do KotlinDSL maneiro
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 condicionamento físico quando ele cria seu app.

Criar e testar seu app

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

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

Os tipos de dados que o app tem permissão para acessar correspondem escopos de autorização. Para perguntar para essas permissões, você precisa adicionar quais tipos de dados o app precisa acessar em um FitnessOptions instância. Quando o app pedir para usar qualquer um dos dados do Google Fit tipos, o SDK do Android verifica automaticamente a quais escopos pertencem e solicita o usuário para autorização nesses escopos.

Crie um cliente de API e adicione os tipos de dados que seu app precisa acessar gravar ou ler dados. Os seguintes endpoints estão disponíveis:

  • SensorsClient: acesse diferentes fontes de dados de saúde e bem-estar com sensores de hardware no dispositivo local e em dispositivos complementares.
  • RecordingClient: para coleta de dados de sensores sempre ativada e com baixo consumo de energia.
  • HistoryClient: inserir, excluir e ler dados históricos em Google Fit
  • SessionsClient: crie e gerencie sessões de atividade do usuário.
  • GoalsClient: leia as metas de Pontos cardio e passos criadas pelos usuários no Google Fit.
  • ConfigClient: acesse configurações e tipos de dados personalizados na plataforma Google Fit.

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

Confira abaixo o fluxo de autorização resultante 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 tem. solicitou antes de fazer o download. Após o download do app, 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 a permissão ao seu app. os escopos do OAuth necessários para os tipos de dados que serão acessados.
  4. Acesso aplicado: depois que o usuário concede as permissões, o app pode: acessar os tipos de dados que pertencem aos escopos concedidos pelo usuário permissão.

Solicitar verificação

Depois de criar e testar seu app, inscreva-se para a verificação com diferentes os níveis de justificativa necessários para escopos sensíveis e restritos.