Agendamento

A aba Agendar

É uma tela de status, não um painel de ajustes. Ela informa rapidamente:

Se o agendamento está ativado ou desativado
A próxima execução agendada, se houver
O resultado da última execução

Um botão — Configurar agendamento ou Gerenciar agendamento — abre a tela de detalhes.

Configurações do agendamento

Ativar exportações agendadas

Controle mestre no topo. Quando desativado, não há execuções em segundo plano nem notificações.

Frequência

Diária, semanal ou personalizada. Agendamentos personalizados se repetem a cada N dias, semanas ou meses desde uma data inicial. O período retrospectivo define quantos dias concluídos cada execução abrange.

Horário

Hora e minuto. O iOS trata isso como uma indicação, não como garantia — veja as limitações abaixo.

Histórico de exportações

A lista no fim da tela Agendar registra cada execução agendada e seu resultado. Toque em uma linha para ver detalhes. Execuções com falha incluem um botão Tentar novamente, que repete o intervalo com as configurações e o destino atuais e depois registra uma nova linha no histórico.

Como o agendamento do iOS realmente funciona

1. Horário previstoO Health.md pede ao iOS que desperte o app perto do horário escolhido. 2. Tentativa em segundo planoSe o dispositivo estiver disponível, o iOS executa uma tarefa de atualização. 3. Alternativa com bloqueioSe o HealthKit estiver indisponível, o Health.md envia uma notificação. 4. Toque para concluirAo abrir a notificação, o app pode ler o HealthKit e exportar.

Limitações do iOS que você deve conhecer.

Os dados do HealthKit não podem ser lidos enquanto o dispositivo está bloqueado. As exportações agendadas usam BGAppRefreshTask, que o iOS agenda de forma oportunista conforme os padrões de uso — o horário definido é uma meta, não um contrato. Como alternativa, o app envia uma notificação local no horário agendado se o dispositivo estiver bloqueado; toque nela para executar a exportação.

O horário é aproximado. O iOS pode executar antes ou depois, ou ignorar a tarefa se o aparelho estiver desligado ou desconectado.
As exportações funcionam melhor quando o telefone costuma estar conectado à energia e desbloqueado aproximadamente no mesmo horário.
Se a exportação falhar porque o dispositivo estava bloqueado, toque na notificação para executá-la com acesso ao HealthKit.

Controle programático

Você pode ativar ou desativar o agendamento nos Atalhos com o intent Ativar ou desativar exportação agendada. Veja exemplos em Atalhos.

Agendamentos por perfil e cancelamento

Cada perfil mantém seu próprio agendamento, inclusive uma cadência personalizada; trocar o perfil ativo não redireciona outro agendamento.
Um aviso de colisão aparece quando perfis podem gravar os mesmos caminhos gerados no mesmo destino. Revise-o antes de ativar agendamentos concorrentes; o Health.md não altera nenhum perfil silenciosamente.
Parar ou Cancelar encerra somente a tentativa atual. Datas concluídas permanecem assim, as pendentes podem ser repetidas e o agendamento continua ativo.
Cada item do histórico permanece ligado ao perfil da execução e ao rótulo privado do destino realmente usado.

Gerencie configurações congeladas e destino em Perfis de exportação.