Ekstensi Kemasan MSIX

Ekstensi Kemasan MSIX adalah ekstensi Azure DevOps yang membantu membangun, mengemas, dan menandatangani aplikasi Windows menggunakan format paket MSIX.

Alur kerja CI/CD telah menjadi bagian integral dari proses pengembangan untuk meningkatkan efisiensi dan kualitas sekaligus mengurangi biaya dan waktu ke pasar. Solusi CI/CD Microsoft Azure DevOps Pipelines diadopsi secara luas dan populer, tetapi proses saat ini mengintegrasikan alur kerja build dan penyebaran untuk aplikasi yang perlu dipaketkan karena MSIX ke Azure Pipelines melelahkan, khususnya untuk orang-orang yang bukan pakar Azure Pipelines atau MSIX. Ekstensi Azure DevOps ini menawarkan solusi yang mudah dan intuitif sehingga lebih mudah untuk mengotomatiskan proses build dan penyebaran untuk aplikasi yang dipaketkan sebagai MSIX, dan untuk aplikasi dengan alur kerja CI/CD yang ada untuk pindah ke MSIX tanpa mengganggu mekanisme build dan penyebarannya.

Ekstensi Kemasan MSIX berisi tugas-tugas berikut yang dapat Anda gunakan untuk membuat alur kustom sesuai dengan kebutuhan Anda:

1. Build dan paket MSIX - untuk membangun dan mengemas aplikasi Windows menggunakan format paket MSIX
2. Penandatanganan paket MSIX - untuk menandatangani paket MSIX menggunakan sertifikat tepercaya
3. File penginstal aplikasi untuk MSIX - untuk membuat atau memperbarui file .appinstaller untuk aplikasi MSIX
4. Membuat paket untuk lampiran aplikasi MSIX - untuk membuat paket VHDX untuk lampiran aplikasi MSIX

Menginstal ekstensi

Telusuri Marketplace Azure DevOps dan cari nama ekstensi MSIX Packaging Extension.

Membuat Alur

Buat alur baru untuk proyek Azure DevOps Anda.

Pilih opsi untuk Menggunakan editor klasik untuk membuat alur tanpa YAML.

Pilih sistem kontrol versi Anda dan berikan repositori dan detail cabang default Anda.

Saat diminta untuk Memilih templat, klik mulai dengan pekerjaan Kosong.

Ubah pilihan Spesifikasi Agen Anda ke windows-2019 karena ekstensi MSIX hanya berjalan pada agen Windows.

Anda akan melihat Pekerjaan agen 1 secara default di alur Anda. Klik simbol plus untuk Menambahkan tugas ke pekerjaan Agen 1.

Cari MSIX di bilah pencarian Tambahkan tugas dan Anda akan melihat tugas yang disebutkan sebelumnya di Ekstensi Kemasan MSIX. Anda dapat membuat alur kustom dengan menambahkan tugas yang Anda butuhkan sesuai dengan kebutuhan Anda. Tetapi kami akan menunjukkan cara mengonfigurasi keempat tugas di halaman ini.

Build dan paket MSIX

Catatan: Jika Anda mencoba membuat aplikasi paket menggunakan tugas ini, Anda harus menyertakan Proyek Pengemasan Aplikasi Windows, karena tugas memerlukan file Package.appxmanifest. Tugas tidak akan menambahkannya secara otomatis untuk Anda.

YAML

Berikut adalah contoh yang menunjukkan cara mengonfigurasi tugas build dan paket dalam file yaml:

steps:
- task: MSIX.msix-ci-automation-task-dev.msix-packaging.MsixPackaging@1
  displayName: 'MSIX build and package'
  inputs:
    outputPath: '$(Build.ArtifactStagingDirectory)\MyApp.msix'
    solution: MyUWPApp.sln
    buildPlatform: x64
    updateAppVersion: true
    manifestFile: MyUWPApp/Package.appxmanifest
    appVersion: 2.0.0.0
    appPackageDistributionMode: SideloadOnly
    msbuildArchitecture: x64

UI

• Nama tampilan - Sesuaikan nama tugas Anda
• Jalur Output - Tentukan jalur output untuk paket MSIX yang akan dibuat oleh tugas ini. Jalur dalam contoh di atas menggunakan variabel build.ArtifactStagingDirectory yang telah ditentukan sebelumnya yang merupakan jalur lokal pada agen untuk menyimpan artefak, dan digunakan di sini untuk menyimpan file output tugas yang nantinya dapat diterbitkan menggunakan tugas menerbitkan artefak.
• Bangun Solusi dengan MSBuild - Pilih opsi ini untuk membangun solusi Anda dengan msbuild untuk platform target yang ditentukan. Biarkan kotak tidak dicentang jika Anda sudah memiliki biner yang hanya perlu dikemas. Jika Anda membiarkan kotak tidak dicentang, Anda akan diminta untuk menyediakan jalur ke biner Anda.
• Project to Build - Berikan jalur ke file proyek atau solusi Anda yang perlu dibangun.
• Bersihkan sebelum Membangun - Pilih kotak centang ini jika Anda ingin tugas menjalankan build bersih sebelum build.
• Buat Bundel MSIX - Pilih kotak centang ini untuk menghasilkan bundel MSIX alih-alih paket. Pastikan untuk memberi nama file output Anda di opsi Jalur Output dengan ekstensi .msixbundle alih-alih .msix.
• Konfigurasi - Pilih antara konfigurasi build Debug dan Rilis .
• Platform - Tentukan platform build target, misalnya, x64, x86, CPU Apa pun.
• Perbarui Versi Aplikasi di Manifes - Pilih kotak centang ini untuk mengubah versi aplikasi dari versi yang ditentukan dalam file .appxmanifest aplikasi. Ini tidak akan menimpa file .appxmanifest, tetapi mengubah versi aplikasi dalam paket MSIX output yang dihasilkan. Jika opsi ini dipilih, Anda akan diminta untuk menyediakan jalur ke file manifes, dan nomor versi aplikasi yang akan diatur untuk aplikasi.
• Mode Distribusi Paket Aplikasi - Pilih mode dari menu dropdown untuk menghasilkan paket aplikasi Store atau paket aplikasi non-Store.
• Versi dan Arsitektur MSBuild - Sesuaikan MSBuild Anda dengan menentukan opsi tingkat lanjut.

Penandatanganan paket MSIX

Tugas penandatanganan memungkinkan penandatanganan menggunakan sertifikat. Sertifikat dapat berasal dari pustaka File Aman , atau dikodekan sebagai string seolah-olah diambil dengan tugas Azure Key Vault.

YAML

Berikut adalah contoh yang menunjukkan cara mengonfigurasi tugas penandatanganan paket dalam file yaml:

steps:
- task: MSIX.msix-ci-automation-task-dev.msix-signing.MsixSigning@1
  displayName: 'Sign MSIX package'
  inputs:
    certificateType: base64
    encodedCertificate: '$(kvtestcert)'

UI

Contoh ini memperlihatkan tugas ketika sumber sertifikat adalah Pustaka File Aman.

Contoh ini menunjukkan tugas saat sumber sertifikat adalah Azure Key Vault.

• Nama tampilan - Sesuaikan nama tugas Anda
• Paket untuk ditandatangani - Tugas penandatanganan paket MSIX menggunakan SignTool untuk menandatangani semua file yang cocok dengan jalur ini, terlepas dari apakah itu paket atau bundel MSIX.
• Jenis file sertifikat - Pilih sumber file sertifikat yang akan digunakan.
• Time Stamp Server - URL yang menentukan alamat server stempel waktu. Ini adalah parameter opsional.

File penginstal aplikasi untuk MSIX

YAML

Berikut adalah contoh yang menunjukkan cara mengonfigurasi tugas file AppInstaller dalam file yaml:

steps:
- task: MSIX.msix-ci-automation-task-dev.app-installer-file.AppInstallerFile@1
  displayName: 'Create App Installer file'
  inputs:
    package: '$(Build.ArtifactStagingDirectory)\MyApp.msix'
    outputPath: '$(Build.ArtifactStagingDirectory)\MyApp.appinstaller'
    uri: 'https://myuwpapp-demo.azurewebsites.net/MyApp.appinstaller'
    mainItemUri: 'https://myuwpapp-demo.azurewebsites.net/MyApp.msix'
    showPromptWhenUpdating: true
    updateBlocksActivation: true

UI

• Nama tampilan - Sesuaikan nama tugas Anda
• Paket - Ini adalah jalur ke paket atau bundel yang ingin Anda buat Alat Penginstal Aplikasinya.
• Jalur File Output - Ini adalah jalur file Penginstal Aplikasi yang akan ditulis.
• Metode untuk Membuat File Penginstal Aplikasi - Pilih apakah akan membuat file Penginstal Aplikasi baru atau memperbarui yang sudah ada. Jika Anda memilih untuk memperbarui yang sudah ada, Anda akan diminta untuk menyediakan jalur ke file Penginstal Aplikasi yang ada.
• Versi untuk file Penginstal Aplikasi - Nomor versi yang akan diberikan. Harus mengambil formulir (utama).(minor). (build). (revisi).
• URI - URI Web ke file Penginstal Aplikasi yang dialihkan.
• Paket Utama/Bundel URI - URI ke paket aplikasi/lokasi bundel.
• Pembaruan Saat Diluncurkan - Pilih ini untuk mengatur aplikasi guna memeriksa pembaruan saat diluncurkan. Jika kotak centang ini dipilih, Anda akan diminta untuk memberikan detail seperti Jam Antara Pemeriksaan Pembaruan, apakah akan Menampilkan UI kepada Pengguna saat Memperbarui, dan apakah Anda ingin Memperbarui untuk Memblokir Aktivasi Aplikasi.

Membuat paket untuk lampiran aplikasi MSIX

YAML

Berikut adalah contoh yang menunjukkan cara mengonfigurasi tugas untuk membuat file VHDX untuk lampiran aplikasi dalam file yaml:

steps:
- task: MSIX.msix-ci-automation-task-dev.msix-app-attach.MsixAppAttach@1
  displayName: 'Create package for MSIX app attach'
  inputs:
    package: '$(Build.ArtifactStagingDirectory)\MyApp.msix'
    vhdxOutputPath: '$(Build.ArtifactStagingDirectory)\MyApp.vhdx'

UI

• Nama tampilan - Sesuaikan nama tugas Anda.
• Jalur Paket - Ini adalah jalur ke paket/bundel MSIX.
• Jalur Output VHDX - Ini adalah jalur file VHDX yang akan dibuat oleh tugas.
• Ukuran VHDX - Ukuran maksimum dalam MB VHDX.

Setelah mengonfigurasi semua tugas, Anda dapat menggunakan tugas Terbitkan artefak build untuk menghilangkan semua artefak dari lokasi sementara ke artefak Azure Pipelines atau berbagi file pilihan Anda.

Menerbitkan paket lampiran aplikasi MSIX ke AVD

YAML

Berikut adalah contoh yang menunjukkan cara mengonfigurasi tugas lampiran aplikasi avd dalam file yaml:

steps:
- task: MSIX.msix-ci-automation-task-dev.avd-app-attach-publish.AVDAppAttachPublish@0
  displayName: 'Publish MSIX app attach package to AVD'
  inputs:
    vhdxPath: '$(Build.ArtifactStagingDirectory)/App.vhdx' 
    connectedServiceNameARM: 'ed1db943-1e1c-4eac-8683-ead2abc281b5' 
    resourceGroupName: 'appattach-test-rg' 
    storageAccount: 'appattachteststorage' 
    fileShare: 'appattach-test-fs' 
    hostPool: 'appattach-hostpool' 
    workSpace: 'appattach-test-ws' 
    applicationGroup: 'appattach-test-ag-rail' 

UI

• Nama tampilan - Sesuaikan nama tugas Anda.

• Jalur Paket - Ini adalah jalur ke paket/bundel MSIX.

• Jalur Output VHDX - Ini adalah jalur file VHDX yang akan dibuat oleh tugas.

• Ukuran VHDX - Ukuran maksimum dalam MB VHDX.

• Nama tampilan - Sesuaikan nama tugas Anda.

• Jalur VHDX - Ini adalah jalur file VHDX yang akan dilampirkan aplikasi (terbitkan) ke Azure Virtual Desktop (AVD).

• Langganan Azure - Ini adalah koneksi layanan untuk menargetkan langganan azure yang perlu dilampirkan aplikasi Anda. Menu drop-down mencantumkan semua langganan azure yang tersedia untuk pengguna masuk ADO saat ini dan pengguna dapat memilih salah satu dari langganan ini dan membuat koneksi layanan ke langganan tersebut.

• Grup Sumber Daya - Pilih grup sumber daya yang perlu diterbitkan aplikasi Anda. Grup sumber daya ini harus berisi semua sumber daya target yang diperlukan untuk lampiran aplikasi, seperti akun penyimpanan, kumpulan host, ruang kerja, grup aplikasi. Drop-down ini mencantumkan semua grup sumber daya yang tersedia di bawah langganan Azure yang dipilih.

• Akun penyimpanan - Pilih akun penyimpanan yang Anda aplikasikan (atau VHDX) akan diunggah. Drop-down ini mencantumkan semua akun penyimpanan yang tersedia di bawah grup sumber daya yang dipilih.

• Berbagi file - Pilih berbagi file di akun penyimpanan yang dipilih yang akan diunggah oleh aplikasi Anda (atau VHDX). Drop-down ini mencantumkan semua berbagi file yang tersedia di bawah akun penyimpanan yang dipilih.

• Kumpulan host - Pilih kumpulan host yang akan digunakan untuk aplikasi yang melampirkan aplikasi. Drop-down ini mencantumkan semua kumpulan host yang tersedia di bawah grup sumber daya yang dipilih.

• Ruang kerja - Pilih ruang kerja yang akan digunakan untuk aplikasi yang melampirkan aplikasi. Drop-down ini mencantumkan semua ruang kerja yang tersedia di bawah grup sumber daya yang dipilih.

• Grup aplikasi - Pilih grup aplikasi yang akan digunakan untuk aplikasi yang melampirkan aplikasi. Drop-down ini mencantumkan semua grup aplikasi yang tersedia di bawah grup sumber daya yang dipilih.

Setelah mengonfigurasi semua tugas, Anda dapat menggunakan tugas Terbitkan artefak build untuk menghilangkan semua artefak dari lokasi sementara ke artefak Azure Pipelines atau berbagi file pilihan Anda.

Cara memberikan Umpan Balik

Kami akan senang mendengar umpan balik Anda tentang Ekstensi Kemasan MSIX. Hubungi kami melalui saluran berikut:

• Meninjau ekstensi di Azure DevOps Marketplace
• Komunitas Teknologi MSIX
• Proyek sumber terbuka GitHub - Kode sumber untuk ekstensi ini adalah bagian dari proyek sumber terbuka MSIX SDK, yang menyambut kontribusi dan saran.