Windows 앱 개발 CLI(winapp CLI)

중요합니다

Windows 앱 개발 CLI는 현재 공개 미리 보기 있습니다. 기능 및 명령은 최종 릴리스 전에 변경될 수 있습니다. 의견을 문제를 작성하여 공유하세요.

Windows 앱 개발 CLI(winapp CLI)는 Windows SDK를 관리하고, 패키징하고, 앱 ID, 매니페스트, 인증서를 생성하고, 모든 앱 프레임워크에서 빌드 도구를 사용하기 위한 단일 명령줄 인터페이스입니다. 이 도구는 플랫폼 간 개발과 Windows 네이티브 기능 간의 격차를 해소합니다.

.NET/Win32, CMake, Electron 또는 Rust를 사용하여 빌드하는 경우 이 CLI를 통해 다음을 액세스할 수 있습니다.

  • Modern Windows API - Windows 앱 SDK 및 자동 설정 및 코드 생성을 사용하는 Windows SDK
  • 패키지 ID - 전체 패키징 없이 패키지 ID를 추가하여 디버그 및 테스트
  • MSIX 패키징 - 서명 및 스토어 준비를 사용한 앱 패키징
  • Developer Tools - 매니페스트, 인증서, 자산 및 빌드 통합

패키지 ID를 지정하는 이유는 무엇인가요?

많은 강력한 Windows API를 사용하려면 앱에 패키지 ID가 있어야 합니다. ID를 사용하면 앱이 알림, OS 통합 및 디바이스 내 AI와 같은 기능에 access 얻을 수 있습니다. 패키지 ID의 잠금을 해제하고 올바른 패키징 모델을 선택하는 데 도움이 되는 전체 목록은 패키징 개요를 참조하세요.

설치

WinGet

CLI를 설치하는 가장 쉬운 방법은 WinGet(Windows 패키지 관리자)을 통해서입니다.

winget install Microsoft.winappcli --source winget

NPM

Electron 프로젝트의 경우 NPM을 통해 설치합니다.

npm install @microsoft/winappcli --save-dev

GitHub Actions/Azure DevOps

CI/CD pipelines 경우 setup-WinAppCli 작업을 사용하여 실행기/에이전트에 CLI를 자동으로 설치합니다.

수동 다운로드

GitHub 릴리스 최신 빌드를 다운로드합니다.

설치 확인

설치되면 CLI를 호출하여 설치를 확인합니다.

winapp --help

또는 Electron/Node.js사용하는 경우:

npx winapp --help

지원되는 프레임워크

winapp CLI는 다양한 앱 프레임워크에서 작동합니다.

프레임워크 가이드
.NET / WPF / WinForms .NET으로 시작하십시오
C++(CMake) C++ 시작하기
전자 Electron 사용 시작하기
러스트 Rust 시작하기
타우리 주 타우리를 시작하세요
떨림 Flutter 시작하기

추가 가이드:

명령 개요

카테고리 Commands
설치 init, 복원, 업데이트
ID 및 디버깅 run, create-debug-identity, unregister
패키징 pack
매니페스트 매니페스트 생성, 매니페스트 업데이트 자산, 매니페스트 추가 별칭
인증서 및 서명 인증서 생성, 인증서 설치, 서명, create-external-catalog
유틸리티 tool, store, get-winapp-path, complete
UI 자동화 ui
Node.js/Electron node create-addon 명령으로 추가 기능을 생성하고, node add-electron-debug-identity 명령을 사용하여 Electron 디버그 아이덴티티를 추가하며, node clear-electron-debug-identity 명령으로 디버그 아이덴티티를 제거할 수 있습니다.

전체 CLI 참조는 CLI 참조를 참조하세요.

오픈 소스

winapp CLI가 오픈 소스. 소스 코드, 파일 문제를 찾고 GitHub 기여할 수 있습니다.