Package.GetAppInstallerInfo Método

Definición

Espacio de nombres:

Windows.ApplicationModel

Devuelve la ubicación del archivo XML .appinstaller. Use este método cuando necesite recuperar la ubicación del archivo XML .appinstaller para la aplicación. Por ejemplo, esto resulta útil si la aplicación necesita compartir un URI con su archivo .appinstaller asociado. Opcionalmente, puede agregar argumentos al URI.

public:
 virtual AppInstallerInfo ^ GetAppInstallerInfo() = GetAppInstallerInfo;

AppInstallerInfo GetAppInstallerInfo();

public AppInstallerInfo GetAppInstallerInfo();

function getAppInstallerInfo()

Public Function GetAppInstallerInfo () As AppInstallerInfo

Devoluciones

AppInstallerInfo

Ubicación del archivo XML .appinstaller.

Requisitos de Windows

Familia de dispositivos	Windows 10, version 1809 (se introdujo en la versión 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v7.0)

Ejemplos

En el ejemplo siguiente se genera un URI de .appinstaller con argumentos y se crea un correo electrónico para enviar el URI a otro usuario. En este ejemplo, se supone que el ComposeEmailAsync método se define en otro 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());
}

Comentarios

Use este método si desea obtener el URI al archivo .appinstaller asociado a la aplicación actual para que pueda compartir el URI con los usuarios. Si un usuario que no tiene la aplicación hace clic en el URI, se le llevará a través del proceso de instalación de la aplicación. Si un usuario que ya tiene la aplicación hace clic en el URI, la aplicación se actualiza si es necesario y, a continuación, se abre.

Opcionalmente, puede agregar argumentos al URI. En este caso, el comportamiento es el mismo que se ha descrito anteriormente, pero la aplicación puede usar los argumentos cuando se abre. Los argumentos deben usar un protocolo que admita la aplicación. Para obtener más información, consulte Controlar la activación de URI.

Consulte también

• Uri
• API del instalador de aplicaciones
• Controlar la activación de URI