Bagikan melalui

Menggunakan file Penginstal Aplikasi yang disematkan untuk memperbarui aplikasi Anda

Penting

Penggunaan file Penginstal Aplikasi yang disematkan tersedia di Windows versi 10.0.21300.0. Untuk menggunakan fitur ini, pastikan bahwa MaxVersionTested merujuk pada versi ini atau yang lebih baru dari sistem operasi Windows.

File Penginstal Aplikasi menyediakan jalur pembaruan yang dapat dilalui aplikasi Windows untuk mencari pembaruan, dan perbaikan.

Saat Anda menggunakan Visual Studio untuk membangun dan menerbitkan aplikasi Windows dengan file Penginstal Aplikasi yang disematkan, Anda harus memastikan bahwa Windows 10 SDK 2104 (atau yang lebih baru) telah diinstal, dan properti proyek memiliki Windows 10 21H1 (atau yang lebih baru) sebagai versi Yang Ditargetkan (MaxVersionTested dan MinVersion). Jika ini belum dikonfigurasi, aplikasi Windows tidak akan mengatur konfigurasi AppInstaller yang disematkan ke perangkat saat aplikasi Windows diinstal.

Petunjuk Menggunakan Alat Pengemas MSIX

Langkah-langkah berikut akan memandu Anda melalui cara menggunakan MSIX Packaging Tool untuk mengedit aplikasi Windows yang sudah ada sebelumnya untuk menyertakan aplikasi Penginstal Aplikasi yang disematkan.

Nota

Panduan berikut mengasumsikan bahwa Anda sebelumnya telah membuat file Penginstal Aplikasi menggunakan Visual Studio untuk mengotomatiskan pembuatan file Penginstal Aplikasi, dengan menggunakan MSIX Toolkit, atau secara manual. Untuk panduan tentang membuat file Penginstal Aplikasi, silakan kunjungi salah satu Artikel Dokumen berikut:

Buka aplikasi Windows untuk Pengeditan

Langkah-langkah berikut akan memandu Anda melalui cara menggunakan Aplikasi Alat Kemasan Microsoft MSIX untuk mulai mengedit aplikasi Windows.

  1. Luncurkan Microsoft MSIX Packaging Tool (Tersedia di Microsoft Store: MSIX Packaging Tool).
  2. Pilih tombol Editor paket untuk mengedit paket yang sudah ada.
  3. Pilih tombol Telusuri , dan di jendela yang diminta temukan aplikasi Windows Anda dan pilih tombol Buka .
  4. Pilih tombol Buka Paket .

Mengimpor file Penginstal Aplikasi ke aplikasi Windows

Langkah-langkah berikut akan memandu Anda melalui cara menyematkan file Penginstal Aplikasi ke dalam aplikasi Windows yang sudah ada sebelumnya menggunakan Aplikasi Alat Kemasan Microsoft MSIX. Langkah-langkah ini mengasumsikan Anda telah membuka aplikasi Windows untuk pengeditan menggunakan aplikasi Microsoft MSIX Packaging Tool.

  1. Di sisi kiri MSIX Packaging Tool, pilih File paket.
  2. Perluas entri Paket di dalam tampilan pohon.
  3. Klik kanan Pada Paket dan pilih Tambahkan file dari menu drop-down.
  4. Pilih tombol Telusuri di dalam jendela yang diminta, navigasi ke dan pilih file Penginstal Aplikasi, dan pilih tombol Buka .
  5. Pilih tombol Simpan .

Memperbarui AppxManifest

Langkah-langkah berikut akan memandu Anda memperbarui AppxManifest untuk mengarahkan ke file Penginstal Aplikasi yang sebelumnya ditambahkan ke aplikasi Windows.

  1. Di sisi Kiri MSIX Packaging Tool, pilih Informasi paket.
  2. Gulir ke bagian bawah bagian Informasi paket .
  3. Pilih tombol Buka file untuk membuka AppxManifest di jendela Notepad.
  4. Pastikan <Package> properti tersebut menyertakan Namespace berikut dan Namespace yang dapat diabaikan:
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">
  5. Di dalam <Properties> sertakan parameter berikut <uap13:AutoUpdate> dan parameter turunan:
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  6. Simpan perubahan yang Anda buat ke AppxManifest.
  7. Tutup jendela Notepad AppxManifest , dan kembali ke MSIX Packaging Tool.

Nota

Instruksi di atas mengasumsikan bahwa nama file Penginstal Aplikasi adalah "Update.appinstaller".

Tutup dan Kemas aplikasi Windows

Langkah-langkah berikut akan memandu Anda melalui pengemasan aplikasi Windows Anda sebagai versi yang lebih baru. Langkah-langkah ini mengasumsikan Anda telah mengonfigurasi Preferensi Penandatanganan untuk memenuhi persyaratan organisasi atau klien Anda.

  1. Di MSIX Packaging Tool pilih tombol Simpan .
  2. Di jendela yang diminta, pilih tombol Ya, Kenaikan .
  3. Navigasi ke tempat Anda ingin menyimpan aplikasi Windows yang baru diperbarui, dan pilih tombol Simpan .
  4. Pilih tombol Tutup.
  5. Tutup jendela MSIX Packaging Tool .

Panduan Cara Menggunakan Visual Studio

Sebelum memulai, pastikan Anda mengerjakan perangkat Windows 10 dengan Windows 10 SDK 2104 atau yang lebih tinggi terinstal. SDK ini diperlukan untuk memastikan bahwa properti Versi Target, dan Versi Minimum diatur dengan nilai yang tepat saat Anda membuat aplikasi.

Menyematkan File Penginstal Aplikasi

Langkah-langkah berikut akan memandu Anda menyematkan file Penginstal Aplikasi ke dalam proyek Visual Studio aplikasi Windows (UWP).

  1. Di proyek Visual Studio Anda, Penjelajah Solusi mengklik kanan pada nama aplikasi Windows Anda.
  2. Pilih Tambahkan>>Item yang Sudah Ada dari menu drop-down.
  3. Navigasi ke file Penginstal Aplikasi Anda, pilih file tersebut dan pilih tombol Tambahkan .
  4. Di Penjelajah Solusi, klik dua kali pada Update.appinstaller untuk membuka file untuk ditinjau.
  5. Konfirmasikan file Penginstal Aplikasi sudah benar, dan tutup file.

Memperbarui AppxManifest

Langkah-langkah berikut akan memberikan panduan tentang cara memperbarui AppxManifest di proyek Visual Studio Anda untuk menargetkan file Penginstal Aplikasi yang baru disematkan.

Panduan ini mengasumsikan:

  • Windows 10 SDK 2104 atau yang lebih tinggi diinstal
  • Properti proyek diatur ke target Windows 10, versi 2104 atau yang lebih tinggi.
  • Nama file Penginstal Aplikasi adalah Update.appinstaller
  1. Di proyek Visual Studio Anda, pilih Bangun dari menu atas.
  2. Pilih Bangun Solusi dari menu drop-down. Pastikan build aplikasi Windows berhasil.
  3. Pilih Komputer Lokal dari pita, untuk menguji fungsionalitas aplikasi Windows.
  4. Tutup aplikasi Windows tak lama setelah diluncurkan, dan hentikan proses debugging.
  5. Di Solution Explorer, klik kanan pada Package.appxmanifest
  6. Pilih Tampilkan Kode dari menu drop-down.
  7. Pastikan <Package> properti tersebut menyertakan Namespace berikut dan Namespace yang dapat diabaikan:
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">
  8. Di dalam <Properties> sertakan parameter berikut <uap13:AutoUpdate> dan parameter turunan:
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  9. Simpan perubahan Anda ke file, dan tutup.

Membangun aplikasi Windows Anda

Langkah-langkah berikut akan memandu Anda membuat paket aplikasi Windows untuk menginstal pada sistem operasi yang didukung.

  1. Di proyek Visual Studio Anda, klik kanan pada nama aplikasi Windows.
  2. Pilih Terbitkan>>Buat Paket Aplikasi... dari menu drop-down.
  3. Pilih tombol radio Sideloading , di jendela dialog Buat Paket Aplikasi baru.
  4. Pilih tombol Berikutnya.
  5. Pilih tombol Ya, gunakan sertifikat saat ini: radio.
  6. Impor Sertifikat yang sudah ada, atau buat sertifikat secara otomatis untuk menandatangani aplikasi Windows Anda.
  7. Pilih tombol Berikutnya.
  8. Tentukan Konfigurasi Solusi, versi, dan build opsional Bundel aplikasi Windows untuk aplikasi Windows Anda.
  9. Pilih tombol Create.