Windows-alkalmazás fejlesztési parancssori felület (winapp CLI)

Fontos

A Windows-alkalmazás fejlesztési parancssori felület jelenleg közzétételi előzetes verzióban érhető el. A funkciók és a parancsok a végleges kiadás előtt változhatnak. Ossza meg visszajelzését probléma létrehozásával.

A Windows-alkalmazás fejlesztési parancssori felület (winapp CLI) egyetlen parancssori felület, amellyel felügyelhet Windows SDK-kat, csomagolást, alkalmazásidentitást, jegyzékeket, tanúsítványokat hozhat létre, és bármilyen alkalmazás-keretrendszerrel rendelkező buildelési eszközöket használhat. Ez az eszköz áthidalja a platformfüggetlen fejlesztés és a Windows natív képességek közötti szakadékot.

Akár .NET/Win32, CMake, Electron vagy Rust használatával készül, ez a parancssori felület a következőhöz nyújt hozzáférést:

  • Modern Windows API-k - Windows App SDK és Windows SDK automatikus beállítással és kódgenerálással
  • Csomagidentitás – Hibakeresés és tesztelés a csomagidentitás teljes csomagolás nélküli hozzáadásával
  • MSIX Packaging – Alkalmazáscsomagolás aláírással és áruházi felkészültséggel
  • Developer Tools – Jegyzékek, tanúsítványok, eszközök és buildintegráció

Miért érdemes csomagidentitást használni?

Számos hatékony Windows API-hoz szükséges, hogy az alkalmazás csomagidentitást használjon. Az identitással az alkalmazás access kap olyan funkciókhoz, mint az értesítések, az operációs rendszer integrációja és az eszközön futó AI. A csomag identitásának feloldását és a megfelelő csomagolási modell kiválasztását segítő teljes listát a Csomagolás áttekintése című témakörben találja.

Telepítés

WinGet

A parancssori felület telepítésének legegyszerűbb módja a WinGet (Windows Csomagkezelő):

winget install Microsoft.winappcli --source winget

NPM

Elektronprojektek esetén telepítse az NPM-en keresztül:

npm install @microsoft/winappcli --save-dev

GitHub Actions/Azure DevOps

CI/CD-pipelinek esetén használja a setup-WinAppCli műveletet a parancssori felület automatikus telepítéséhez a futókra/ügynökökre.

Manuális letöltés

Töltse le a legújabb buildet GitHub kiadásokból.

Telepítés ellenőrzése

A telepítés után ellenőrizze a telepítést a parancssori felület meghívásával:

winapp --help

Vagy ha az Electron vagy a Node.js technológiát használja:

npx winapp --help

Támogatott keretrendszerek

A Winapp CLI számos alkalmazás-keretrendszerrel működik:

Keretrendszer Guide
.NET / WPF / WinForms Első lépések a .NET használatában
C++ (CMake) Kezdje el a C++
Elektron Kezdje el az Electron használatát
Rust Ismerkedjen meg a Rusttal
Tauri Kezdje el a Taurival
Lebeg Kezdje el a Flutter használatát

További útmutatók:

  • EXE/CLI csomagolása: részletes útmutató meglévő EXE/CLI MSIX-ként való csomagolásához
  • Shell-kiegészítés: parancsok, beállítások és értékek fülkiegészítésének engedélyezése a PowerShellben, bashben, zsh-ben és fish-ben

Parancsok áttekintése

Kategória Parancsok
Setup init, restore, update
Azonosítás és hibakeresés run, create-debug-identity, unregister
Csomagolás csomagol
Rakományjegyzék jegyzék generálása, jegyzék frissítés-eszközök, jegyzék alias hozzáadása
Tanúsítványok > Aláírás tanúsítvány létrehozása, tanúsítvány telepítése, aláírás, külső katalógus létrehozása
Utilities eszköz, áruház, get-winapp-path, befejező
felhasználói felület automatizálás Ui
Node.js/Electron node create-addon, node add-electron-debug-identity, node clear-electron-debug-identity

A teljes CLI-referenciaért tekintse meg a CLI-referenciát.

Nyílt forráskód

A winapp parancssori felület nyílt forráskód. A forráskódot, a fájlproblémákat és a közreműködést a GitHub webhelyen találja.