Menggunakan file Penginstal Aplikasi yang disematkan untuk memperbarui aplikasi Anda

  • Artikel

Penting

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

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

Saat Anda menggunakan Visual Studio untuk membuat dan menerbitkan aplikasi Windows Anda dengan file Penginstal Aplikasi yang disematkan, Anda harus memastikan bahwa Windows 10 SDK 2104 (atau yang lebih baru) telah diinstal, dan properti proyek telah 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.

Cara - MSIX Packaging Tool

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.

Catatan

Panduan berikut mengasumsikan bahwa Anda sebelumnya telah membuat file Penginstal Aplikasi menggunakan Visual Studio untuk mengotomatiskan pembuatan file Penginstal Aplikasi, dengan menggunakan Toolkit MSIX, 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 Pengemasan 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 Pengemasan 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, navigasikan 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 menunjuk 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. <Package> Pastikan properti 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. <Properties> Di dalamnya termasuk parameter berikut <uap13:AutoUpdate> dan turunan:
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  6. Simpan perubahan yang Anda buat ke AppxManifest.
  7. Tutup jendela AppxManifest Notepad, dan kembali ke MSIX Packaging Tool.

Catatan

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 .

Cara - 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 klik kanan pada nama aplikasi Windows Anda.
  2. Pilih Tambahkan>>Item yang Ada dari menu drop-down.
  3. Navigasikan ke file Penginstal Aplikasi Anda, pilih file tersebut dan pilih tombol Tambahkan .
  4. Di Penjelajah Solusi, klik dua kali 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:

  • SDK Windows 10 2104 atau lebih tinggi diinstal
  • Properti proyek diatur ke target Windows 10, versi 2104 atau 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 penelusuran kesalahan.
  5. Di Penjelajah Solusi, klik kanan package.appxmanifest
  6. Pilih Tampilkan Kode dari menu drop-down.
  7. <Package> Pastikan properti 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. <Properties> Di dalamnya termasuk parameter berikut <uap13:AutoUpdate> dan 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 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 Buat.