시작: 전자 앱에 Windows API 추가

이 가이드에서는 Windows 앱 Development CLI를 사용하여 Windows 네이티브 기능을 Electron 애플리케이션에 추가하는 방법을 안내합니다. Electron 앱에서 최신 Windows API를 호출하고, 앱 ID로 테스트하고, 배포용 패키지를 사용하는 방법을 알아봅니다.

만들게 될 것들

이 가이드를 마치면 다음과 같은 Electron 앱이 제공됩니다.

  • ✅ 최신 Windows API 호출(Windows SDK 및 Windows 앱 SDK)
  • ✅ AI 기능이 있는 네이티브 추가 기능 사용(Phi Silica 또는 WinML)
  • ✅ 보호된 API를 테스트하기 위해 앱 ID를 사용하여 실행
  • ✅ 배포를 위해 서명된 MSIX로 패키지

사전 요구 사항

시작하기 전에 다음이 있는지 확인합니다.

  • Windows 11(Phi Silica를 사용하는 경우 코필로트+ PC)
  • Node.js - winget install OpenJS.NodeJS --source winget
  • .NET SDK v10 - winget install Microsoft.DotNet.SDK.10 --source winget
  • Visual Studio 및 네이티브 데스크톱 워크로드 - winget install --id Microsoft.VisualStudio.Community --source winget --override "--add Microsoft.VisualStudio.Workload.NativeDesktop --includeRecommended --passive --wait"

프로세스

Windows 사용 가능한 Electron 앱을 빌드하려면 다음 세 가지 주요 단계가 포함됩니다.

1. 개발 환경 설정

먼저 필요한 도구 및 SDK를 사용하여 개발 환경을 설정합니다. 여기에는 다음이 포함됩니다.

  • Electron 앱 만들기 또는 구성
  • winapp CLI 설치
  • Windows SDK 및 필수 에셋 초기화
  • 빌드 파이프라인 설정

설치 → 시작

2. 네이티브 추가 기능 만들기

다음으로, Windows API를 호출하는 네이티브 추가 기능을 만듭니다. 다음 가이드 중 하나를 선택합니다.

옵션 A: C++ 알림 추가 기능 만들기

Windows 앱 SDK 알림 API를 호출하는 C++ 추가 기능을 만드는 방법을 알아봅니다. 이것은 더 복잡한 시나리오를 살펴보기 전에 네이티브 추가 기능을 이해하기 위한 좋은 시작점입니다.

C++ 알림 추가 기능 만들기 →

옵션 B: Phi Silica Addon 만들기

Phi Silica AI 모델을 사용하여 디바이스에서 텍스트를 요약하는 C# 추가 기능을 만드는 방법을 알아봅니다. Phi Silica는 NPU를 사용하는 Windows 11 디바이스에서 로컬로 실행되는 작은 언어 모델입니다.

Phi Silica Addon을 만들기

옵션 C: WinML 추가 기능 만들기

WinML(Windows Machine Learning)을 사용하여 이미지 분류, 개체 검색 등에 대한 사용자 지정 ONNX 모델을 실행하는 C# 추가 기능을 만드는 방법을 알아봅니다.

WinML Addon → 만들기

3. 배포용 패키징

마지막으로 배포를 위해 앱을 MSIX로 패키지합니다. 여기에는 다음이 포함됩니다.

  • 프로덕션을 위한 앱 빌드
  • MSIX 패키지 만들기 및 서명
  • 설치된 패키지 테스트
  • 배포 옵션 이해

앱을 패키지하세요 →

빠른 탐색

단계 가이드 학습 내용
1️⃣ 설치 도구 설치, SDK 초기화, 빌드 파이프라인 구성
2️⃣ C++ 알림 추가 기능 C++ 추가 기능 만들기, 알림 API 호출, 디버그 ID로 테스트
2️⃣ 피 실리카 아돈 C# 추가 기능 만들기, AI API 호출, 디버그 ID로 테스트
2️⃣ WinML Addon C# 추가 기능 만들기, WinML API 호출, ONNX 모델 실행, ML 통합
3️⃣ 패키징 프로덕션 앱 빌드, MSIX 만들기, 배포

추가 리소스

지원 받기

  • Last updated on