Windows App Development CLI (winapp CLI)

Penting

Windows App Development CLI saat ini dalam pratinjau publik. Fitur dan perintah dapat berubah sebelum rilis akhir. Bagikan umpan balik Anda dengan buat laporan masalah.

Windows App Development CLI (winapp CLI) adalah antarmuka baris perintah tunggal untuk mengelola SDK Windows, pengemasan, menghasilkan identitas aplikasi, manifes, sertifikat, dan menggunakan alat build dengan kerangka kerja aplikasi apa pun. Alat ini menjenjangi kesenjangan antara pengembangan lintas platform dan kemampuan asli Windows.

Baik Anda membangun dengan .NET/Win32, CMake, Electron, atau Rust, CLI ini memberi Anda akses ke:

  • API Modern Windows - SDK Aplikasi Windows dan Windows SDK dengan penyiapan otomatis dan pembuatan kode.
  • Identitas Paket - Debug dan uji dengan menambahkan identitas paket tanpa kemasan penuh
  • Kemasan MSIX - Kemasan aplikasi dengan penandatanganan dan Kesiapan Toko
  • Developer Tools - Manifest, sertifikat, aset, dan integrasi build

Mengapa identitas paket?

Banyak API Windows yang kuat mengharuskan aplikasi Anda memiliki identitas paket. Dengan identitas, aplikasi Anda mendapatkan akses ke fitur seperti pemberitahuan, integrasi sistem operasi, dan AI di perangkat. Untuk daftar lengkap identitas paket apa yang membuka kunci dan membantu memilih model pengemasan yang tepat, lihat Gambaran umum pengemasan.

Penginstalan

WinGet

Cara term mudah untuk menginstal CLI adalah melalui WinGet (Windows Package Manager):

winget install Microsoft.winappcli --source winget

NPM

Untuk proyek Electron, instal melalui NPM:

npm install @microsoft/winappcli --save-dev

GitHub Actions /Azure DevOps

Untuk pipelines CI/CD, gunakan tindakan setup-WinAppCli untuk menginstal CLI secara otomatis pada runner/agen Anda.

Unduhan manual

Unduh build terbaru dari rilis GitHub.

Verifikasi penginstalan

Setelah diinstal, verifikasi penginstalan dengan memanggil CLI:

winapp --help

Atau jika menggunakan Electron/Node.js:

npx winapp --help

Kerangka kerja yang didukung

winapp CLI bekerja dengan berbagai kerangka kerja aplikasi:

Kerangka kerja Panduan
.NET / WPF / WinForms Mulai dengan .NET
C++ (CMake) Memulai dengan C++
Elektron Mulai dengan Electron
Rust Mulai dengan Rust
Tauri Mulai dengan Tauri
Flutter Memulai dengan Flutter

Panduan tambahan:

  • Mengemas EXE/CLI: panduan langkah demi langkah untuk mengemas EXE/CLI yang ada sebagai MSIX
  • Penyelesaian Shell: mengaktifkan penyelesaian tab untuk perintah, opsi, dan nilai di PowerShell, bash, zsh, dan fish

Gambaran umum perintah

Kategori Perintah
Siapkan init, restore, update
Identitas & Debugging jalankan, create-debug-identity, unregister
Kemasan bungkus
Manifestasi menghasilkan manifes, memperbarui aset manifes, menambah alias manifes
Sertifikat & Penandatanganan buat sertifikat, pasang sertifikat, tandatangani, buat-katalog-eksternal
Utilitas alat, penyimpanan, get-winapp-path, selesai
Otomatisasi UI ui
Node.js/Electron node create-addon, node add-electron-debug-identity, node clear-electron-debug-identity

Untuk referensi CLI lengkap, lihat referensi CLI.

Sumber terbuka

winapp CLI sumber terbuka. Anda dapat menemukan kode sumber, masalah file, dan berkontribusi pada GitHub.

  • Last updated on