Membuat paket MSIX dengan MSIX Core dari kode sumber

MSIX Core menghadirkan penyebaran MSIX untuk memilih versi Windows sebelumnya. Anda dapat memanfaatkan alat penginstal MSIX Core untuk membuat aplikasi menggunakan ClickOnce. Ini akan memungkinkan pengguna Anda mengunduh setup.exe dan menginstal aplikasi MSIX melalui penginstal MSIX Core.

Menghosting aplikasi Anda di server web

Untuk menyiapkan aplikasi Anda untuk bootstrapping dengan penginstal MSIX Core, Anda harus menghosting paket aplikasi Anda di server web. Bagian ini menyediakan detail tentang cara menyiapkan aplikasi web di Azure, Layanan Informasi Internet (IIS), dan Amazon Web Services (AWS).

Azure

Untuk menggunakan opsi ini, Anda harus memiliki langganan Azure. Untuk mendapatkannya, lihat halaman akun Azure.

Membuat Azure Web App

Untuk mulai masuk ke halaman portal Azure dan ikuti langkah-langkah berikut:

  1. Klik Buat Sumber Daya.
  2. Klik Web dan pilih Aplikasi Web.
  3. Di bawah Detail Instans, buat nama aplikasi unik dan pilih pengaturan yang sesuai untuk aplikasi Anda. Misalnya, Anda harus memilih antara Kode atau Kontainer Docker dan Tumpukan Runtime. Jika tidak, biarkan semuanya default.
  4. Klik Buat dan selesaikan wizard.

Menghosting paket aplikasi dan halaman web

  1. Setelah Anda membuat aplikasi web, pilih aplikasi.
  2. Di bawah Alat Pengembangan, klik Editor App Service.
  3. Di editor, ada file hostingstart.html default. Klik kanan di ruang kosong File Explorer dan pilih Unggah File untuk mulai mengunggah paket aplikasi Anda.
  4. Klik kanan di ruang kosong panel File Explorer lagi dan pilih File Baru untuk membuat file baru. Beri nama file seperti yang Anda inginkan untuk halaman HTML default Anda.

Mengonfigurasi aplikasi web untuk jenis MIME paket aplikasi

Tambahkan file baru bernama Web.config ke aplikasi web. Buka file Web.config dan tambahkan XML berikut ke file .

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <!--This is to allow the web server to serve resources with the appropriate file extensions-->
    <staticContent>
      <mimeMap fileExtension=".appx" mimeType="application/appx" />
      <mimeMap fileExtension=".msix" mimeType="application/msix" />
    </staticContent>
  </system.webServer>
</configuration>

Internet Information Services (IIS)

IIS adalah fitur Windows opsional. Untuk menginstal IIS:

  1. Klik Mulai dan cari Aktifkan atau nonaktifkan fitur Windows.
  2. Pilih Layanan Informasi Internet.
  3. Pastikan juga Anda menginstal ASP.NET 4.5 atau lebih tinggi. Dalam dialog Fitur Windows, perluas Layanan Informasi Internet ->World Wide Web Services ->Application Development Features, dan pilih versi ASP.NET yang lebih besar dari atau sama dengan ASP.NET 4.5.
  4. Klik OK untuk memulai penginstalan.

Visual Studio 2017 (atau versi yang lebih baru) dan Alat Pengembangan Web diperlukan. Jika Anda sudah menginstal Visual Studio 2017 atau versi yang lebih baru, pastikan Anda telah menginstal beban kerja pengembangan ASP.NET dan Web. Jika tidak, instal Visual Studio dari sini.

Bangun API web

Mulai Visual Studio sebagai administrator dan buat proyek Aplikasi Web Visual C# baru dengan templat proyek kosong.

Mengonfigurasi IIS dengan aplikasi Web Anda

  1. Di Penjelajah Solusi, klik kanan pada proyek akar dan pilih Properti.
  2. Di properti, pilih tab Web .
  3. Di bagian Server, pilih IIS Lokal dari menu dropdown dan klik Buat Direktori Virtual.

Menambahkan paket aplikasi ke aplikasi web

Tambahkan paket aplikasi yang ingin Anda distribusikan ke aplikasi web:

  1. Di Penjelajah Solusi, klik kanan simpul proyek.
  2. Pilih Tambahkan Folder ->Baru dan beri nama paket folder.
  3. Untuk menambahkan paket aplikasi ke folder, klik kanan folder paket dan pilih Tambahkan ->Item yang Ada. Telusuri ke lokasi paket aplikasi.

Membuat halaman web

Buat halaman HTML atau aplikasi web lain sesuai kebutuhan Anda. Tambahkan tautan setup.exe baru Anda.

Mengonfigurasi aplikasi web untuk jenis MIME paket aplikasi

Buka file Web.config dari penjelajah solusi dan tambahkan XML berikut dalam <elemen konfigurasi>.

<system.webServer>
  <!--This is to allow the web server to serve resources with the appropriate file extensions-->
  <staticContent>
    <mimeMap fileExtension=".appx" mimeType="application/appx" />
    <mimeMap fileExtension=".msix" mimeType="application/msix" />
  </staticContent>
</system.webServer>

Amazon Web Services (AWS)

Untuk menggunakan opsi ini, Anda harus memiliki keanggotaan AWS. Untuk informasi selengkapnya, lihat detail akun AWS.

Buat wadah Amazon S3 dan unggah paket MSIX dan halaman web Anda

Amazon Simple Storage Service (S3) adalah penawaran AWS untuk mengumpulkan, menyimpan, dan menganalisis data. Wadah S3 adalah cara mudah untuk menghosting paket aplikasi Windows 10 dan halaman web untuk distribusi.

  1. Masuk ke AWS. Di bawah Layanan, temukan S3.
  2. Pilih Buat wadah dan masukkan nama Wadah untuk situs web Anda. Ikuti perintah dialog untuk mengatur properti dan izin. Untuk memastikan bahwa aplikasi Windows 10 Anda dapat didistribusikan dari situs web Anda, aktifkan izin Baca dan Tulis untuk wadah Anda dan pilih Berikan akses baca publik ke wadah ini. Klik Buat wadah untuk menyelesaikan langkah ini.
  3. Setelah selesai, unggah paket MSIX dan halaman web Anda ke wadah S3.

Mengonfigurasi aplikasi web untuk jenis MIME paket aplikasi

Menggunakan antarmuka layanan web seperti browser S3 untuk menambahkan Header HTTP Default baru.

  1. Navigasi ke Alat dan pilih Header HTTP Default.
  2. Dalam dialog Header HTTP Default, klik Tambahkan.
  3. Dalam dialog Tambahkan Header HTTP Default Baru, tentukan nama wadah, nama file, nama header, dan nilai header, lalu klik Tambahkan header baru.
    • Nama wadah: msix-packages
    • Nama file: *.msix
    • Nama header: Tipe Konten
    • Nilai header: application/msix

Catatan

 AWS memiliki beberapa panduan ketat yang harus Anda ikuti. Misalnya, nama Bucket harus unik dan oleh karena itu jika Anda menggunakan contoh di atas, Anda harus mengubah nama Bucket.

Menggunakan alat penginstal MSIX Core untuk membangun aplikasi ClickOnce

Temukan aplikasi aplikasi Anda ClickOnce setup.exe. Ini mengacu pada klon proyek Git, membangun dan menerbitkannya melalui proyek Visual Studio.

Jalankan perintah URL untuk membuat setup.exe baru

Pastikan Anda telah mengikuti instruksi untuk mengkloning, membangun, dan menerbitkan solusi MSIX Core di Visual Studio. Sebagai referensi, proyek GitHub dapat ditemukan di sini

Navigasi ke direktori tempat Anda menerbitkan file setup.exe lalu jalankan perintah ini:

.\setup.exe -url=<location of your msix in the webservice>

Misalnya

.\setup.exe -url="https://appinstallerdemo.azurewebsites.net/MSIXCore/msixmgrWrapper.application?https://appinstallerdemo.azurewebsites.net/MSIXCore/notepadplus.msix#"

Menandatangani aplikasi

Karena langkah sebelumnya membuat setup.exe baru, Anda harus menandatangani aplikasi lagi untuk memverifikasi bahwa Anda adalah penerbit tepercaya aplikasi dan untuk menetapkan integritas aplikasi. Anda dapat menggunakan SignTool dan memberikan sertifikat Anda.

Mendistribusikan aplikasi ke pengguna Anda

Anda sekarang dapat menunjuk ke setup.exe baru dengan tautan atau tombol unduh di situs web mereka. MSIX Core ditargetkan untuk pengguna pada Windows 10, versi 1703 dan yang lebih lama. Penginstal Aplikasi adalah proses penginstalan yang ideal untuk paket MSIX pada Windows 1709 atau versi yang lebih baru. Penginstal Aplikasi mengoptimalkan ruang disk di sisi konsumen dan dapat langsung menginstal aplikasi dari lokasi HTTP. MSIX Core akan mendeteksi apakah konsumen menggunakan Windows 1709 atau versi yang lebih baru dan mengalihkannya ke Penginstal Aplikasi.

Di Microsoft Edge, Anda dapat memanggil metode getHostEnvironmentValue() dan bidang os-build dalam nilai pengembalian akan menentukan versi OS pengguna. Dari sana, Anda kemudian dapat meminta proses penginstalan untuk menggunakan MSIX Core (untuk Windows 10, versi 1703 dan yang lebih lama) atau Penginstal Aplikasi (untuk Windows 10, versi 1709 dan yang lebih baru).

Pengalaman pengguna

Pengguna cukup mengunduh dan menjalankan setup.exe dari halaman web pengembang.

  • Jika penginstal MSIX Core belum diinstal saat pengguna menjalankan setup.exe, pengguna melihat perintah ClickOnce dan mereka mengklik Instal untuk menginstal penginstal MSIX Core. Alat penginstal secara otomatis meluncurkan dan menampilkan layar penginstalan untuk paket MSIX yang ditentukan dalam string kueri pengembang sehingga pengguna dapat menginstal aplikasi.
  • Jika penginstal MSIX Core sudah diinstal saat pengguna menjalankan setup.exe, alat penginstal MSIX Core secara otomatis meluncurkan dan menampilkan layar penginstalan untuk paket MSIX yang ditentukan dalam string kueri bagi pengguna untuk menginstal aplikasi.