PC에서 타이틀을 설치하고 실행하기 위한 도구
앱 실행 및 Gaming Runtime을 통한 실행에 대한 자세한 내용은 Win32 게임 실행을 참조하세요.
- wdapp.exe install: 타이틀의 .MSIXVC 패키지를 설치하는 데 사용됩니다. PC 타이틀 패키징에 대한 자세한 내용은 MSIXVC 패키징 도구를 사용하여 PC용 타이틀 패키징 시작을 참조하세요. 패키지에서 전체 PC Bootstrapper 흐름을 활성화하려면 /bootstrapper 플래그를 통해 활성화할 수 있습니다.
- wdapp.exe register: 실행할 수 있도록 느슨한 파일 폴더를 등록하는 데 사용됩니다. 자세한 내용은 PC 게임 등록을 참조하세요. 2022년 6월 GDK부터, 소매 설치 시나리오를 테스트할 때와 같이 데스크톱 및 시작 메뉴 셸 아이콘을 활성화하려는 경우에만 게임을 등록하면 됩니다.
- 타이틀을 등록한 후에는 시작 메뉴에서 선택 가능한 항목으로 나타나며 검색 상자에서 검색할 수 있습니다.
- wdapp.exe launch는 application user model ID (AUMID) 또는 실행 파일 경로를 사용하여 타이틀을 실행하는 데 사용됩니다.
- Windows Device Portal (WDP): 설치된 앱으로 이동한 다음 시작을 선택합니다.
PC Bootstrapper가 활성화된 상태로 실행
소매 사용자가 보게 될 전체 PC Bootstrapper 흐름으로 실행하려면 wdapp install과 /bootstrapper 플래그를 통해 패키지를 사이드로드해야 합니다. 느슨한 빌드 또는 플래그 없는 설치의 경우 PC Bootstrapper 기능은 XUserAddAsync가 호출될 때 단순화된 사용자 모델을 강제하는 것으로 제한됩니다.타이틀 ID를 사용한/사용하지 않은 실행
2022년 6월 GDK부터 MicrosoftGame.config가 올바르게 구성되어 있는 한, 타이틀을 실행하는 데 사용된 방법과 관계없이 런타임은 동일하게 작동해야 합니다.명령줄 인수와 함께 실행
2022년 6월 GDK부터 실행 파일을 직접 실행하면서 임의의 [실행 인수]를 직접 전달할 수 있습니다. 또한 다음 방법 중 하나를 사용하여 명령줄 인수와 함께 타이틀을 실행할 수 있습니다.-
GDK 명령 프롬프트에서
WdApp Launch [launch args]. -
명령 프롬프트에서
<ExecutionAlias> [launch args]. - Visual Studio 프로젝트 속성의 명령줄 인수.
PC 설치 및 실행 문제 해결
오류 코드 0x80073CFF: 유효한 라이선스 또는 사이드로딩 정책을 적용할 수 없기 때문에 패키지 배포에 실패했습니다. 개발자 라이선스 또는 엔터프라이즈 사이드로딩 구성이 필요할 수 있습니다.
문제
타이틀을 설치, 등록 또는 실행하려고 할 때 문제가 발생했습니다.해결 방법
해결 방법은 다음 단계를 사용하여 PC에서 개발자 모드를 활성화하는 것입니다.- 설정을 엽니다.
- 검색 필드에 Developer를 입력합니다.
- 표시되는 옵션 목록에서 개발자 기능 사용을 선택합니다.
- 개발자 모드를 선택합니다. 시스템에서 기능을 추가하는 중이라는 대화 상자가 나타납니다. 이 과정이 완료될 때까지 기다려야 합니다.
오류 코드 0x80073cfc: 애플리케이션을 시작할 수 없습니다. 애플리케이션을 다시 설치하여 문제를 해결해 보세요.
문제
설치 프로세스의 초기 단계 중 하나에서 문제가 발생했습니다.해결 방법
Gaming Runtime Services (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(XBOX 패키지용 패키징 형식)를 설치하려고 시도할 때 발생합니다.
해결 방법
wdapp install은 .MSIXVC 패키지(PC 패키지용 패키징 형식)에만 사용하세요.
타이틀 폴더가 공유되어 있을 때 wdapp을 통한 실행 오류
문제
wdapp.exe register로 이전에 등록된 폴더를 Windows 파일 공유로 공유하면 Gaming Runtime이 공유 권한을 잃게 되어 다음 오류가 발생합니다.해결 방법
이 문제는 액세스 제어 목록(ACL)과 관련이 있습니다. 폴더를 공유하면 앱 모델에 대한 액세스가 방지됩니다. 즉, 공유 시 컨테이너가 파일 읽기 권한을 잃습니다. 해결 방법은 다음 단계에 따라 ACL 데이터를 저장하고 복원하는 것입니다.- 폴더를 공유하기 전에 ‘icacls /save AclFile’을 실행하여 패키지 폴더의 ACL을 저장합니다.
- Windows 파일 공유를 사용하여 폴더를 공유합니다.
- 이전 ACL을 복원하려면 ‘icacls /restore AclFile’을 실행합니다.
wdapp.exe unregister를 실행한 다음 wdapp.exe register를 실행하여 다시 등록할 수도 있습니다. 이렇게 하면 폴더 공유를 유지하면서 권한이 복원됩니다.