Memecahkan masalah penginstalan dengan file Penginstal Aplikasi

  • Artikel

Jika Anda menemukan masalah saat menginstal aplikasi dari file Penginstal Aplikasi, topik ini akan memberikan beberapa panduan pemecahan masalah yang dapat membantu.

Prasyarat

Agar dapat memuat samping aplikasi di Windows 10, perangkat pengguna harus memenuhi persyaratan berikutnya:

Windows 10:

  • Sertifikat yang digunakan untuk menandatangani paket harus dipercaya oleh perangkat. Lihat bagian Sertifikat tepercaya di bawah ini untuk detail selengkapnya.
  • Versi Windows 10 harus mendukung .appinstaller skema file dan protokol distribusi.

Windows 10 1909 dan yang lebih lama:

Masalah umum

Ada beberapa masalah umum saat memuat samping aplikasi untuk pertama kalinya di komputer pengguna. Beberapa bagian berikutnya menjelaskan masalah yang paling sering dan solusinya.

Versi Windows

Setiap rilis Windows 10 meningkatkan pengalaman sideloading, dalam tabel di bawah ini Anda akan menemukan fitur mana yang tersedia di setiap rilis utama. Jika Anda mencoba memuat samping aplikasi menggunakan metode yang tidak didukung di versi Windows 10, Anda akan mendapatkan kesalahan penyebaran.

Versi Catatan Sideload
Build 17134 (Pembaruan April 2018, versi 1803) File .appinstaller dapat diakses melalui folder UNC/Share. Pemeriksaan pembaruan yang dapat dikonfigurasi juga tersedia.
Build 16299 (Fall Creators Update, versi 1709) .appinstaller Memperkenalkan file untuk menyediakan pembaruan otomatis ke aplikasi Anda. Versi ini hanya mendukung titik akhir HTTP. Pemeriksaan pembaruan tidak dapat dikonfigurasi dan terjadi setiap 24 jam.
Build 15063 (Pembaruan Pembuat, versi 1703) Aplikasi Penginstal Aplikasi dapat mengunduh dependensi aplikasi (hanya dalam mode rilis) dari Store.
Build 14393 (Pembaruan Ulang Tahun, versi 1607) Memperkenalkan aplikasi Penginstal Aplikasi untuk menginstal file .appx dan .appxbundle, file .appinstaller tidak didukung.
Build 10586 (Pembaruan November, versi 1511) Sideload hanya tersedia melalui PowerShell menggunakan perintah Add-AppxPackage .
Build 10240 (Windows 10, versi 1507) Sideload hanya tersedia melalui PowerShell menggunakan perintah Add-AppxPackage .

Sertifikat tepercaya

Paket aplikasi harus ditandatangani dengan sertifikat yang dipercaya oleh perangkat. Sertifikat yang disediakan oleh Otoritas Sertifikat umum dipercaya secara default dalam sistem operasi Windows.

Namun, jika sertifikat yang digunakan untuk menandatangani paket aplikasi tidak tepercaya, atau merupakan sertifikat yang dihasilkan secara lokal/ditandatangani sendiri yang digunakan selama pengembangan, penginstal aplikasi dapat melaporkan bahwa paket tidak tepercaya dan akan mencegahnya diinstal:

MSIX signed with missing or untrusted Cert

Untuk mengatasi masalah ini, pengguna dengan hak administrator lokal untuk perangkat harus menggunakan alat Sertifikat Komputer untuk mengimpor sertifikat ke salah satu kontainer berikut:

  1. Komputer Lokal: Orang Tepercaya
  2. Komputer Lokal: Otoritas Akar Tepercaya (tidak disarankan)

Penting

Jangan impor sertifikat penandatanganan paket ke penyimpanan Sertifikat Pengguna. Penginstal Aplikasi tidak mencari Sertifikat Pengguna saat memverifikasi identitas paket.

Alat manajemen Sertifikat Komputer dapat dengan mudah ditemukan dengan mencari dari Menu Mulai:

Find the local Computer Certificates tool via the Start Menu

Setelah sertifikat penandatanganan berhasil diimpor, menjalankan kembali penginstal aplikasi akan menunjukkan bahwa paket tepercaya dan dapat diinstal:

MSIX signed with a trusted Cert

Dependensi tidak terinstal

Aplikasi Windows 10 dapat memiliki dependensi kerangka kerja berdasarkan platform aplikasi yang digunakan untuk menghasilkan aplikasi. Jika Anda menggunakan C# atau VB, aplikasi akan memerlukan paket .NET Runtime dan .NET framework. Aplikasi C++ memerlukan VCLibs.

Penting

Jika paket aplikasi dibangun dalam konfigurasi mode Rilis, dependensi kerangka kerja akan diperoleh dari Microsoft Store. Namun, jika aplikasi dibangun dalam konfigurasi mode Debug, dependensi akan diperoleh dari lokasi yang ditentukan dalam .appinstaller file.

File tidak dapat diakses

Saat menginstal dari titik akhir HTTP, penting untuk memverifikasi bahwa semua file dapat diakses dengan jenis MIME yang benar. Metode termampu untuk memverifikasi file-file ini adalah dengan mengikuti tautan yang disediakan di halaman HTML yang dihasilkan oleh Visual Studio. Anda harus memeriksa file-file ini:

  • .appinstaller file, tersedia sebagai application/xml
  • .appx dan .appxbundle file, tersedia sebagai application/vns.ms-appx

Penginstalan aplikasi gagal dengan pesan kesalahan: Parameter salah

Karena URL vanity tidak didukung saat ini, saat menggunakan ms-appinstaller protokol, parameter sumber HARUS berakhir di .appinstaller. Tidak masalah jika Anda mengalihkan ke file yang diakhir dengan .appinstaller. Itu juga akan gagal dengan cara yang sama. Satu-satunya cara untuk memperbaiki hal ini adalah dengan memastikan url asli berakhir dengan .appinstaller.

Mengisolasi masalah aplikasi Penginstal Aplikasi

Jika Penginstal Aplikasi tidak dapat menginstal aplikasi, langkah-langkah ini akan membantu mengidentifikasi masalah penginstalan.

Memverifikasi penginstalan file paket aplikasi

  • Unduh file paket aplikasi ke folder lokal dan coba instal menggunakan perintah PowerShell Add-AppxPackage .

  • .appinstaller Unduh file ke folder lokal dan coba instal menggunakan Add-AppxPackage -Appinstaller perintah PowerShell.

Log peristiwa Penginstal Aplikasi

Infrastruktur penyebaran aplikasi memancarkan log yang sering berguna untuk men-debug masalah penginstalan melalui Windows Pemantau Peristiwa:Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server