O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

nl :: Tecer:: DeviceLayer :: SoftwareUpdateManager

Resumo

Herança

Subclasses diretamente conhecidas:
  nl :: Weave :: DeviceLayer :: SoftwareUpdateManagerImpl
  nl :: Weave :: DeviceLayer :: SoftwareUpdateManagerImpl
  nl :: Weave :: DeviceLayer :: SoftwareUpdateManagerImpl

Tipos públicos

ActionType {
kAction_Ignore ,
kAction_DownloadNow ,
kAction_DownloadLater ,
kAction_ApplicationManaged
}
enum
Quando uma atualização de software está disponível, o aplicativo pode escolher uma das seguintes ações como parte do retorno de chamada de evento da API SoftwareUpdateAvailable.
EventCallback )(void *apAppState, EventType aEvent, const InEventParam &aInParam, OutEventParam &aOutParam) typedef
void(*
EventType {
kEvent_PrepareQuery ,
kEvent_PrepareQuery_Metadata ,
kEvent_QueryPrepareFailed ,
kEvent_QuerySent ,
kEvent_SoftwareUpdateAvailable ,
kEvent_FetchPartialImageInfo ,
kEvent_PrepareImageStorage ,
kEvent_StartImageDownload ,
kEvent_StoreImageBlock ,
kEvent_ComputeImageIntegrity ,
kEvent_ResetPartialImageInfo ,
kEvent_ReadyToInstall ,
kEvent_StartInstallImage ,
kEvent_Finished ,
kEvent_DefaultCheck = 100
}
enum
Eventos de API gerados pelo objeto SoftwareUpdateManager .
RetryPolicyCallback )(void *aAppState, RetryParam &aRetryParam, uint32_t &aOutIntervalMsec) typedef
void(*
State enum

Aulas de amigos

Internal::GenericPlatformManagerImpl
friend class

Funções públicas

Abort (void)
CheckNow (void)
GetState (void)
State
ImageInstallComplete ( WEAVE_ERROR aError)
IsInProgress (void)
bool
PrepareImageStorageComplete ( WEAVE_ERROR aError)
SetEventCallback (void *const aAppState, const EventCallback aEventCallback)
SetQueryIntervalWindow (uint32_t aMinWaitTimeMs, uint32_t aMaxWaitTimeMs)
SetRetryPolicyCallback (const RetryPolicyCallback aRetryPolicyCallback)
void

Funções estáticas públicas

DefaultEventHandler (void *apAppState, EventType aEvent, const InEventParam & aInParam, OutEventParam & aOutParam)
void

Funções protegidas

SoftwareUpdateManager ()=default
SoftwareUpdateManager (const SoftwareUpdateManager &)=delete
SoftwareUpdateManager (const SoftwareUpdateManager &&)=delete
operator= (const SoftwareUpdateManager &)=delete
~SoftwareUpdateManager ()=default

Structs

nl :: Weave :: DeviceLayer :: SoftwareUpdateManager :: RetryParam

Sindicatos

nl :: Weave :: DeviceLayer :: SoftwareUpdateManager :: InEventParam
nl :: Weave :: DeviceLayer :: SoftwareUpdateManager :: OutEventParam

Tipos públicos

Tipo de acão

 ActionType

Quando uma atualização de software está disponível, o aplicativo pode escolher uma das seguintes ações como parte do retorno de chamada de evento da API SoftwareUpdateAvailable.

A ação padrão será definida como kAction_Now.

Propriedades
kAction_ApplicationManaged

Permite que o aplicativo gerencie o restante das fases de atualização do software, como download, validação da integridade da imagem e instalação.

A máquina de estado do gerenciador de atualização de software mudará para o estado ApplicationManaged. As verificações de atualização de software programadas (se habilitadas) serão suspensas até que o aplicativo chame a API Abort ou ImageInstallComplete.

kAction_DownloadLater

Pausar o download ao iniciar.

As verificações de atualização de software agendadas (se habilitadas) serão suspensas. A máquina de estado permanecerá no estado de download. Quando estiver pronto, o aplicativo pode chamar a API de download de currículo para prosseguir com o download ou chamar Abort para cancelar.

kAction_DownloadNow

Comece o download imediatamente.

Um retorno de chamada de evento da API kEvent_FetchPartialImageInfo será gerado logo em seguida.

kAction_Ignore

Ignore o download completamente.

Um retorno de chamada de evento de API kEvent_Finished será gerado com o erro WEAVE_DEVICE_ERROR_SOFTWARE_UPDATE_CANCELLED se esta opção for selecionada e a lógica de repetição não for chamada.

EventCallback

void(* EventCallback)(void *apAppState, EventType aEvent, const InEventParam &aInParam, OutEventParam &aOutParam)

Tipo de evento

 EventType

Eventos de API gerados pelo objeto SoftwareUpdateManager .

Propriedades
kEvent_ComputeImageIntegrity

Calcule um valor de verificação de integridade da imagem.

Solicita que o aplicativo calcule um valor de verificação de integridade sobre a imagem baixada. Gerado quando o download é concluído.

kEvent_DefaultCheck

Verifique o comportamento padrão de tratamento de eventos.

Usado para verificar o tratamento de eventos padrão correto no aplicativo.

Os aplicativos NÃO devem lidar com este evento.

kEvent_FetchPartialImageInfo

Buscar informações de estado persistente para uma imagem baixada parcialmente.

Fornece uma oportunidade para o aplicativo divulgar informações de uma imagem parcial baixada anteriormente para que o download possa ser continuado a partir do ponto em que foi interrompido pela última vez. O URI da atualização de software disponível é fornecido como um parâmetro de entrada que o aplicativo pode usar para comparar se a imagem que está sendo baixada é igual à imagem parcial.

O aplicativo deve retornar o comprimento da imagem parcial no parâmetro de saída PartialImageLenInBytes. O aplicativo pode definir o valor de PartialImageLenInBytes como 0 para indicar que nenhuma imagem parcial existe ou que o URI da imagem parcial não corresponde.

O aplicativo pode escolher ignorar esse evento passando-o para o manipulador de eventos padrão. Se isso for feito, o sistema sempre fará o download da imagem completa do firmware disponível.

kEvent_Finished

Processo de atualização de software concluído.

Gerado quando uma verificação de atualização de software é concluída com ou sem erros. Os parâmetros incluídos neste evento fornecem o motivo da falha se a tentativa terminou devido a uma falha.

kEvent_PrepareImageStorage

Prepare-se para o armazenamento de uma nova imagem.

Solicita que o aplicativo execute todas as etapas necessárias para preparar o armazenamento local para o download de uma nova imagem de firmware. O aplicativo pode usar isso, por exemplo, para apagar páginas flash.

O evento PrepareImageStorage é gerado apenas no caso em que uma nova imagem de firmware está sendo baixada. Quando um download interrompido anteriormente é retomado, PrepareImageStorage não é gerado.

O aplicativo deve sinalizar a conclusão da operação de preparação chamando o método PrepareImageStorageComplete() . Isso pode ser feito no próprio retorno de chamada do evento ou posteriormente. Se chamado de uma tarefa diferente da tarefa Weave, o chamador deve manter o bloqueio de pilha Weave.

O aplicativo pode escolher ignorar o evento PrepareImageStorage passando-o para o manipulador de eventos padrão. Se isso for feito, o sistema passa automaticamente para o estado de download da imagem.

Para suportar a retomada de um download interrompido, o aplicativo deve manter o URI da imagem (fornecido como um parâmetro de evento) e usar isso ao lidar com eventos FetchPartialImageInfo subsequentes.

kEvent_PrepareQuery

Prepare a mensagem ImageQuery.

Gerado quando uma verificação de atualização de software foi acionada. Fornece uma oportunidade para o aplicativo fornecer informações relacionadas ao produto para a mensagem SofwareUpdate: ImageQuery.

kEvent_PrepareQuery_Metadata

Prepare metadados para a solicitação ImageQuery.

Fornece uma oportunidade para o aplicativo anexar metadados adicionais à mensagem SofwareUpdate: ImageQuery, se necessário. Gerado quando a implementação está pronta para obter metadados do aplicativo.

kEvent_QueryPrepareFailed

Erro ao preparar uma solicitação ImageQuery.

Gerado quando a implementação encontra um erro ao se preparar para enviar uma consulta de atualização de software.

kEvent_QuerySent

A solicitação ImageQuery foi enviada.

Evento informativo para sinalizar que uma mensagem SofwareUpdate: ImageQuery foi enviada.

kEvent_ReadyToInstall

A imagem está pronta para ser instalada.

Evento informativo para sinalizar que a imagem está pronta para ser instalada. Gerado quando uma imagem passa na verificação de integridade.

kEvent_ResetPartialImageInfo

Redefina o estado da imagem parcialmente baixada.

Solicita que o aplicativo esqueça o estado persistente associado a uma imagem baixada. Um evento ResetPartialImageInfo é gerado sempre que uma imagem baixada falha em sua verificação de integridade. Depois que um evento ResetPartialImageInfo foi processado, os eventos FetchPartialImageInfo subsequentes devem indicar que nenhuma imagem parcial está disponível.

Observe que, ao manipular o evento ResetPartialImageInfo, o aplicativo NÃO é obrigado a limpar os dados da imagem, apenas as informações de estado associadas à imagem (ou seja, o URI e o comprimento parcial da imagem).

Se o aplicativo não suportar a retomada do download da imagem, ele pode ignorar esse evento passando-o para o manipulador de eventos padrão.

kEvent_SoftwareUpdateAvailable

A atualização do software está disponível.

Gerado quando um SofwareUpdate: ImageQueryResponse é recebido em resposta a uma consulta contendo informações da atualização disponível.

kEvent_StartImageDownload

O download da imagem começou.

Evento informativo para sinalizar o início de uma transação de download de imagem.

kEvent_StartInstallImage

Comece a instalação da imagem.

Solicita que o aplicativo seja o processo de instalação de uma imagem de firmware baixada.

kEvent_StoreImageBlock

Armazene um bloco de dados de imagem.

Gerado sempre que um bloco de dados é recebido do servidor de download de arquivos. Os parâmetros incluídos neste evento fornecem os dados e o comprimento dos dados.

Para suportar a retomada de um download interrompido, o aplicativo deve manter uma contagem persistente do número total de bytes de imagem armazenados e usar esse valor ao manipular eventos FetchPartialImageInfo subsequentes.

RetryPolicyCallback

void(* RetryPolicyCallback)(void *aAppState, RetryParam &aRetryParam, uint32_t &aOutIntervalMsec)

Estado

 State

Aulas de amigos

Internal :: GenericPlatformManagerImpl

friend class Internal::GenericPlatformManagerImpl

Funções públicas

Abortar

WEAVE_ERROR Abort(
  void
)

Verifique agora

WEAVE_ERROR CheckNow(
  void
)

GetState

State GetState(
  void
)

ImageInstallComplete

WEAVE_ERROR ImageInstallComplete(
  WEAVE_ERROR aError
)

Está em andamento

bool IsInProgress(
  void
)

PrepareImageStorageComplete

WEAVE_ERROR PrepareImageStorageComplete(
  WEAVE_ERROR aError
)

SetEventCallback

WEAVE_ERROR SetEventCallback(
  void *const aAppState,
  const EventCallback aEventCallback
)

SetQueryIntervalWindow

WEAVE_ERROR SetQueryIntervalWindow(
  uint32_t aMinWaitTimeMs,
  uint32_t aMaxWaitTimeMs
)

SetRetryPolicyCallback

void SetRetryPolicyCallback(
  const RetryPolicyCallback aRetryPolicyCallback
)

Funções estáticas públicas

DefaultEventHandler

void DefaultEventHandler(
  void *apAppState,
  EventType aEvent,
  const InEventParam & aInParam,
  OutEventParam & aOutParam
)

Funções protegidas

SoftwareUpdateManager

 SoftwareUpdateManager()=default

SoftwareUpdateManager

 SoftwareUpdateManager(
  const SoftwareUpdateManager &
)=delete

SoftwareUpdateManager

 SoftwareUpdateManager(
  const SoftwareUpdateManager &&
)=delete

operador =

SoftwareUpdateManager & operator=(
  const SoftwareUpdateManager &
)=delete

~ SoftwareUpdateManager

 ~SoftwareUpdateManager()=default