Package.GetAppInstallerInfo 方法

定义

命名空间:

Windows.ApplicationModel

返回 .appinstaller XML 文件位置。 如果需要检索应用的 .appinstaller XML 文件位置，请使用此方法。 例如，如果你的应用需要将 URI 共享到其关联的 .appinstaller 文件，这很有用。 可以选择性地将参数添加到 URI。

public:
 virtual AppInstallerInfo ^ GetAppInstallerInfo() = GetAppInstallerInfo;

AppInstallerInfo GetAppInstallerInfo();

public AppInstallerInfo GetAppInstallerInfo();

function getAppInstallerInfo()

Public Function GetAppInstallerInfo () As AppInstallerInfo

返回

AppInstallerInfo

.appinstaller XML 文件位置。

Windows 要求

设备系列	Windows 10, version 1809 (在 10.0.17763.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v7.0 中引入)

示例

以下示例使用参数生成 .appinstaller URI，并创建一封电子邮件以将 URI 发送给其他用户。 在此示例中， ComposeEmailAsync 假定方法在其他位置定义。

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());
}

注解

如果要获取与当前应用关联的 .appinstaller 文件的 URI，以便与用户共享 URI，请使用此方法。 如果没有应用的用户单击该 URI，则会完成应用的安装过程。 如果已有应用的用户单击该 URI，则会根据需要更新应用，然后打开该应用。

可以选择性地将参数添加到 URI。 在这种情况下，行为与上述行为相同，但应用可以在打开时使用参数。 参数必须使用应用支持的协议。 有关详细信息，请参阅 处理 URI 激活。

另请参阅

• Uri
• 应用安装程序 API
• 处理 URI 激活