Package.GetAppInstallerInfo Método

Definição

Namespace:

Windows.ApplicationModel

Retorna o local do arquivo XML .appinstaller. Use esse método quando precisar recuperar o local do arquivo XML .appinstaller para seu aplicativo. Por exemplo, isso será útil se seu aplicativo precisar compartilhar um URI com seu arquivo .appinstaller associado. Opcionalmente, você pode adicionar argumentos ao URI.

public:
 virtual AppInstallerInfo ^ GetAppInstallerInfo() = GetAppInstallerInfo;

AppInstallerInfo GetAppInstallerInfo();

public AppInstallerInfo GetAppInstallerInfo();

function getAppInstallerInfo()

Public Function GetAppInstallerInfo () As AppInstallerInfo

Retornos

AppInstallerInfo

O local do arquivo XML .appinstaller.

Requisitos do Windows

Família de dispositivos	Windows 10, version 1809 (introduzida na 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v7.0)

Exemplos

O exemplo a seguir gera um URI .appinstaller com argumentos e cria um email para enviar o URI para outro usuário. Neste exemplo, supõe-se que o ComposeEmailAsync método seja definido em outro lugar.

AppInstallerInfo info = Windows.ApplicationModel.Package.Current.GetAppInstallerInfo();
if (info != null)
{
    // Uri that was used to install the app.
    // Example: http://contoso/connect4.appinstaller.
    Uri appInstallerUri = info.Uri;

    // Create the inner URI which uses a protocol handled by your app, passing any arguments needed in it 
    UriBuilder innerUriBuilder = new UriBuilder("my-app-protocol:");
    innerUriBuilder.Query = "difficulty=hard&highscore=9000";

    // Create outer URI builder for ms-appinstaller initializer link.
    UriBuilder outerUriBuilder = new UriBuilder("ms-appinstaller:");
    outerUriBuilder.Query =
        $"source={Uri.EscapeDataString(appInstallerUri.ToString())}&activationUri={Uri.EscapeDataString(innerUriBuilder.ToString())}";

    await ComposeEmailAsync(/* To */ colleagueEmail, /* Subject */ "Beat my high score!",
        /* Body */ outerUriBuilder.ToString());
}

Comentários

Use esse método se quiser obter o URI para o arquivo .appinstaller associado ao aplicativo atual para que você possa compartilhar o URI com os usuários. Se um usuário que não tiver o aplicativo clicar no URI, ele será levado por meio do processo de instalação do aplicativo. Se um usuário que já tiver o aplicativo clicar no URI, o aplicativo será atualizado, se necessário, e ele será aberto.

Opcionalmente, você pode adicionar argumentos ao URI. Nesse caso, o comportamento é o mesmo descrito acima, mas o aplicativo pode usar os argumentos quando for aberto. Os argumentos devem usar um protocolo compatível com o aplicativo. Para obter mais informações, consulte Manipular ativação de URI.

Confira também

• Uri
• APIs do Instalador de Aplicativo
• Tratar a ativação do URI