Reiniciar API

A API de reinicialização permite que qualquer aplicativo, incluindo aplicativos Win32 empacotados ou não empacotados, encerre e reinicie-se sob comando, incluindo a capacidade de fornecer uma cadeia de caracteres de linha de comando arbitrária para a instância reiniciada.

Definição

public static AppRestartFailureReason Restart(String arguments)

Parâmetros

arguments: Cadeia de caracteres

Os argumentos a serem passados para a instância reiniciada.

Devoluções

A API de reinicialização retorna um AppRestartFailureReason.

Pré-requisitos

Para usar a API de ciclo de vida do aplicativo no SDK do Aplicativo Windows:

1. Transfira e instale a versão mais recente do SDK de Aplicações Windows. Para obter mais informações, consulte Introdução ao WinUI.
2. Siga as instruções para criar seu primeiro projeto WinUI 3 ou para usar o SDK do aplicativo Windows em um projeto existente.

O que é este método de reinicialização?

Para aplicativos Win32, o seguinte existe como possíveis mecanismos de reinicialização:

• O Win32 API RegisterApplicationRestart permite que um aplicativo se registre para ser reiniciado após o encerramento e forneça uma cadeia de caracteres de linha de comando arbitrária para a instância reiniciada. Os motivos para o encerramento incluem falha ou travamento do aplicativo, atualização do aplicativo ou atualização do sistema.

No entanto, existia uma lacuna para o seguinte cenário:

• As aplicações Win32 podem registrar-se no sistema operativo para reiniciar em estados específicos da aplicação/sistema operativo, mas não pode iniciar uma reinicialização a partir de um estado saudável

Esta API de reinicialização permite que os aplicativos Win32 encerrem e reiniciem no comando, e está alinhada com o CoreApplication.RequestRestartAsync existente.

Reiniciando com argumentos de linha de comando

Basta chamar o método Restart e especificar uma cadeia de caracteres de linha de comando arbitrária para a instância reiniciada ser reiniciada. A reinicialização é concluída de forma síncrona e nenhuma ação ou manipulação adicional é necessária. Se a reinicialização falhar por algum motivo, o método Restart retornará um motivo de falha.

Exemplos

private void restartAfterUpdate()
{
    AppRestartFailureReason restartError = AppInstance.Restart(restartArgsInput);

    switch (restartError)
    {
        case AppRestartFailureReason.RestartPending:
            SendToast("Another restart is currently pending.");
            break;
        case AppRestartFailureReason.InvalidUser:
            SendToast("Current user is not signed in or not a valid user.");
            break;
        case AppRestartFailureReason.Other:
            SendToast("Failure restarting.");
            break;
    }
}

Para ver Exemplos de reinicialização, visite o repositórioWindowsAppSDK-Samples.