Conexão Saúde

  
Permite que os desenvolvedores leiam ou gravem registros de saúde e condicionamento físico do usuário.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
10 de janeiro de 2024 - - - 1.1.0-alpha07

Como solicitar acesso a tipos de dados

Para nos ajudar a aumentar a privacidade e a segurança do usuário, os desenvolvedores que fazem a integração com a Conexão Saúde precisam declarar acesso de leitura e/ou gravação aos tipos de dados usados pelos apps. Os desenvolvedores precisam incluir casos de uso válidos para os tipos de dados usados com base na finalidade do app. Para saber mais, acesse Enviar informações no formulário de declaração de apps de saúde e Permissões da Conexão Saúde do Android.

Declarar dependências

Para adicionar uma dependência da Conexão Saúde, é preciso adicionar o repositório Maven do Google ao seu projeto. Consulte Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

Groovy

dependencies {
    // Use to implement health connects
    implementation "androidx.health.connect:connect-client:1.1.0-alpha08"
}

Kotlin

dependencies {
    // Use to implement health connects
    implementation("androidx.health.connect:connect-client:1.1.0-alpha08")
}

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.1

Versão 1.1.0-alpha07

10 de janeiro de 2024

Lançamento de androidx.health.connect:connect-client:1.1.0-alpha07. A versão 1.1.0-alpha07 contém estas confirmações.

Mudanças na API

  • Retorne SDK_UNAVAILABLE quando #getSdkStatus for chamado de um contexto de usuário de perfil. (I91df3).
  • O SleepStageRecord foi removido. (/If6ada).

Correções de bugs

  • Uma RemoteException é gerada em vez de IllegalStateException em falhas de vinculação. (Id2233).

Versão 1.1.0-alpha06

18 de outubro de 2023

Lançamento de androidx.health.connect:connect-client:1.1.0-alpha06. A versão 1.1.0-alpha06 contém estas confirmações.

Mudanças na API

  • Torna as definições de recordingMethod públicas. (I401fb).

Correções de bugs

  • Foi adicionada uma documentação ao trajeto de exercício especificando que o local precisa ser anterior ao horário de término da sessão. (0e51e6).

Versão 1.1.0-alpha05

4 de outubro de 2023

Lançamento de androidx.health.connect:connect-client:1.1.0-alpha05. A versão 1.1.0-alpha05 contém estas confirmações.

Mudanças na API

  • Foi adicionada uma intent que acessa a tela de gerenciamento de dados do Conexão Saúde. (Ibf591).
  • Remoção dos métodos descontinuados em AggregationResult. (Idbda9).
  • Foi adicionada uma API de conveniência para criar ReadRecordsRequest, além de excluir e ler registros com um tipo de registro reificado. (If58a5).

Correções de bugs

  • Correção de um bug no Android 14 em que campos nutricionais nulos estavam sendo retornados como Double.MIN_VALUE. (1aa1d1).
  • Foi corrigido um bug no Android 14 em que a agregação por período mensal/anual gerava uma exceção na resposta porque os buckets tinham o mesmo horário de início/término (281313).

Versão 1.1.0-alpha04

6 de setembro de 2023

Lançamento de androidx.health.connect:connect-client:1.1.0-alpha04. A versão 1.1.0-alpha04 contém estas confirmações.

Mudanças na API

Correções de bugs

Versão 1.1.0-alpha03

26 de julho de 2023

Lançamento de androidx.health.connect:connect-client:1.1.0-alpha03. A versão 1.1.0-alpha03 contém estas confirmações.

Novos recursos

  • API para ler e gravar trajetos de exercícios:
    • ExerciseRouteResult: adicionada a ExerciseSessionRecord
    • Adição de ExerciseRouteRequestContract.

Mudanças na API

  • Adição de ExerciseRouteResult e das subclasses: Data, NoData e ConsentRequiredStates.
  • ExerciseRoute foi adicionada como uma classe autônoma, que armazena dados de local do trajeto. (I22eed).
  • PERMISSION_WRITE_EXERCISE_ROUTE foi adicionado. (I92fc4).
  • ExerciseRouteRequestContract adicionado, HealthPermissionsRequestContract adicionado. (Ief0e5).

Correções de bugs

  • Construção fixa de energia em quilojoules (Ie8791).

Versão 1.1.0-alpha02

21 de junho de 2023

Lançamento de androidx.health.connect:connect-client:1.1.0-alpha02. A versão 1.1.0-alpha02 contém estas confirmações.

Correções de bugs

  • Correção do vazamento de HealthDataSdkService (Ia3ba5).
  • Sempre redirecione para o cliente HealthConnect certo ao solicitar permissões no Android U (I6415a).

Versão 1.1.0-alpha01

7 de junho de 2023

Lançamento de androidx.health.connect:connect-client:1.1.0-alpha01. Essa versão é desenvolvida em uma ramificação interna.

Novos recursos

  • Suporte à versão do framework do Android 14 da Conexão Saúde. Esse SDK é um pré-requisito do Android 14. Os apps não poderão ser integrados à Conexão Saúde no Android 14 sem ele.
  • Método de gravação adicionado para gravar metadados.

Mudanças na API

  • Alterações na API Session:
    • Vários estágios do sono foram adicionados a SleepSessionRecord e SleepStageRecord foram removidos.
    • ExerciseLap e ExerciseSegment foram adicionados a ExerciseSessionRecord.
  • Limites de taxa periódicos e diários (incluindo limites de memória) para operações de leitura, registro de alterações, inserção e exclusão.
  • Validação adicionada para todos os campos NutritionRecord.
  • Validação adicionada para HeartRateVariabilityRmssdRecord.
  • Duas APIs descontinuadas foram removidas: HealthConnectClient#isProviderAvailable e HealthConnectClient#isApiSupported.

Correções de bugs

  • Igualdade de unidades fixas para todos os tipos de unidades, a igualdade não depende mais do tipo usado para inicialização da unidade. Por exemplo: Mass.grams(1000) agora é igual a Mass.kilograms(1).

Versão 1.0

Versão 1.0.0-alpha11

22 de fevereiro de 2023

Lançamento de androidx.health.connect:connect-client:1.0.0-alpha11. A versão 1.0.0-alpha11 contém estas confirmações.

Mudanças na API

  • Adição de uma intent para abrir o Conexão Saúde (Ic8055).
  • Remoção de alguns tipos de exercício. Use EXERCISE_TYPE_STRENGTH_TRAINING, EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING ou EXERCISE_TYPE_CALISTHENICS no lugar dos tipos removidos (I7291c).
  • Adição da nova API sdkStatus(), que combina as duas APIs descontinuadas isSdkSupported() e isProviderAvailable() (Iac89d).
  • Mudança das APIs que recebem providerPackageName para aceitar uma única string em vez de uma lista (I67e0f).

Versão 1.0.0-alpha10

25 de janeiro de 2023

Lançamento de androidx.health.connect:connect-client:1.0.0-alpha10. A versão 1.0.0-alpha10 contém estas confirmações.

Mudanças na API

  • ExerciseEventRecord, ExerciseLapRecord, ExerciseRepititionRecord e SwimmingStrokesRecord não têm mais suporte como RecordTypes. Eles não podem mais ser gravados nem lidos na HealthConnect. Remova todas as referências a esses tipos de dados da integração HealthConnect (If7ca2).
  • Mudanças nas APIs de permissões para que aceitem permissões em um novo formato baseado em strings. Essa mudança também exige mudar a declaração de permissões para o formato padrão do Android (Ib0a2f).

Versão 1.0.0-alpha09

11 de janeiro de 2023

Lançamento de androidx.health.connect:connect-client:1.0.0-alpha09. A versão 1.0.0-alpha09 contém estas confirmações.

Novos recursos

  • Dois novos tipos de dados de saúde da mulher para o Conexão Saúde: IntermenstrualBleedingRecord e MenstruationPeriodRecord. Os valores para MenstruationFlow.ENUMs são: "Light" (leve), "Medium" (médio), "Heavy" (forte) e "Unknown" (desconhecido).

Mudanças na API

  • IntermenstrualBleedingRecord foi adicionado (Idc470).
  • O tipo de registro MenstruationPeriodRecord foi adicionado (Iea545).

Versão 1.0.0-alpha08

7 de dezembro de 2022

Lançamento de androidx.health.connect:connect-client:1.0.0-alpha08. A versão 1.0.0-alpha08 contém estas confirmações.

Mudanças na API

  • Adiciona BodyWaterMass, HeartRateVariabilityRmssdRecord como novos tipos de registro com suporte (Ifd58f).
  • Remove HipCircumferenceRecord e WaistCircumferenceRecord como RecordTypes com suporte (I62fb9).
  • O MenstruationFlowRecord.flow foi modificado de stringdef para intdefs (I0369f).
  • Os campos Record de tipo enumerado com Strings foram modificados para Integers a fim de melhorar o desempenho (I3b295).
  • Os campos ExerciseSession, ExerciseRepetitions, SleepStage de tipo enumerado foram modificados de strings para tipos de números inteiros (Id32a9).
  • ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL foi renomeado (I5d7bd).
  • Adiciona "Incomum" aos tipos enumerados CervicalMucus. "Clear" foi renomeado como "Eggwhite" para ser mais específico. CervicalMucus#appearance e #sensation foram modificados de StringDefs para IntDefs (I3ac51).
  • StringDef do tipo enumerado DeviceTypes foi movida para IntDefs em "Device" (I3abf3).
  • Adiciona HealthConnectClient.isApiSupported(), que retorna "false" nas versões do SDK sem implementações compatíveis. HealthConnectClient.isAvailable->isProviderAvailable foi renomeado (I3674e).

Correções de bugs

  • Não é permitido usar valores de HeartRate beatsPerMinute menores que 1 (I6052f).
  • A anotação @JvmDefaultWithCompatibility foi adicionada (I8f206).

Versão 1.0.0-alpha07

24 de outubro de 2022

Lançamento de androidx.health.connect:connect-client:1.0.0-alpha07. A versão 1.0.0-alpha07 contém estas confirmações.

Mudanças na API

  • Argumentos de registro sem valores padrão são colocados antes dos argumentos com valores padrão. Para manter a consistência, os argumentos Instant e ZoneOffset são sempre colocados no início (Id618c).
  • O HealthConnectClient.getOrCreate#packageNames foi renomeado como providerPackageNames (Id81e4).

Correções de bugs

  • Adição das validações de valor do campo de registro. Valores muito incorretos vão gerar IllegalArgumentExceptions quando o valor fornecido estiver fora dos limites razoáveis (Ie171d).
  • Validação do horário de início do registro antes do horário de término, quando relevante (I02460).

Versão 1.0.0-alpha06

5 de outubro de 2022

Lançamento de androidx.health.connect:connect-client:1.0.0-alpha06. A versão 1.0.0-alpha06 contém estas confirmações.

Correções de bugs

  • Melhora o ciclo de vida da conexão de serviço (If2bd5).
  • Foi corrigido um bug de falha de NPE quando a exceção era gerada na conexão de serviço (I13546).

Versão 1.0.0-alpha05

21 de setembro de 2022

Lançamento de androidx.health.connect:connect-client:1.0.0-alpha05. A versão 1.0.0-alpha05 contém estas confirmações.

Mudanças na API

  • Renomeação de Metadata.uid como Metadata.id e uso da terminologia recordId de forma consistente em todas as APIs CRUD relacionadas (I3d1d2).
  • Transformação de PermissionController.createRequestPermissionActivityContract em um método estático em vez de um método de instância. Renomeado como PermissionController.createRequestPermissionResultContract (Icd2fe).
  • Adição do tipo de unidade BloodGlucose para BloodGlucoseRecord (I97678).
  • MenstruationRecord foi renomeado como MenstruationFlowRecord (I3b88e).

Correções de bugs

  • Corrigidos comportamentos não intencionais que não propagam estatísticas em primeiro plano do processo do cliente (Ifb44c).

Versão 1.0.0-alpha04

androidx.health.connect:connect-client:1.0.0-alpha04 foi lançado em 24 de agosto de 2022. A versão 1.0.0-alpha04 contém estas confirmações.

Migração para o androidx.health.connect

A partir da versão 1.0.0-alpha04, androidx.health:health-connect-client foi migrado para androidx.health.connect:connect-client. Para acessar versões anteriores da Conexão Saúde, acesse a página androidx.health.

Para migrar, basta mudar a importação da dependência de androidx.health:health-connect-client:1.0.0-alpha03 para androidx.health.connect:connect-client:1.0.0-alpha04.

Novos recursos

  • Inclusão de registros de depuração opcionais integrados para chamadas de API (link).

Mudanças na API

  • Os metadados clientId foram renomeados como clientRecordId, e clientVersion como clientRecordVersion (link).
  • O UID de metadados agora é mais fácil de usar para os leitores e não é mais anulável (link).
  • Adicionamos Libras como uma unidade de massa (link).
  • DeletionChange.deleteUid foi renomeado como uid (link).
  • O elemento Permission foi renomeado como HealthPermission. Isso evita ambiguidade com permissões do framework do Android (link).

Correções de bugs

  • Foram corrigidos problemas de regressão com unidade de calorias incorreta com a energia (link).
  • Foram corrigidos problemas de regressão com agregação para alguns tipos de registro (link).