Package.GetAppInstallerInfo Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengembalikan lokasi file XML .appinstaller. Gunakan metode ini saat Anda perlu mengambil lokasi file XML .appinstaller untuk aplikasi Anda. Misalnya, ini berguna jika aplikasi Anda perlu berbagi URI ke file .appinstaller terkait. Anda dapat secara opsional menambahkan argumen ke URI.
public:
virtual AppInstallerInfo ^ GetAppInstallerInfo() = GetAppInstallerInfo;
AppInstallerInfo GetAppInstallerInfo();
public AppInstallerInfo GetAppInstallerInfo();
function getAppInstallerInfo()
Public Function GetAppInstallerInfo () As AppInstallerInfo
Mengembalikan
Lokasi file XML .appinstaller.
Persyaratan Windows
Rangkaian perangkat |
Windows 10, version 1809 (diperkenalkan dalam 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v7.0)
|
Contoh
Contoh berikut menghasilkan URI .appinstaller dengan argumen dan membuat email untuk mengirim URI ke pengguna lain. Dalam contoh ini, ComposeEmailAsync
metode diasumsikan didefinisikan di tempat lain.
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());
}
Keterangan
Gunakan metode ini jika Anda ingin mendapatkan URI ke file .appinstaller yang terkait dengan aplikasi saat ini sehingga Anda dapat berbagi URI dengan pengguna. Jika pengguna yang tidak memiliki aplikasi mengklik URI, mereka diambil melalui proses penginstalan untuk aplikasi. Jika pengguna yang sudah memiliki aplikasi mengeklik URI, aplikasi diperbarui jika diperlukan, lalu aplikasi akan terbuka.
Anda dapat secara opsional menambahkan argumen ke URI. Dalam hal ini, perilakunya sama seperti yang dijelaskan di atas, tetapi aplikasi kemudian dapat menggunakan argumen saat terbuka. Argumen harus menggunakan protokol yang didukung aplikasi. Untuk informasi selengkapnya, lihat Menangani aktivasi URI.