Mengkompilasi sumber daya secara manual dengan MakePri.exe

  • Artikel

MakePri.exe adalah alat baris perintah yang dapat Anda gunakan untuk membuat dan mencadangkan file PRI. Ini terintegrasi sebagai bagian dari MSBuild dalam Microsoft Visual Studio, tetapi dapat berguna bagi Anda untuk membuat paket secara manual atau dengan sistem build kustom.

Catatan

MakePri.exe diinstal saat Anda memeriksa opsi Windows SDK untuk Aplikasi Terkelola UWP saat menginstal Kit Pengembangan Perangkat Lunak Windows. Ini diinstal ke jalur %WindowsSdkDir%bin\<WindowsTargetPlatformVersion>\x64\makepri.exe (serta dalam folder yang dinamai untuk arsitektur lain). Contohnya, C:\Program Files (x86)\Windows Kits\10\bin\10.0.17713.0\x64\makepri.exe.

Di bagian ini

Topik Deskripsi
Opsi baris perintah MakePri.exe MakePri.exe memiliki sekumpulan perintah createconfig, , dump, resourcepacknew, dan versioned. Topik ini merinci opsi baris perintah untuk penggunaannya.
File konfigurasi MakePri.exe Topik ini menjelaskan skema file konfigurasi XML MakePri.exe.
Pengindeks khusus format MakePri.exe Topik ini menjelaskan pengindeks khusus format yang digunakan oleh alat MakePri.exe untuk menghasilkan indeks sumber dayanya.

Opsi baris perintah MakePri.exe

MakePri.exe memiliki sekumpulan perintah createconfig, , dump, resourcepacknew, dan versioned. Untuk detail penggunaannya, lihat Opsi baris perintah MakePri.exe.

Konfigurasi MakePri.exe

File konfigurasi XML PRI menentukan cara dan sumber daya apa yang diindeks. Skema XML konfigurasi dijelaskan dalam konfigurasi MakePri.exe.

Pengindeks khusus format

MakePri.exe biasanya digunakan dengan newopsi , , versioneddan resourcepack . Dalam kasus tersebut, ia mengindeks file sumber untuk menghasilkan indeks sumber daya. MakePri.exe menggunakan berbagai pengindeks individual untuk membaca file sumber daya sumber atau kontainer yang berbeda untuk sumber daya. Pengindeks paling sederhana adalah pengindeks folder, yang mengindeks konten folder untuk sumber daya seperti .jpg atau .png gambar. Untuk informasi selengkapnya, lihat Pengindeks khusus format MakePri.exe.

Peringatan MakePri.exe dan pesan kesalahan

Sumber daya yang ditemukan untuk bahasa '<bahasa>' tetapi tidak ada sumber daya yang ditemukan untuk bahasa default: '<bahasa>'. Ubah bahasa default atau sumber daya yang memenuhi syarat dengan bahasa default.

Peringatan ini ditampilkan ketika MakePri.exe atau MSBuild menemukan file atau sumber daya string untuk sumber daya bernama tertentu yang tampaknya ditandai dengan kualifikasi bahasa, tetapi tidak ada kandidat yang ditemukan untuk bahasa default. Proses untuk menggunakan kualifikasi dalam nama file dan folder dijelaskan di Menyesuaikan sumber daya Anda untuk bahasa, skala, dan kualifikasi lainnya. File atau folder mungkin memiliki nama bahasa di dalamnya, tetapi tidak ada sumber daya yang ditemukan yang memenuhi syarat untuk bahasa default yang tepat. Misalnya, jika proyek menggunakan "en-US" sebagai bahasa default dan memiliki file bernama "de/logo.png", tetapi tidak memiliki file apa pun yang ditandai dengan bahasa default "en-US", peringatan ini akan muncul. Untuk menghapus peringatan ini, sumber daya file atau string harus memenuhi syarat dengan bahasa default, atau bahasa default harus diubah. Untuk mengubah bahasa default, dengan solusi Anda terbuka di Visual Studio, buka Package.appxmanifest. Pada tab Aplikasi, konfirmasikan bahwa bahasa Default diatur dengan tepat (misalnya, "en" atau "en-US").

Tidak ada sumber daya default atau netral yang diberikan untuk '<pengidentifikasi> sumber daya'. Aplikasi dapat melemparkan pengecualian untuk konfigurasi pengguna tertentu saat mengambil sumber daya.

Peringatan ini ditampilkan ketika MakePri.exe atau MSBuild menemukan file atau sumber daya yang tampaknya ditandai dengan kualifikasi bahasa yang sumber dayanya tidak jelas. Ada kualifikasi, tetapi tidak ada jaminan bahwa kandidat sumber daya tertentu dapat dikembalikan untuk pengidentifikasi sumber daya tersebut pada waktu proses. Jika tidak ada kandidat sumber daya untuk bahasa tertentu, wilayah asal, atau kualifikasi lain yang dapat ditemukan yang default atau akan selalu cocok dengan konteks pengguna, peringatan ini akan ditampilkan. Pada waktu proses, untuk konfigurasi pengguna tertentu seperti preferensi bahasa pengguna atau lokasi beranda (Pengaturan> Time & Wilayah Bahasa>&bahasa), API yang digunakan untuk mengambil sumber daya dapat memunculkan pengecualian yang tidak terduga. Untuk menghapus peringatan ini, sumber daya default harus disediakan, seperti sumber daya dalam bahasa default proyek atau wilayah asal global (homeregion-001).

Menggunakan MakePri.exe dalam sistem build

Sistem build harus menggunakan perintah MakePri.exe new, versioned, atau resourcepack , tergantung pada jenis proyek yang sedang dibangun. Sistem build yang membuat file PRI baru harus menggunakan new perintah . Sistem build yang harus memastikan kompatibilitas offset internal melalui iterasi dapat menggunakan versioned perintah . Sistem build yang harus membuat file PRI yang berisi varian sumber daya tambahan, dengan validasi untuk memastikan bahwa tidak ada sumber daya baru yang ditambahkan untuk varian tersebut resourcepack , harus menggunakan perintah .

Sistem build yang memerlukan kontrol eksplisit atas file sumber yang diindeks dapat menggunakan pengindeks ResFiles alih-alih mengindeks folder. Sistem build juga dapat menggunakan beberapa pass indeks dengan pengindeks khusus format yang berbeda untuk menghasilkan satu file PRI.

Sistem build juga dapat menggunakan pengindeks khusus format PRI untuk menambahkan file PRI bawaan ke pri untuk paket dari komponen lain, seperti pustaka kelas, rakitan, SDK, dan DLL.

Ketika file PRI dibangun untuk komponen lain, pustaka kelas, rakitan, DLL, dan SDK, konfigurasi initialPath harus digunakan untuk memastikan sumber daya komponen memiliki peta sub-sumber daya mereka sendiri yang tidak bertentangan dengan aplikasi tempat mereka disertakan.