Primeiros passos no Android

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 conta existente. Talvez seja interessante criar uma conta separada para testar seu app da perspectiva de um usuário.

Instalar o Google Play Services

Instale a biblioteca de cliente mais recente do Google Play Services no 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 detalhes sobre como criar e configurar um 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:

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.4.0")
}

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.4.0'
}

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

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, adicione os tipos de dados que 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 quais escopos eles pertencem e pede 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 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 em segundo plano de dados de sensores com baixo consumo de energia e sempre ativada.
• HistoryClient: insere, exclui e lê dados históricos no Google Fit.
• SessionsClient: crie e gerencie sessões de atividade do usuário.
• GoalsClient: lê metas de Pontos cardio e 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:

1. Permissões do Android: os usuários veem quais permissões do Android seu app solicitou antes do 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 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, seu app pode acessar os tipos de dados que pertencem aos escopos para os quais o usuário concedeu permissão.