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 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:

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.

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:

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.