Microsoft 게임 개발 키트 도구를 활용하여 PC 타이틀 설치 및 시작

아티클
05/10/2023

이 항목에서는 Microsoft GDK(게임 개발 키트) 도구를 사용하여 PC 타이틀을 설치하고 시작하는 방법을 설명합니다. 이러한 도구를 사용하는 방법을 설명하고 PC 설치 문제 해결 및 시작 문제에 대한 통찰력을 제공합니다.

PC에서 타이틀을 설치 및 시작하는 도구

참고 항목

앱 시작과 게임 런타임오로 시작에 대한 자세한 내용은 Win32 게임 시작을 참조하세요.

Microsoft GDK(게임 개발 키트)는 다음과 같은 타이틀 설치 방법을 제공합니다.

wdapp.exe install: 타이틀에 .MSIXVC 패키지를 설치하는 데 사용됩니다. PC 타이틀의 패키징에 대한 자세한 내용은 MSIXVC 패키징 도구를 사용하여 PC용 타이틀의 패키징 시작을 참조하세요. 패키지에서 전체 PC 부트스트래퍼 흐름을 사용하도록 설정하려면 /bootstrapper 플래그를 통해 사용하도록 설정할 수 있습니다.
wdapp.exe register: 시작을 위해 느슨한 파일 폴더를 등록하는 데 사용됩니다. 자세한 내용은 PC 게임 등록을 참조하세요. 2022년 6월 GDK부터는 리테일 설치 시나리오를 테스트할 때와 같이 데스크톱 및 시작 메뉴 셸 아이콘을 사용하도록 설정하려는 경우에만 게임을 등록해야 합니다.

Microsoft GDK(게임 개발 키트)는 다음과 같은 타이틀 시작 방법을 제공합니다.

타이틀을 등록하면 시작 메뉴에서 선택 가능한 것으로 표시되며 검색 상자에서 검색할 수 있습니다.
wdapp.exe launch는 AUMID(응용 프로그램 사용자 모델 ID) 또는 실행 파일의 경로를 사용하여 타이틀을 실행하는 데 사용됩니다.
WDP(Windows 장치 포털): 설치된 앱으로 이동한 다음 시작을 선택합니다.

PC 부트스트래퍼를 사용하도록 설정하여 시작

리테일 사용자가 볼 수 있는 것처럼 전체 PC 부트스트래퍼 흐름으로 시작하려면 wdapp 설치를 통해 패키지를 테스트용으로 로드하고 /bootstrapper 플래그를 사용해야 합니다. 플래그 없이 느슨한 빌드 또는 설치의 경우 PC 부트스트래퍼 기능은 XUserAddAsync가 호출될 때 간소화된 사용자 모델을 적용하는 것으로 제한됩니다.

타이틀 ID를 사용하거나 사용하지 않고 시작

2022년 6월 GDK부터 런타임은 MicrosoftGame.config가 올바르게 구성된 한 타이틀을 시작하는 데 사용되는 방법에 관계없이 동일하게 작동해야 합니다.

명령줄 인수를 사용하여 시작

2022년 6월 GDK를 기준으로 실행 파일을 직접 모든 [launch args]에 직접 전달할 수 있습니다.

또한 다음 방법 중 하나를 사용하여 명령줄 인수를 사용하여 타이틀을 시작할 수도 있습니다.

GDK 명령 프롬프트에서 WdApp Launch [launch args].
명령 프롬프트에서 <ExecutionAlias> [launch args].
Visual Studio 프로젝트 속성의 명령줄 인수.

실행 파일 별칭을 사용하는 방법에 대한 자세한 내용은 ExecutionAlias를 참조하세요.

PC 설치 및 시작 문제 해결

에러 코드 0x80073CFF: 유효한 라이선스 또는 사이드로드 정책을 적용하지 못하여 패키지 배포에 실패했습니다. 개발자 라이선스 또는 엔터프라이즈 테스트용 사이드로드 구성이 필요할 수 있습니다.

문제

타이틀을 설치, 등록 또는 시작하려고 할 때 문제가 발생합니다.

해결 방법

이 해결 방법은 다음 단계를 사용하여 PC에서 개발자 모드를 사용하도록 합니다.

설정을 엽니다.
검색 필드에 개발자를 입력합니다.
표시되는 옵션 목록에서 개발자 기능 사용을 선택합니다.
개발자 모드를 선택합니다. 시스템에서 기능을 추가하는 중임을 알리는 대화 상자가 표시됩니다. 이 프로세스가 완료될 때까지 기다려야 합니다.

에러 코드 0x80073cfc: 응용프로그램을 시작할 수 없습니다. 응용프로그램을 다시 설치하여 문제를 해결해 보세요.

문제

설치 프로세스의 초기 단계 중 하나에 문제가 있습니다.

해결 방법

GRTS(게임 런타임 서비스)를 제거하고 다시 설치할 수 있습니다. 이렇게 하려면 다음 단계를 따르세요.

Powershell 관리 명령 프롬프트를 엽니다.
다음 명령 실행: get-appxpackage *gamings*
다음 명령 실행: remove-package <package fullname from step 2 for the gamingservices package>
Xbox 앱을 열고, 게임을 설치합니다. 이렇게 하면 Microsoft Store에서 gamingservices 패키지 설치가 시작됩니다.

오류 코드 0x87e00017: 설치 원본을 찾았지만 연결할 수 없습니다. 인터넷 문제일 수 있습니다.

문제

이 오류 코드는 IM_E_UNREACHABLE_INSTALL_SOURCE에 해당합니다. 배포 시스템이 파일에 액세스할 수 없는 경우 이 오류가 발생합니다. 그러나 설치 디렉터리가 손상된 것일 수도 있습니다. 가장 일반적인 원인은 나중에 제대로 정리되지 않은 부분적으로 성공한 배포입니다.

해결 방법

이 오류를 해결하려면

wdapp list 앱을 실행합니다.
결과 목록에서 설치한 게임의 모든 버전을 찾습니다.
wdapp uninstall <pfn>을(를) 사용하여 모든 게임을 제거합니다.
게임을 다시 설치해 봅니다.

오류 코드 0x80080203: 지정된 패키지 형식이 유효하지 않음: 필요한 공간 파일이 없어서 파일이 올바른 앱 패키지가 아닙니다.

문제

"중첩된 MSIXVC"가 있기 때문에 이 오류가 발생합니다(쉽게 발생할 수 있음). 데스크톱 빌드를 C:\MyGame으로 가정하겠습니다. C:\MyGame 아래의 하위 폴더에서(예: C:\MyGame\Package) makepkg.exe를 사용하여 패키지를 만들기로 합니다. 패키지가 생성되지 않아서 처음에는 작동하지만, 패키지를 다시 만들려고 할 때 이 문제가 발생합니다. 이 오류(패키지에 두 개의 AppxManifest.xml 파일이 있는 경우) 외에도, C:\MyGame에서 makepkg.exe를 실행하면 기존 .msixvc를 새로운 패키지의에 패키지화하려고 시도합니다(genmap에서 제외되지 않은 경우).

해결 방법

이 문제를 해결하려면, 패키지 디렉토리가 MicrosoftGame.config가 있는 디렉터리의 외부에 있는지 확인합니다.

오류 코드 0x80070490: 요소를 찾을 수 없음

문제

wdapp install이(가) 있는 상태에서 .XVC 설치를 시도하면 이 문제가 발생합니다(.XVC는 Xbox 패키지를 위한 패키징 형식입니다).

해결 방법

.MSIXVC 패키지만을 위한 wdapp install을(를) 사용해야 합니다(.MSIXVC는 PC 패키지를 위한 패키징 형식입니다).

타이틀 폴더가 공유될 때 wdapp을 통해 시작하는 오류

문제

wdapp.exe register를 사용하여 이미 등록된 폴더를 Windows 파일 공유로 공유하는 경우, 게임 런타임의 공유 권한 상실을 유발하고 따라서 이 오류가 발생합니다.

    'WdApp.exe launch' must be called with an AUMID to activate an application.

    Use 'WdApp.exe list' to get a list of sideloaded packages including AUMID values.

    Alternatively, if your executable specifies an Alias in the *MicrosoftGame.config*,

    typing the alias name at the command prompt will do an application activation.

    Failed with 0x80070057.

해결 방법

이 문제는 ACL(액세스 제어 목록)과 관련된 것입니다. 폴더를 공유하면 앱 모델에 액세스할 수 없습니다. 즉, 컨테이너는 공유할 때 파일을 읽을 수 있는 권한을 잃게 됩니다. ACL 데이터를 저장하고 복원하기 위해 다음 단계를 따르세요.

폴더를 공유하기 전에 'icacls /save AclFile'을 실행하여 패키지 폴더의 ACL을 저장합니다.
Windows 파일 공유를 사용하여 폴더를 공유합니다.
이전 ACL을 복원하기 위해 'icacls /restore AclFile'을 실행합니다.

이 해결 방법 외에도 먼저 wdapp.exe unregister을(를) 실행한 다음 wdapp.exe register을(를) 실행하여 다시 등록할 수 있습니다. 그러면 폴더 공유를 유지하면서 사용 권한이 복원됩니다.

오류 코드 0x80070005: 액세스가 거부되었습니다.

문제

wdapp install 명령을 실행할 때 "0x8007005: 액세스가 거부되었습니다." 오류가 발생합니다.

해결 방법

.msixvc 파일에 전체 경로를 전달하고 있는지 확인합니다. 예:

맞음:

wdapp install "c:\MyGame\GDKBuildFolder\GdkGame_1.0.0.0_x64__pmsdash4d.msixvc"

올바르지 않음(.msixvc의 전체 경로 누락):

wdapp install "c:\MyGame\GDKBuildFolder"

오류 코드 0x000007b: STATUS_INVALID_IMAGE_FORMAT

문제

wdapp 시작 명령을 실행할 때 “0x000007b” 오류가 발생합니다.

해결 방법

문제는 시작되는 실행 파일이 MicrosoftGame.config에 지정된 것과 다른 플랫폼 아키텍처라는 것입니다. MicrosoftGame.config의 DesktopRegistration 요소에는 ‘x86’ 또는 ‘x64’를 해당 값으로 지정할 수 있는 ProcessorArchitecture라는 선택적 하위 요소가 있습니다. 이 사양이 Executable 요소에 정의된 실행 파일의 플랫폼 아키텍처와 일치하는지 확인하면 이 문제가 해결됩니다.

오류 코드 0x800701B1: 존재하지 않는 디바이스가 지정되었습니다.

문제

wdapp install /drive 명령을 실행할 때 "0x800701B1" 오류가 발생합니다.

해결 방법

문제는 대상 드라이브가 Windows 스토어에서 검색되지 않았기 때문에 발생합니다. 대상 드라이브가 로컬 PC의 "설정 -> >저장소 설정> -> 새 콘텐츠가 저장되는 위치 변경"의 "새 앱 저장 위치:" 드롭다운 목록에 있는지 확인합니다. 드라이브가 없는 경우 드라이브의 상태를 확인하고 로컬 PC에 최신 Windows 업데이트가 있는지 확인하세요.

오류 코드 0x80072F78: WININET_E_INVALID_SERVER_RESPONSE

문제

wdapp install 명령을 실행할 때 "0x80072F78" 오류가 발생합니다.

해결 방법

이 문제는 이 주소 "settings-win.data.microsoft.com"을 차단하는 방화벽 프록시 구성 설정과 관련이 있습니다. 이 주소는 PC GDK 타이틀을 설치할 때 설치 설정을 올바르게 캐시하는 데 필요합니다. 방화벽 소프트웨어에서 이 주소가 허용되는지 확인하세요.