중요합니다
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 시작하기 |
추가 가이드:
- EXE/CLI 패키징: 기존 EXE/CLI를 MSIX로 패키징하기 위한 단계별 가이드
- 셸 완성: PowerShell, bash, zsh 및 fish의 명령, 옵션 및 값에 대한 탭 완성 사용
명령 개요
| 카테고리 | 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 기여할 수 있습니다.
관련 토픽
Windows developer