Compartilhar via


Package.GetAppInstallerInfo Método

Definição

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

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.

Aplica-se a

Confira também