Masalah umum dan tips pemecahan masalah untuk MSIX Packaging Tool

Artikel ini menjelaskan masalah yang diketahui dan menyediakan tips pemecahan masalah yang perlu dipertimbangkan saat mengonversi aplikasi Anda ke MSIX menggunakan MSIX Packaging Tool. Lihat dokumen kami yang lain jika Anda perlu memperoleh MSIX Packaging Tool atau driver di lingkungan yang terputus.

Masalah yang diketahui

Mendapatkan build Pratinjau Insider terbaru dari MSIX Packaging Tool

Jika Anda telah ikut serta dalam Program Insider kami, pastikan Anda memiliki versi MSIX Packaging Tool yang benar:

• Buka bagian Tentang di Alat Kemasan MSIX untuk melihat versi mana Anda berada.
• Buka di sini untuk menentukan versi Pratinjau Insider terbaru, dan konfirmasikan bahwa Anda telah menginstal MSIX Packaging Tool versi tersebut.
• Pastikan MSA yang terdaftar untuk penerbangan adalah akun yang masuk ke Microsoft Store.
• Perbarui MSIX Packaging Tool secara manual melalui Microsoft Store di komputer Anda. Jika opsi ini tersedia untuk Anda, buka Bursa, buka Unduhan dan pembaruan, dan klik Dapatkan pembaruan. Atau, cari MSIX Packaging Tool, dan pada halaman produk Anda kemudian dapat meminta pembaruan.
• Untuk menginstal MSIX Packaging Tool untuk penggunaan offline, ikuti instruksi berikut untuk memastikan Anda mendapatkan aplikasi terbaru melalui proses offline kami.

Jika Anda tertarik untuk bergabung dengan Program Insider kami, buka Bergabung dengan MSIX Packaging Tool Insiders!.

Driver MSIX Packaging Tool

Driver MSIX Packaging Tool dikirimkan sebagai paket Feature on Demand (FOD) dari Windows Update. Ini akan gagal diinstal jika layanan Windows Update dinonaktifkan pada komputer atau jika pengaturan cincin penerbangan Windows Insider tidak cocok dengan build OS komputer.

Jika Anda mengalami masalah saat memperoleh driver, atau Anda bekerja di lingkungan offline, Anda dapat menemukan tautan untuk mengunduh driver di sini.

Jika Anda telah mengunduh driver dan mengalami masalah selama konversi paket, itu mungkin salah satu masalah berikut.

Masalah konektivitas jaringan

Kode kesalahan berikut mungkin menunjukkan bahwa Anda mengalami masalah koneksi:

• -2145107924 (0x8024402c)
• -2145107945 (0x80244017)
• -2145123272 (0x80240438)

Kebijakan Windows Server Update Service (WSUS), Configuration Manager, atau grup yang memengaruhi konektivitas Windows Update

Kode galat berikut mungkin menunjukkan bahwa kebijakan pada komputer Anda memengaruhi konektivitas Windows Update: -2145124306 (0x8024002e).

Jika Anda menerima kode kesalahan ini, Anda mungkin perlu memeriksa pengaturan dan kebijakan lingkungan Anda.

Driver memerlukan instalasi ulang

Dalam skenario ini, MSIX Packaging Tool akan memberi tahu Anda dalam pesan kesalahan dan log bahwa driver Anda perlu memulai ulang. Mulai ulang komputer Anda dan mulai kembali konversi Anda untuk memperbaiki masalah ini.

Kesalahan saat memulai driver alat pengemasan MSIX 0x80131500

Jika Anda mendapatkan kesalahan ini selama konversi, ketika Anda memeriksa file log, Anda harus menemukan entri seperti berikut:

[Error] Error monitoring: Insufficient system resources exist to complete the requested service

Kesalahan ini terjadi ketika alat memulai sesi pelacakan peristiwa sistem baru, tetapi Anda telah melebihi jumlah maksimum sesi yang dapat dibuat Windows di seluruh sistem. Jika Anda melebihi batas default (64), Anda akan mengalami kesalahan ERROR_NO_SYSTEM_RESOURCES, yang menyebabkan driver gagal.

Solusinya adalah menghentikan beberapa sesi Pelacakan Peristiwa yang ada dengan mengikuti langkah-langkah berikut:

1. Buka menu Mulai dan cari Monitor Performa.
2. Klik kanan padanya dan pilih Lainnya -> Jalankan sebagai Administrator.
3. Dari menu pohon, pilih Himpunan Pengumpul Data -> Sesi Pelacakan Peristiwa.
4. Klik kanan pada beberapa sesi yang ada dalam daftar dan pilih Hentikan.

Sekarang Anda dapat mencoba lagi melakukan konversi dengan MSIX Packaging Tool.

Versi minimum

Ada beberapa fitur yang perlu diperhatikan bahwa secara otomatis mengubah dukungan versi minimun dalam Paket MSIX Anda.

Menerapkan persyaratan penerapan versi penyimpanan Microsoft

Jika Anda mengonversi alat penginstal yang ada menggunakan versi MSIX Packaging Tool yang lebih lama dari 1.2019.701.0, alat ini telah menerapkan persyaratan penerapan versi Microsoft Store, atau menggunakan alat lain untuk membuat paket Anda yang tidak mengatur versi minimum ke 10.0.16299.0 (Windows 10, versi 1709). Ini akan menyebabkan pesan kesalahan saat menyebarkan aplikasi Anda ke Windows 10, versi 1709 atau versi yang lebih baru.

Untuk memperbaiki masalah ini, buka MSIX Packaging Tool dan edit aplikasi Anda melalui Editor Paket. Buka manifes Anda dan atur MinVersion atribut TargetDeviceFamily elemen ke "10.0.16299.0".

<Dependencies>
    <TargetDeviceFamily> Name="Windows.Desktop" MinVersion="10.0.16299.0" MaxVersionTested = "10.0.17763.0" />
</Dependencies>

MSIX dengan layanan

Dalam versi 1.2019.1220.0 dari MSIX Packaging Tool, kami menambahkan dukungan untuk membuat paket MSIX dengan Layanan. Karena pembatasan OS dengan dukungan layanan, MSIX Packaging Tool secara otomatis mengubah versi min yang didukung dalam paket MSIX dengan layanan menjadi 10.0.19025.0. Ini berarti Anda tidak dapat menginstal MSIX dengan layanan pada OS yang lebih rendah dari Windows 10 versi 2004, tetapi Anda dapat membuat MSIX tersebut menggunakan MSIX Packaging Tool ke Windows 10 1809. Jika Anda perlu menginstal aplikasi ini pada OS yang lebih rendah, perbarui versi min dengan tepat tetapi perhatikan bahwa dukungan untuk layanan tidak akan berfungsi.

Kerangka kerja dan driver

Jika aplikasi memerlukan kerangka kerja, pastikan kerangka kerja diinstal selama fase pemantauan konversi. Buka log untuk memastikan hal ini terjadi. Jika aplikasi Anda mengharuskan driver diinstal, Anda perlu mengevaluasi apakah ini diperlukan agar aplikasi Anda berjalan dengan benar. MSIX saat ini tidak mendukung penginstalan driver.

Komputer Jarak Jauh

Jika Anda mengalami masalah saat menggunakan VM jarak jauh untuk konversi Anda, lihat Instruksi penyiapan untuk konversi komputer jarak jauh.

Masalah selama konversi

• Beberapa penginstal mungkin gagal mengonversi dengan kode keluar 259. Ini menunjukkan bahwa alat penginstal menelurkan utas dan tidak menunggunya selesai. Dengan kata lain, utas utama selesai diinstal tetapi keluar dengan kesalahan 259 karena menelurkan utas yang masih berjalan. Kami menyarankan agar Anda menggunakan opsi penginstalan yang sesuai untuk setup.exe.

Masalah selama penandatanganan

Sertifikat PE buruk (0x800700C1)

Masalah ini terjadi ketika paket berisi file biner yang memiliki sertifikat rusak. Untuk mengatasi masalah ini, gunakan dumpbin.exe /headers perintah untuk mencadangkan header file dan memeriksa elemen yang buruk. Tulis ulang header secara manual untuk memperbaiki masalah. Secara umum, alat MSIX Packaging secara otomatis mendeteksi header yang buruk. Jika masalah ini berlanjut, umpan balik file. Informasi selengkapnya dapat ditemukan di sini.

Penandatanganan Device Guard

Pastikan untuk mengikuti langkah-langkah ini dan Anda menetapkan peran yang sesuai dalam Microsoft Store untuk Bisnis.

Sertifikat yang kedaluwarsa

• Gunakan tanda waktu saat Anda menandatangani paket Anda.
• Anda dapat mengundurkan diri dengan tanda atau sertifikat tanda waktu yang valid.

Anda dapat mengundurkan aplikasi menggunakan skrip konversi batch di MSIX Toolkit - Scripts.

Pemecahan Masalah

File log

Apakah konversi Anda berhasil atau tidak, file log dihasilkan untuk setiap konversi. Mereka dapat ditemukan di sini:

%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\

Kode kegagalan ditulis dan menunjukkan titik kegagalan apa pun selama proses konversi. Kode kesalahan dimaksudkan untuk ramah pengguna.

File log dari perangkat jarak jauh atau VM

Jika konversi dilakukan pada perangkat jarak jauh atau VM, kami sarankan Anda menyalin file log dari perangkat tersebut dan melampirkannya sebagai bagian dari item umpan balik. Ini akan membantu kami mendiagnosis dan menyelesaikan masalah secara lebih efisien.

Anda akan menemukan log dari konversi jarak jauh di sini: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Ini akan lebih bermanfaat jika Anda dapat berbagi seluruh folder Log yang akan menyertakan operasi yang terjadi pada klien lokal serta server jarak jauh.

Masalah umum

Kesalahan terjemahan MakePri/Manifest

Kesalahan ini terjadi ketika ada masalah dengan manifes paket. Untuk mengidentifikasi masalah, buka Editor Paket dan buka manifes. Saat membuka manifes, Anda dapat mengidentifikasi masalah dan memberikan perbaikan yang tepat.

File tidak ditemukan

File mungkin terbuka atau tidak ada. Untuk mengatasi masalah ini, tambahkan file yang sesuai atau tutup file yang saat ini sedang digunakan. Perhatikan bahwa Anda tidak akan mendapatkan File not Found kesalahan jika terbuka. Sebagai gantinya, Anda akan mendapatkan kesalahan Access Denied atau File in Use .

Asosiasi Jenis File

Masalah mengenai Asosiasi Jenis File (FTA) bervariasi dari paket ke paket. MSIX Packaging Tool mendukung asosiasi file untuk penginstalan klik ganda. Misalnya, jika aplikasi Anda memiliki menu konteks, aplikasi tidak ditambahkan secara otomatis, jadi Anda harus menambahkannya secara manual ke manifes. Lihat elemen manifes desktop4:FileExplorerContextMenus misalnya.

Pintasan dengan argumen

Alat Kemasan MSIX akan mengambil semua pintasan tingkat pengguna bersama dengan argumen. Jika pintasan ini tidak terdeteksi dengan benar, Anda dapat menambahkannya secara manual ke manifes. Lihat desktop7:Pintasan untuk detail selengkapnya.

Menginstal direktori

Ini lebih umum bagi mereka yang menggunakan drive sekunder untuk melakukan konversi aplikasi. Jika Anda memilih untuk mengubah lokasi penginstalan, itu mengubah akar ke mana semua file pergi. Ini berarti bahwa alat MSIX Packaging perlu mengetahui ke mana semua file ini pergi dan akan ditangkap selama konversi.

Anda dapat memperbaikinya dengan menggunakan tulisan Kerangka Kerja Dukungan Paket untuk menginstal perbaikan direktori. Kami telah menambahkan ini sebagai kemampuan secara default di Alat MSIX, yang memungkinkan ini turun ke 1809. Jika aplikasi Anda tidak berfungsi di 1709 dan berada di 1809, kemungkinan ini adalah masalahnya.

Mengirim umpan balik

Cara terbaik untuk mengirim umpan balik Anda adalah melalui Hub Umpan Balik.

1. Buka Hub Umpan Balik atau ketik Windows + F.
2. Berikan judul dan langkah-langkah yang diperlukan untuk mereproduksi masalah.
3. Di bawah Kategori, pilih Aplikasi dan pilih MSIX Packaging Tool.
4. Lampirkan file log apa pun yang terkait dengan konversi. Anda dapat menemukan log di folder yang disediakan di atas.
5. Lampirkan paket MSIX yang dikonversi (jika memungkinkan).
6. Klik Kirim.

Anda juga dapat mengirimi kami umpan balik langsung dari MSIX Packaging Tool dengan masuk ke tab Umpan Balik di bawah Pengaturan.