Guia de migração

O portfólio do Google tem muitos produtos e serviços de saúde, incluindo a plataforma Conexão Saúde. A API Google Fit Android foi descontinuada e vai ter suporte até o final de 2024, quando será desativada. As diretrizes abaixo mostram para qual API ou plataforma migrar de cada API Google Fit Android.

API Sensor

A API Sensor permite ler dados brutos de sensor no app em tempo real. A API Sensor faz o seguinte:

  • Lista as fontes de dados disponíveis no dispositivo e em dispositivos complementares.
  • Registra listeners para receber dados brutos do sensor.
  • Cancela o registro dos listeners para que eles não recebam mais dados brutos de sensor.

Migre da API Sensor para as APIs ou plataformas abaixo:

Smartphone Wear

Use o SensorManager e o FusedLocationProvider

Use os Recursos de saúde

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    Ou use o SensorManager e o FusedLocationProvider

API Session

As sessões representam um intervalo de tempo em que os usuários realizam uma atividade de condicionamento físico.

A API Session permite que o app crie sessões no armazenamento de condicionamento físico.

Migre da API Session para as APIs ou plataformas abaixo:

Smartphone Wear

Iniciar/parar: não relevante. O aplicativo monitora o estado das sessões em andamento internamente.

Leitura/gravação: use a API Health Connect.

Iniciar/parar: use os Recursos de saúde (ExerciseClient).

Leitura/gravação: use a API Health Connect pelo app para dispositivos móveis.

Para fluxos de trabalho específicos, é recomendado:

  • Inserir uma sessão: os desenvolvedores precisam usar a API Health Connect e inserir um registro de ActivitySession (sessão de atividade) ou SleepSession (sessão de sono) de acordo com cada caso.

    • API Recording

    A API Recording cria assinaturas para permitir que o app solicite armazenamento automatizado de dados do sensor para economizar bateria. Uma assinatura é associada a um app Android e consiste em um tipo de dado de condicionamento físico ou uma fonte de dados específica.

    Migre da API Recording para as APIs ou plataformas abaixo:

    Smartphone Wear

    Siga estas etapas para migrar da API Recording:

    1. Implemente a captura de dados usando o SensorManager.
    2. Grave os dados capturados no app Conexão Saúde.
    3. Combine as etapas a e b quando necessário em um serviço em primeiro plano, por exemplo, quando você precisar continuar gravando dados sem interagir com o app em questão.

    Use os Recursos de saúde

    • PassiveMonitoringClient
    • ExerciseClient

      Consulte a documentação sobre os Recursos de saúde para saber mais sobre as diferenças entre o PassiveMonitoringClient e o ExerciseClient.

    History API

    A API History permite que o app execute operações em massa no armazenamento de dados de condicionamento físico, incluindo leitura, inserção, atualização e exclusão de dados históricos de saúde e bem-estar.

    Migre da API History para APIs ou plataformas abaixo:

    Smartphone Wear

    Use a API Health Connect

    Use a API no app para dispositivos móveis, não no wearable.

    API Goals

    A API Goals oferece objetivos no app Google Fit que os usuários podem definir por conta própria. Os objetivos ajudam a motivar os usuários a se manterem ativos todos os dias. No perfil, os usuários podem ajustar quantos passos e pontos cardio querem atingir a cada dia. A plataforma Fit registra os objetivos e monitora a atividade diária deles usando a API Goals.

    Smartphone Wear
    Nenhuma API de substituição disponível. Nenhuma API de substituição disponível.

    API BLE

    O app pode encontrar dispositivos Bluetooth de baixa energia (BLE) disponíveis e inserir dados do sensor na plataforma Google Fit usando a API BLE.

    Migre da API BLE para as APIs ou plataformas abaixo:

    Smartphone Wear
    Use as APIs Bluetooth do Android diretamente. Use as APIs Bluetooth do Android diretamente.

    Migrar da API Fit Android para a API Health Connect

    Há três etapas principais que você precisa seguir para migrar para a API Health Connect.

    Etapa 1: integrar

    A primeira etapa para a integração é adicionar a API Health Connect ao seu app. Para isso, é necessário:

    • Seguir as etapas descritas neste link para fazer a integração com a API Health Connect.
    • Declarar os tipos de dados e o modo de acesso necessários no manifesto do app.
    • Solicitar a permissão do usuário para acessar a plataforma Conexão Saúde.
    • Ler/gravar dados de acordo com seus casos de uso ou fluxos de trabalho específicos.

    Etapa 2: migrar

    É recomendável manter as integrações da API Google Fit Android e da API Health Connect ativas enquanto os usuários migram de uma plataforma para outra. O uso da API Fit Android foi descontinuado e pretendemos desativar essa API antes do fim de 2024. Isso vai dar aos usuários tempo suficiente para mudar para a API Health Connect e continuar com o serviço.

    Etapa 3: limpeza

    Siga estas etapas para remover o SDK do Fit:

    1. Remova o código associado à API Fit Android.
    2. Remova as dependências.

    Cabe a você calcular quanto tempo vai levar para descontinuar a API Fit Android com base nas próprias análises e avaliações. Você pode continuar a usar a integração com a API Fit Android até o final de 2024.