다음을 통해 공유

애플리케이션(wdapp.exe)

  • 아티클

응용 프로그램 관리(wdapp.exe)는 PC Microsoft 게임 개발 키트(GDK) 타이틀을 설치하고 실행하는 명령줄 도구입니다.

wdapp는 다음 표에 설명된 하위 명령과 함수를 제공합니다.

명령 설명
wdapp 실행 애플리케이션의 AUMID(애플리케이션 사용자 모델 ID)를 지정하여 애플리케이션을 시작합니다.
wdapp terminate 지정된 패키지를 종료합니다. MSIXVC 설치된 패키지에 대해서만 작동합니다.
wdapp 목록 PC에 나란히 로드된 애플리케이션을 모두 나열합니다.
wdapp gamefolder 드라이브에 대한 설치 폴더를 쿼리하거나 설정합니다.
wdapp 업데이트 네트워크 공유 또는 로컬 시스템 파일 경로에서 패키지된 빌드 업데이트를 스트리밍합니다.
wdapp 설치 makepkg로 만든 애플리케이션 패키지의 스트리밍 설치를 시작해 애플리케이션을 배포합니다.
wdapp 등록 애플리케이션을 지정된 폴더에 등록합니다.
wdapp 제거 패키지의 모든 프로세스를 종료 및 등록 취소합니다.
wdapp 등록 취소 애플리케이션의 등록을 취소합니다.
wdapp 마이그레이션 플랫 파일 설치로 마이그레이션합니다.

애플리케이션 배포, 설치, 업데이트, 나열 및 제거

wdapp 실행

AUMID 및 실행 파일 경로를 제공하여 정의된 응용 프로그램을 실행합니다.

wdapp 시작AUMID | 실행 파일

옵션

설명

AUMID시작되는 애플리케이션의 AUMID입니다. wdapp launch에서는 AUMID 옵션이나 실행 파일 옵션 중 하나만 지정할 수 있습니다.
실행 파일시작되는 응용 프로그램의 실행 파일 경로를 지정합니다. wdapp launch에서는 AUMID 옵션이나 실행 파일 옵션 중 하나만 지정할 수 있습니다.
WaitToExit애플리케이션을 시작하고 타이틀이 종료될 때까지 차단합니다. 타이틀이 종료되면 wdapp이 종료되어 타이틀의 종료 코드가 반환됩니다.
로그stdout 및 stdin을 스크래치 드라이브의 파일로 리디렉션합니다. 접두사가 지정되지 않으면, 파일 이름은 latest_stdout.txt 및 latest_stderr.txt로 지정됩니다. 32자를 초과하면 접두사가 잘립니다.
show all | launchResult | terminateResult | targetTerminateReason | exitCode all - 모든 결과가 표시됩니다.

launchResult - 게임을 시작하지 못한 이유입니다. S_OK이면 게임이 성공적으로 시작된 것입니다.

terminateResult - 종료된 상태가 된 이유입니다. S_OK이면 적절한 PLM 흐름을 통해 정상적으로 종료된 것입니다.

targetTerminateReason - 사용 가능한 경우 종료가 대상인 이유, 그렇지 않으면 S_FALSE

exitCode - 프로세스 종료 시 게임에서 반환한 종료 코드입니다. WaitToExit 인수를 사용할 때 게임이 종료되면 표시되는 항목을 결정합니다.

이 항목의 맨 위쪽으로 돌아갑니다.

wdapp terminate

지정된 패키지를 종료합니다. MSIXVC 설치된 패키지에 대해서만 작동합니다.

wdapp terminateAUMID | PackageFullName

옵션

설명

AUMID종료할 애플리케이션의 AUMID(AppUserModelId)를 지정합니다. wdapp terminate은 AUMID 옵션 또는 PackageFullName 옵션을 사용하지만 지정된 경우 둘 다 사용하지 않습니다.
PackageFullName종료되는 PackageFullName을 지정합니다. wdapp terminate은 AUMID 옵션 또는 PackageFullName 옵션을 사용하지만 지정된 경우 둘 다 사용하지 않습니다.

이 항목의 맨 위쪽으로 돌아갑니다.

wdapp list

wdapp list

옵션

설명

/d나열된 애플리케이션에 관한 세부 정보를 제공합니다.

이 항목의 맨 위쪽으로 돌아갑니다.

wdapp gamefolder

wdapp gamefolder <DriveLetter>: [/set <FolderPath>]

옵션

설명

<DriveLetter>:스트리밍 설치가 발생할 대상 드라이브를 지정합니다. XboxGames라는 루트 폴더의 OS 드라이브가 기본값입니다.
/세트 <DriveLetter>에 지정된 드라이브의 스트리밍 설치 폴더를 설정합니다. 기본값은 XboxGames입니다.

이 항목의 맨 위쪽으로 돌아갑니다.

wdapp 업데이트

wdapp updatepackagepath [/l|/AllChunks] [/b] [/a] [/m] [/ContentTypes=[semicolon-delimited specifier list] ] [/Languages=[semicolon-delimited specifier list] ] [/Devices=[semicolon-delimited specifier list] ] [/Tags=[semicolon-delimited specifier list] ]

옵션

설명

packagepath업데이트에 사용되는 패키지 파일의 경로를 지정합니다.
/l시작 청크를 받은 후의 업데이트 정지를 지정합니다.
/AllChunks변경되지 않은 경우에도 업데이트 시 모든 청크가 강제로 설치되도록 지정합니다.
/b업데이트에서 이전 버전으로 돌아갈 수 있는지 여부를 지정합니다.
/a업데이트를 사용 가능한 것으로 등록합니다.
/m업데이트를 필수인 것으로 등록합니다.
/ContentTypes=[세미콜론으로 구분된 지정자 목록]기본적으로 업데이트할 ContentTypes 지정자를 지정합니다.
/Languages=[세미콜론으로 분리된 지정자 목록]기본적으로 업데이트할 언어 지정자를 지정합니다.
/Devices=[세미콜론으로 구분된 지정자 목록]기본적으로 업데이트할 장치 지정자를 지정합니다.
/Tags=[세미콜론으로 구분된 지정자 목록]기본적으로 업데이트할 태그 지정자를 지정합니다. 모든 태그를 삭제하려면 '/Tags='를 지정하세요.
[이 항목의 맨 위로 돌아갑니다.] (gr-wdapp.md)

wdapp 설치

makepkg로 만든 애플리케이션 패키지의 스트리밍 설치를 시작해 애플리케이션을 배포합니다.

install 명령은 애플리케이션이 RETAIL PC에 설치될 때 발생하는 스트리밍 설치 프로세스를 반영합니다.

스트리밍 설치 패키지 테스트에 대한 자세한 내용은 스트리밍 설치 및 지능형 전송: 개요를 참조하세요.

wdapp 설치 [/l|/AllChunks] [/bootstrapper] [/drive=[drive letter] ] [ /ContentTypes=[semicolon-delimited specifier list] ] [/Languages=[semicolon-delimited specifier list] ] [/Devices=[semicolon-delimited specifier list] ] [/Tags=[semicolon-delimited specifier list] ] [/Drive [Optional] ] [/tm] [/l] [/v] [/w] ] { packagepath | packageURI }
옵션 설명
/bootstrapper 설치 작업에서 /bootstrapper 플래그를 사용하면 게임이 시작될 때 PC 부트스트래퍼가 호출됩니다. 이렇게 하면 애플리케이션이 코드를 실행하기 전에 PC 부트스트래퍼가 호출되는 표준 소매 설치인 것처럼 타이틀이 실행되고 애플리케이션이 PC 부트스트래퍼의 자식 프로세스로 나타납니다. 이것이 설정되지 않은 경우 해당 런타임 호출이 수행될 때 필수 전제 조건 검사가 호출됩니다(예: 로그인 유효성 검사를 위한 XUserAddAsync).
/Features=[세미콜론으로 분리된 기능 목록] 기본적으로 설치할 기능을 나타냅니다. /Tags와 함께 사용할 수 없습니다.
/Recipes=[세미콜론으로 분리된 레시피 목록] 기본적으로 설치할 레시피를 나타냅니다. /Tags와 함께 사용할 수 없습니다.
{ packagepath | packageURI } 개발 컴퓨터의 경로인 packagepath 또는 URI인 packageURI 중 하나를 제공해 애플리케이션 패키지의 위치를 지정합니다. 구운 광디스크(DVD 또는 블루레이 디스크)로 설치할 경우 파일 이름 앞의 xo:\ 드라이브 접두사를 xbapp install에 사용할 수 있습니다.wdapp install /w xo:\packagepath
/Languages=[세미콜론으로 분리된 지정자 목록] 기본적으로 설치할 언어 지정자를 지정합니다.
/Devices=[세미콜론으로 구분된 지정자 목록] 기본적으로 설치할 장치 지정자를 지정합니다.
/Tags=[세미콜론으로 구분된 지정자 목록] 기본적으로 설치할 태그 지정자를 지정합니다. 모든 태그를 삭제하려면 ‘/Tags=’를 지정하세요.
/drive=[drive letter] 기본값을 사용하는 대신 애플리케이션을 설치할 대상 드라이브를 지정합니다.
/tm 모든 파일을 전송한 다음 성능 메트릭 요약을 인쇄합니다.
/l 시작 청크를 받은 후의 설치 정지를 지정합니다.
/AllChunks 설치 시 모든 청크가 강제로 설치되도록 지정합니다.
/v 자세한 메시지를 표시합니다.

이 항목의 맨 위쪽으로 돌아갑니다.

wdapp 등록

애플리케이션을 지정된 폴더에 등록합니다.

wdapp 등록 folder_path

옵션

설명

folder_path 타이틀을 등록해야 하는 [MicrosoftGame.config](../../system/overviews/microsoft-game-config/MicrosoftGameConfig-toc.md) 파일이 포함된 애플리케이션 루트 디렉터리에 상대적인 폴더 경로를 지정합니다.

이 항목의 맨 위쪽으로 돌아갑니다.

wdapp 제거

패키지의 모든 프로세스를 종료 및 등록 취소합니다.

wdapp 제거 package_full_name

옵션

설명

package_full_name 애플리케이션의 전체 패키지 이름을 지정합니다. 예: mygame_1.0.0.0_neutral__r9wapr0zzdgy.

이 항목의 맨 위쪽으로 돌아갑니다.

wdapp 등록 취소

패키지를 종료하고 등록 취소합니다.

wdapp 등록 취소 package_full_name

옵션

설명

package_full_name 애플리케이션의 전체 패키지 이름을 지정합니다. 예: mygame_1.0.0.0_neutral__r9wapr0zzdgy.

이 항목의 맨 위쪽으로 돌아갑니다.

wdapp 마이그레이션

기존 MSIXVC 설치를 플랫 파일 설치 형식으로 마이그레이션합니다. 이 명령어는 2022년 3월 Microsoft GDK(게임 개발 키트)를 사용할 때 이미 설치된 기존 게임의 설치 형식을 플랫 파일 설치 형식으로 마이그레이션하기 위해 제공됩니다.

wdapp migrate <PackageFullName>

옵션

설명

<PackageFullName>애플리케이션의 전체 패키지 이름을 지정합니다. 예: mygame_1.0.0.0_neutral__r9wapr0zzdgy.

이 항목의 맨 위쪽으로 돌아갑니다.

설명

PC Microsoft 게임 개발 키트(GDK) 타이틀 설치 및 실행에 대한 자세한 내용은 Microsoft 게임 개발 키트 도구를 사용하여 PC 타이틀 설치 및 실행을 참조하세요.

참고 항목

PC 명령줄 도구플랫 파일 설치 개요Microsoft 게임 개발 키트 도구를 사용하여 PC 타이틀 설치 및 실행