Menghasilkan komponen paket MSIX

  • Artikel

Artikel ini menunjukkan kepada Anda cara membuat komponen paket MSIX untuk mengemas aplikasi Anda menggunakan alat baris perintah (tanpa menggunakan Visual Studio atau MSIX Packaging Tool).

Untuk mengemas aplikasi secara manual, Anda perlu membuat file manifes paket, menambahkan komponen paket, lalu menjalankan alat baris perintah MakeAppx.exe untuk menghasilkan paket MSIX.

Pertama, bersiaplah untuk mengemas

Jika Anda belum melakukannya, tinjau bagian ini tentang apa yang perlu Anda ketahui sebelum mengemas aplikasi Anda.

Membuat manifes paket

Buat file, beri nama appxmanifest.xml, lalu tambahkan XML ini ke dalamnya.

Ini adalah templat dasar yang berisi elemen dan atribut yang dibutuhkan paket Anda. Kita akan menambahkan nilai ke nilai ini di bagian berikutnya.

<?xml version="1.0" encoding="utf-8"?>
<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap10="http://schemas.microsoft.com/appx/manifest/uap/windows10/10"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities">
  <Identity Name="" Version="" Publisher="" ProcessorArchitecture="" />
  <Properties>
    <DisplayName></DisplayName>
    <PublisherDisplayName></PublisherDisplayName>
    <Description></Description>
    <Logo></Logo>
  </Properties>
  <Resources>
    <Resource Language="" />
  </Resources>
  <Dependencies>
    <TargetDeviceFamily Name="Windows.Desktop" MinVersion="" MaxVersionTested="" />
  </Dependencies>
  <Capabilities>
    <rescap:Capability Name="runFullTrust"/>
  </Capabilities>
  <Applications>
    <Application Id="" Executable=""
      uap10:RuntimeBehavior="packagedClassicApp"
      uap10:TrustLevel="mediumIL">
      <uap:VisualElements DisplayName="" Description=""	Square150x150Logo=""
        Square44x44Logo="" BackgroundColor="" />
    </Application>
  </Applications>
</Package>

Catatan

Jika paket Anda diinstal pada sistem yang lebih lama dari Windows 10, versi 2004 (10.0; Build 19041), lalu gunakan EntryPoint atribut alih-alih uap10:RuntimeBehavior dan uap10:TrustLevel. Untuk detail selengkapnya, dan contohnya, lihat uap10 diperkenalkan di Windows 10, versi 2004 (10.0; Bangun 19041).

Isi elemen tingkat paket file Anda

Isi templat ini dengan informasi yang menjelaskan paket Anda.

Informasi identitas

Berikut adalah contoh elemen Identitas dengan teks tempat penampung untuk atribut. Anda dapat mengatur ProcessorArchitecture atribut ke x64 , x86 , arm (yaitu ARM 32bit), arm64 , atau neutral

<Identity Name="MyCompany.MySuite.MyApp"
          Version="1.0.0.0"
          Publisher="CN=MyCompany, O=MyCompany, L=MyCity, S=MyState, C=MyCountry"
			    ProcessorArchitecture="x64">

Catatan

Jika Anda telah memesan nama aplikasi di Microsoft Store, Anda bisa mendapatkan Nama dan Penerbit dengan menggunakan Pusat Mitra. Jika Anda berencana untuk memuat samping aplikasi ke sistem lain, Anda dapat memberikan nama Anda sendiri untuk ini selama nama penerbit yang Anda pilih cocok dengan nama pada sertifikat yang Anda gunakan untuk menandatangani aplikasi Anda.

Properti

Elemen Properties memiliki 3 elemen turunan yang diperlukan. Berikut adalah contoh simpul Properti dengan teks tempat penampung untuk elemen. DisplayName adalah nama aplikasi yang Anda pesan di Store, untuk aplikasi yang diunggah ke Store.

<Properties>
  <DisplayName>MyApp</DisplayName>
  <PublisherDisplayName>MyCompany</PublisherDisplayName>
  <Logo>images\icon.png</Logo>
</Properties>

Sumber

Berikut adalah contoh node Sumber Daya .

<Resources>
  <Resource Language="en-us" />
</Resources>

Dependensi

Untuk aplikasi desktop yang Anda buat paketnya, selalu atur atribut ke NameWindows.Desktop.

<Dependencies>
<TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.14316.0" MaxVersionTested="10.0.15063.0" />
</Dependencies>

Kemampuan

Untuk paket yang berisi satu atau beberapa aplikasi kepercayaan penuh, Anda harus mendeklarasikan runFullTrust kemampuan terbatas seperti yang ditunjukkan di bawah ini. Untuk detail selengkapnya, dan definisi aplikasi kepercayaan penuh, cari Tingkat Izin Kepercayaan Penuh dalam Deklarasi kemampuan Aplikasi).

<Capabilities>
  <rescap:Capability Name="runFullTrust"/>
</Capabilities>

Isi elemen tingkat aplikasi

Isi templat ini dengan informasi yang menjelaskan aplikasi Anda.

Elemen Application

Untuk aplikasi desktop yang Anda buat paketnya, konfigurasikan elemen Aplikasi seperti ini:

<Applications>
  <Application Id="MyApp" Executable="MyApp.exe"
		 uap10:RuntimeBehavior="packagedClassicApp"
     uap10:TrustLevel="mediumIL">
   </Application>
</Applications>

Catatan

Jika paket Anda diinstal pada sistem yang lebih lama dari Windows 10, versi 2004 (10.0; Build 19041), lalu gunakan EntryPoint atribut alih-alih uap10:RuntimeBehavior dan uap10:TrustLevel. Untuk detail selengkapnya, dan contohnya, lihat uap10 diperkenalkan di Windows 10, versi 2004 (10.0; Bangun 19041).

Elemen visual

Berikut adalah contoh simpul VisualElements .

<uap:VisualElements
	BackgroundColor="#464646"
	DisplayName="My App"
	Square150x150Logo="images\icon.png"
	Square44x44Logo="images\small_icon.png"
	Description="A useful description" />

(Opsional) Menambahkan aset tidak terenkripsi berbasis target

Aset berbasis target adalah untuk ikon dan petak peta yang muncul di taskbar Windows, tampilan tugas, ALT+TAB, snap-assist, dan sudut kanan bawah petak peta Mulai. Anda dapat membaca lebih lanjut tentang mereka di sini.

  1. Dapatkan gambar 44x44 yang benar lalu salin ke folder yang berisi gambar Anda (yaitu, Aset).

  2. Untuk setiap gambar 44x44, buat salinan di folder yang sama dan tambahkan .targetsize-44_altform-unplated ke nama file. Anda harus memiliki dua salinan setiap ikon, masing-masing dinamai dengan cara tertentu. Misalnya, setelah menyelesaikan proses, folder aset Anda mungkin berisi MYAPP_44x44.png dan MYAPP_44x44.targetsize-44_altform-unplated.png.

    Catatan

    Dalam contoh ini, ikon bernama MYAPP_44x44.png adalah ikon yang akan Anda referensikan dalam Square44x44Logo atribut logo paket MSIX Anda.

  3. Dalam file manifes, atur BackgroundColor untuk setiap ikon yang Anda buat transparan.

  4. Lanjutkan ke sub bagian berikutnya untuk menghasilkan file Indeks Sumber Daya Paket baru.

Membuat file Indeks Sumber Daya Paket (PRI) menggunakan MakePri

Jika Anda membuat aset berbasis target seperti yang dijelaskan di bagian di atas, atau Memodifikasi salah satu aset visual aplikasi setelah membuat paket, Anda harus membuat file PRI baru.

Berdasarkan jalur penginstalan SDK Anda, di sinilah MakePri.exe berada di PC Windows Anda:

  • x86: C:\Program Files (x86)\Windows Kits\10\bin\<build number>\x86\makepri.exe
  • x64: C:\Program Files (x86)\Windows Kits\10\bin\<build number>\x64\makepri.exe

Tidak ada versi ARM dari alat ini.

  1. Buka jendela Prompt Perintah atau PowerShell.

  2. Ubah direktori ke folder akar paket, lalu buat file priconfig.xml dengan menjalankan perintah <path>\makepri.exe createconfig /cf priconfig.xml /dq en-US.

  3. Buat file resources.pri dengan menggunakan perintah <path>\makepri.exe new /pr <PHYSICAL_PATH_TO_FOLDER> /cf <PHYSICAL_PATH_TO_FOLDER>\priconfig.xml.

    Misalnya, perintah untuk aplikasi Anda mungkin terlihat seperti ini: <path>\makepri.exe new /pr c:\MYAPP /cf c:\MYAPP\priconfig.xml.

  4. Kemas aplikasi Anda dengan menggunakan instruksi di langkah berikutnya.

Menguji aplikasi Anda sebelum pengemasan

Anda dapat menyebarkan aplikasi yang belum dikemas dan mengujinya sebelum pengemasan atau penandatanganan. Untuk melakukannya, jalankan cmdlet di bawah ini dari jendela PowerShell. Pastikan untuk meneruskan file manifes aplikasi Anda yang terletak di akar direktori paket Anda dengan semua komponen paket Anda yang lain:

Add-AppxPackage –Register AppxManifest.xml

Setelah ini selesai. Aplikasi Anda harus disebarkan pada sistem dan Anda dapat mengujinya untuk memastikan semuanya berfungsi sebelum pengemasan. Untuk memperbarui file .exe atau .dll aplikasi Anda, ganti file yang ada di paket Anda dengan yang baru, tingkatkan nomor versi di AppxManifest.xml, lalu jalankan perintah di atas lagi.

Mengemas komponen Anda ke dalam MSIX

Langkah selanjutnya adalah menggunakan MakeAppx.exe untuk menghasilkan paket MSIX untuk aplikasi Anda. Makeappx.exe disertakan dengan Windows SDK, dan jika Anda menginstal Visual Studio, itu dapat dengan mudah diakses melalui Perintah Pengembang untuk Visual Studio.

Lihat Membuat paket atau bundel MSIX dengan alat MakeAppx.exe

Catatan

Aplikasi paket selalu berjalan sebagai pengguna interaktif, dan drive apa pun yang Anda instal aplikasi paket Anda harus diformat ke format NTFS.