Conexão Saúde
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.
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 deIllegalStateException
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
- Somente Java: renomeie o campo
getHasMore()
emChangesResponse
parahasMore()
. (I80695). - Alinhar a verificação
HealthPermissionsRequestContract#createIntent
entre as versões do Android. O contrato verifica se todas as permissões estão relacionadas à saúde. (I143fc).
Correções de bugs
- A exceção gerada quando
ExerciseSessionRecord
é criada com umaExerciseRoute
contendo uma lista vazia de locais foi corrigida. (I45c16). - Atualizamos a documentação do
SleepSessionRecord
e o exemplo de código para ler sessões de sono. (Idf0de).
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 aExerciseSessionRecord
- Adição de
ExerciseRouteRequestContract
.
Mudanças na API
- Adição de
ExerciseRouteResult
e das subclasses:Data
,NoData
eConsentRequiredStates
. 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
eSleepStageRecord
foram removidos. ExerciseLap
eExerciseSegment
foram adicionados aExerciseSessionRecord
.
- Vários estágios do sono foram adicionados a
- 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
eHealthConnectClient#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
ouEXERCISE_TYPE_CALISTHENICS
no lugar dos tipos removidos (I7291c). - Adição da nova API
sdkStatus()
, que combina as duas APIs descontinuadasisSdkSupported()
eisProviderAvailable()
(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
eSwimmingStrokesRecord
não têm mais suporte comoRecordTypes
. Eles não podem mais ser gravados nem lidos naHealthConnect
. Remova todas as referências a esses tipos de dados da integraçãoHealthConnect
(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
eMenstruationPeriodRecord
. Os valores paraMenstruationFlow.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
eWaistCircumferenceRecord
comoRecordTypes
com suporte (I62fb9). - O
MenstruationFlowRecord.flow
foi modificado destringdef
paraintdefs
(I0369f). - Os campos Record de tipo enumerado com
Strings
foram modificados paraIntegers
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 deStringDefs
para IntDefs (I3ac51). StringDef
do tipo enumeradoDeviceTypes
foi movida paraIntDefs
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
eZoneOffset
são sempre colocados no início (Id618c). - O
HealthConnectClient.getOrCreate#packageNames
foi renomeado comoproviderPackageNames
(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
comoMetadata.id
e uso da terminologiarecordId
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 comoPermissionController.createRequestPermissionResultContract
(Icd2fe). - Adição do tipo de unidade
BloodGlucose
paraBloodGlucoseRecord
(I97678). MenstruationRecord
foi renomeado comoMenstruationFlowRecord
(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 comoclientRecordId
, eclientVersion
comoclientRecordVersion
(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).