Rust와 함께 winapp CLI 사용

이 가이드에서는 Rust 애플리케이션에서 CLI를 사용하여 winapp 패키지 ID로 디버그하고 애플리케이션을 MSIX로 패키지하는 방법을 보여 줍니다.

전체 작업 예제를 보려면 이 리포지토리의 Rust 샘플을 확인하세요.

패키지 ID는 Windows app 모델의 핵심 개념입니다. 이를 통해 애플리케이션은 알림, 보안, AI API 등과 같은 특정 Windows API에 액세스하고, 깨끗한 설치/제거 환경 등을 사용할 수 있습니다.

표준 실행 파일(예: 생성된 cargo build실행 파일)에는 패키지 ID가 없습니다. 이 가이드에서는 디버깅을 위해 추가한 다음 배포용으로 패키지하는 방법을 보여줍니다.

필수 조건

Rust 도구 체인: rustup 또는 winget을 사용하여 Rust를 설치합니다(또는 이미 설치된 경우 업데이트).
```
winget install Rustlang.Rustup --source winget
```
winapp CLI: winget을 winapp 통해 도구를 설치합니다(또는 이미 설치된 경우 업데이트).
```
winget install microsoft.winappcli --source winget
```

1. 새 Rust 앱 만들기

먼저 간단한 Rust 애플리케이션을 만듭니다.

cargo new rust-app
cd rust-app

실행하여 모든 것이 작동하는지 확인합니다.

cargo run

출력은 "Hello, world!"여야 합니다.

2. ID를 확인하도록 코드 업데이트

패키지 ID를 사용하여 실행되는지 확인하도록 앱을 업데이트합니다. 이렇게 하면 이후 단계에서 ID가 제대로 작동하는지 확인하는 데 도움이 됩니다. windows 상자를 사용하여 Windows API에 액세스합니다.

먼저 windows을(를) 실행하여 Cargo.toml에 종속성을 추가합니다.

cargo add windows --features ApplicationModel

이렇게 하면 Windows API 바인딩에 ApplicationModel 기능이 추가되며, 이를 통해 id를 확인하기 위해 Package API에 액세스할 수 있습니다.

다음으로 전체 내용을 다음 코드로 바꿉니다 src/main.rs . 이 코드는 현재 패키지 ID를 검색하려고 시도합니다. 성공하면 패키지 패밀리 이름이 인쇄됩니다. 그렇지 않으면 "패키지되지 않음"을 출력합니다.

메모

full 샘플에는 ID가 있는 경우 Windows 알림을 표시하는 코드도 포함되어 있지만, 이 가이드에서는 ID 검사에 집중합니다.

use windows::ApplicationModel::Package;

fn main() {
    match Package::Current() {
        Ok(package) => {
            match package.Id() {
                Ok(id) => match id.FamilyName() {
                    Ok(name) => println!("Package Family Name: {}", name),
                    Err(e) => println!("Error getting family name: {}", e),
                },
                Err(e) => println!("Error getting package ID: {}", e),
            }
        }
        Err(_) => println!("Not packaged"),
    }
}

3. ID 없이 실행

이제 평소와 같이 앱을 빌드하고 실행합니다.

cargo run

"패키지되지 않음" 출력이 표시됩니다. 그러면 패키지 ID 없이 표준 실행 파일이 실행 중임을 확인합니다.

4. winapp CLI를 사용하여 Project 초기화

이 winapp init 명령은 앱 매니페스트 및 자산 등 필요한 모든 항목을 한 번으로 설정합니다. 매니페스트는 Windows API 액세스 권한을 부여하는 데 사용하는 앱의 ID(이름, 게시자, 버전)를 정의합니다.

다음 명령을 실행하고 프롬프트를 따릅니다.

winapp init

프롬프트가 표시되면

패키지 이름: Enter 키를 눌러 기본값(rust-app)을 적용합니다.
Publisher 이름: Enter 키를 눌러 기본값을 적용하거나 이름을 입력합니다.
버전: Enter 키를 눌러 1.0.0.0 허용
설명: Enter 키를 눌러 기본값을 적용하거나 설명을 입력합니다.
SDK 설정: "SDK 설정 안 함"을 선택합니다(Rust는 C++ SDK 헤더가 아닌 자체 windows 크레이트를 사용합니다.)

이 명령은 다음을 수행합니다.

만들기 Package.appxmanifest - 앱의 ID를 정의하는 매니페스트
폴더 만들기 Assets - MSIX 패키징 및 스토어 제출에 필요한 아이콘

메모

SDK 패키지가 관리되지 않으므로 winapp.yaml가 생성되지 않습니다. Rust는 Cargo를 통해 크레이트windows를 사용하므로 winapp restore/update 추적할 항목이 없습니다.

열 Package.appxmanifest는 표시 이름, 게시자 및 기능과 같은 속성을 추가로 사용자 지정하는 데 사용할 수 있습니다.

실행 별칭 추가(콘솔 앱용)

콘솔 앱을 만들기 때문에 cargo new 매니페스트에 실행 별칭을 추가해야 합니다. winapp run 이 기능이 없으면 AUMID 활성화를 통해 앱을 시작하여 새 창이 열리고 콘솔 앱이 완료되면 해당 창이 즉시 닫히며 출력이 무시됩니다.

또한 별칭을 사용하면 사용자가 MSIX를 설치한 후 터미널에서 이름으로 앱을 실행할 수 있습니다. 매니페스트는 프로젝트의 exe 이름을 기본으로 하여, rust-app.exe 같은 별칭을 등록합니다. 사용자는 이를 rust-app 또는 rust-app.exe로 호출할 수 있습니다.

UI 앱(자체 창을 렌더링하는 Rust 앱)을 빌드하는 경우 이 단계를 건너뜁니다. 이러한 앱은 기본 AUMID 시작에서 제대로 작동합니다.

별칭을 추가합니다.

winapp manifest add-alias

uap5:ExecutionAlias 항목이 Package.appxmanifest에 추가됩니다.

5. ID를 사용하여 디버그

ID를 요하는 기능(예: 알림)을 테스트할 때 앱을 완전히 패키징하지 않고 winapp run을(를) 사용하십시오. 이렇게 하면 전체 빌드 출력 폴더를 실제 MSIX 설치와 마찬가지로 느슨한 레이아웃 패키지로 등록하고 앱을 시작합니다. 디버깅에 인증서 또는 서명이 필요하지 않습니다.

실행 파일을 빌드합니다.
```
cargo build
```
ID를 사용하여 실행:
```
winapp run .\target\debug --with-alias
```

콘솔 출력이 현재 터미널에 유지되도록 플래그는 --with-alias 실행 별칭을 통해 앱을 시작합니다. 이렇게 하려면 4단계에서 추가한 것이 필요합니다 uap5:ExecutionAlias .

메모

winapp run 또한 시스템에 패키지를 등록합니다. 따라서 나중에 6단계에서 설치하려고 할 때 MSIX가 "이미 설치됨"으로 표시될 수 있습니다. 완료되면 개발 패키지를 정리하는 데 사용합니다 winapp unregister .

이제 다음과 유사한 출력이 표시됩니다.

Package Family Name: rust-app_12345abcde

그러면 앱이 유효한 패키지 ID로 실행되고 있는지 확인합니다.

팁 (조언)

고급 디버깅 워크플로(디버거 연결, IDE 설정, 시작 디버깅)는 디버깅 가이드를 참조하세요.

6. MSIX를 사용하여 패키지

앱을 배포할 준비가 되면 동일한 매니페스트를 사용하여 MSIX로 패키지할 수 있습니다. MSIX는 클린 설치/제거, 자동 업데이트 및 신뢰할 수 있는 설치 환경을 제공합니다.

패키지 디렉터리 준비

먼저 최적의 성능을 위해 릴리스 모드에서 애플리케이션을 빌드합니다.

cargo build --release

그런 다음 배포에 필요한 파일만 사용하여 디렉터리를 만듭니다. 폴더에는 target\release 앱의 일부가 아닌 빌드 아티팩트가 포함되어 있습니다. 실행 파일만 필요합니다.

mkdir dist
copy .\target\release\rust-app.exe .\dist\

개발 인증서 생성

MSIX 패키지에 서명해야 합니다. 로컬 테스트의 경우 자체 서명된 개발 인증서를 생성합니다.

winapp cert generate --if-exists skip

Important

인증서의 발행자는 Package.appxmanifest에서 Publisher와 일치해야 합니다. 이 cert generate 명령은 매니페스트에서 자동으로 읽습니다.

서명 및 패키징

이제 한 단계로 패키지를 만들고 서명할 수 있습니다.

winapp pack .\dist --cert .\devcert.pfx

참고: 명령은 pack 현재 디렉터리의 Package.appxmanifest를 자동으로 사용하고 패키징하기 전에 대상 폴더에 복사합니다. 생성된 .msix 파일은 현재 디렉터리에 있습니다.

인증서 설치

MSIX 패키지를 설치하려면 컴퓨터에서 개발 인증서를 신뢰해야 합니다. 관리자 권한으로 이 명령을 실행합니다(인증서당 한 번만 수행하면 됨).

winapp cert install .\devcert.pfx

설치 및 실행

메모

5단계에서 사용한 winapp run 경우 패키지가 시스템에 이미 등록되어 있을 수 있습니다. winapp unregister 먼저 개발 등록을 제거한 다음 릴리스 패키지를 설치합니다.

생성된 .msix 파일을 두 번 클릭하거나 PowerShell을 통해 패키지를 설치합니다.

Add-AppxPackage .\rust-app.msix

이제 다음을 입력하여 터미널의 어디에서나 앱을 실행할 수 있습니다.

rust-app

"패키지 패밀리 이름" 출력이 표시되어 설치되어 있고 ID로 실행 중인지 확인해야 합니다.