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 Windows API megköveteli, hogy az alkalmazás csomagidentitással rendelkezzen. 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.

  • Last updated on