Inicialização da estrutura de atualização

Depois de definir as propriedades de configuração (consulte Exemplo básico: Uso da versão ApplicationUpdaterUI ), chame o método initialize() para inicializar a atualização:

appUpdater.initialize();

Esse método faz o seguinte:

  • Ele inicializa a estrutura de atualização, instalando de forma silenciosa e síncrona todas as atualizações pendentes. É necessário para chamar esse método durante a inicialização do aplicativo, pois ele pode reiniciar o aplicativo quando chamado.

  • Ele verifica se existe uma atualização adiada e a instala.

  • Se houver um erro durante o processo de atualização, ele limpa o arquivo de atualização e as informações de versão da área de armazenamento do aplicativo.

  • Se o tempo limite tiver expirado, o processo de atualização e iniciado. Caso contrário, ele inicia o timer.

Chamar esse método pode resultar no despacho dos seguintes eventos pelo objeto atualizador:

  • UpdateEvent.INITIALIZED — Despachado quando a inicialização é concluída.

  • ErrorEvent.ERROR — Despachado quando há um erro na inicialização.

No despacho do evento UpdateEvent.INITIALIZED , o processo de atualização é concluído.

Quando você chama o método initialize() , o atualizador inicia o processo de atualização e conclui todas as etapas com base na configuração de tempo do timer. No entanto, você também pode iniciar o processo de atualização a qualquer momento chamando o método checkNow() do objeto atualizador:

appUpdater.checkNow();

Esse método não faz nada se o processo de atualização já estiver em execução. Caso contrário, ele começa o processo de atualização.

O objeto atualizador pode despachar o seguinte evento como resultado de chamar o método checkNow() :

  • Evento UpdateEvent.CHECK_FOR_UPDATE , antes de ele tentar baixar o arquivo de descritor de atualização.

Se você cancelar o evento checkForUpdate , poderá chamar o método checkForUpdate() do objeto atualizador. (Consulte a próxima seção.) Se você não cancelar o evento, o processo de atualização continuará para verificar se há arquivo de descritor de atualização.