> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # GDK 도구로 PC 타이틀 설치 및 실행하기 > Microsoft Gaming Runtime에서 실행되는 PC 타이틀을 설치, 실행, 문제 해결하기 위해 Microsoft Game Development Kit(GDK) 도구를 사용하는 방법을 안내합니다. 이 항목은 PC 타이틀 설치 및 실행을 위한 Microsoft Game Development Kit (GDK) 도구에 대해 설명합니다. 이러한 도구를 사용하는 방법을 설명하고 PC 설치 및 실행 문제 해결에 대한 인사이트를 제공합니다. ## PC에서 타이틀을 설치하고 실행하기 위한 도구 앱 실행 및 Gaming Runtime을 통한 실행에 대한 자세한 내용은 [Win32 게임 실행](/build/core-features/common/game-config/MicrosoftGameConfig-Overview#MSGC-PCLaunch)을 참조하세요. Microsoft Game Development Kit (GDK)는 타이틀 설치에 대해 다음과 같은 접근 방식을 제공합니다. * [wdapp.exe install](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_install): 타이틀의 .MSIXVC 패키지를 설치하는 데 사용됩니다. PC 타이틀 패키징에 대한 자세한 내용은 [MSIXVC 패키징 도구를 사용하여 PC용 타이틀 패키징 시작](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC)을 참조하세요. 패키지에서 전체 [PC Bootstrapper](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/gr-pc-bootstrapper) 흐름을 활성화하려면 /bootstrapper 플래그를 통해 활성화할 수 있습니다. * [wdapp.exe register](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_register): 실행할 수 있도록 느슨한 파일 폴더를 등록하는 데 사용됩니다. 자세한 내용은 [PC 게임 등록](/tools/tools-pc/title-registration-pc)을 참조하세요. 2022년 6월 GDK부터, 소매 설치 시나리오를 테스트할 때와 같이 데스크톱 및 시작 메뉴 셸 아이콘을 활성화하려는 경우에만 게임을 등록하면 됩니다. Microsoft Game Development Kit (GDK)는 타이틀 실행에 대해 다음과 같은 접근 방식을 제공합니다. * 타이틀을 등록한 후에는 시작 메뉴에서 선택 가능한 항목으로 나타나며 검색 상자에서 검색할 수 있습니다. * [wdapp.exe launch](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_launch)는 application user model ID (AUMID) 또는 실행 파일 경로를 사용하여 타이틀을 실행하는 데 사용됩니다. * Windows Device Portal (WDP): **설치된 앱**으로 이동한 다음 **시작**을 선택합니다. ### PC Bootstrapper가 활성화된 상태로 실행 소매 사용자가 보게 될 전체 [PC Bootstrapper](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/gr-pc-bootstrapper) 흐름으로 실행하려면 wdapp install과 /bootstrapper 플래그를 통해 패키지를 사이드로드해야 합니다. 느슨한 빌드 또는 플래그 없는 설치의 경우 PC Bootstrapper 기능은 XUserAddAsync가 호출될 때 단순화된 사용자 모델을 강제하는 것으로 제한됩니다. ### 타이틀 ID를 사용한/사용하지 않은 실행 2022년 6월 GDK부터 [MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-Overview)가 올바르게 구성되어 있는 한, 타이틀을 실행하는 데 사용된 방법과 관계없이 런타임은 동일하게 작동해야 합니다. ### 명령줄 인수와 함께 실행 2022년 6월 GDK부터 실행 파일을 직접 실행하면서 임의의 \[실행 인수]를 직접 전달할 수 있습니다. 또한 다음 방법 중 하나를 사용하여 명령줄 인수와 함께 타이틀을 실행할 수 있습니다. * GDK 명령 프롬프트에서 `WdApp Launch [launch args]`. * 명령 프롬프트에서 ` [launch args]`. * Visual Studio 프로젝트 속성의 명령줄 인수. Execution Alias 사용에 대한 자세한 내용은 [ExecutionAlias](/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executable#MicrosoftGameConfig-Alias)를 참조하세요. ## PC 설치 및 실행 문제 해결 ### 오류 코드 0x80073CFF: 유효한 라이선스 또는 사이드로딩 정책을 적용할 수 없기 때문에 패키지 배포에 실패했습니다. 개발자 라이선스 또는 엔터프라이즈 사이드로딩 구성이 필요할 수 있습니다. #### 문제 타이틀을 설치, 등록 또는 실행하려고 할 때 문제가 발생했습니다. #### 해결 방법 해결 방법은 다음 단계를 사용하여 PC에서 개발자 모드를 활성화하는 것입니다. 1. **설정**을 엽니다. 2. 검색 필드에 *Developer*를 입력합니다. 3. 표시되는 옵션 목록에서 **개발자 기능 사용**을 선택합니다. 4. **개발자 모드**를 선택합니다. 시스템에서 기능을 추가하는 중이라는 대화 상자가 나타납니다. 이 과정이 완료될 때까지 기다려야 합니다. ### 오류 코드 0x80073cfc: 애플리케이션을 시작할 수 없습니다. 애플리케이션을 다시 설치하여 문제를 해결해 보세요. #### 문제 설치 프로세스의 초기 단계 중 하나에서 문제가 발생했습니다. #### 해결 방법 Gaming Runtime Services (GRTS)를 제거하고 다시 설치할 수 있습니다. 다음 단계에 따라 수행하세요. 1. PowerShell 관리자 명령 프롬프트를 엽니다. 2. `get-appxpackage *gamings*` 명령을 실행합니다. 3. `remove-package ` 명령을 실행합니다. 4. XBOX 앱을 연 다음 게임을 설치합니다. 이렇게 하면 Microsoft Store에서 gamingservices 패키지가 설치됩니다. ### 오류 코드 0x87e00017: 설치 소스를 찾았으나 도달할 수 없습니다. 인터넷 문제일 가능성이 큽니다. #### 문제 이 오류 코드는 `IM_E_UNREACHABLE_INSTALL_SOURCE`에 해당합니다. 배포 시스템이 파일에 액세스할 수 없는 경우 이 오류가 발생합니다. 그러나 실제로는 설치 디렉터리가 손상되었을 수도 있습니다. 가장 일반적인 원인은 이후에 제대로 정리되지 않은 부분적으로 성공한 배포입니다. #### 해결 방법 이러한 문제를 해결하려면 1. `wdapp list` 앱을 실행합니다. 2. 결과 목록에서 설치한 게임의 버전을 찾습니다. 3. `wdapp uninstall `을 사용하여 모든 게임을 제거합니다. 4. 게임을 다시 설치해 봅니다. ### 오류 코드 0x80080203: 지정된 패키지 형식이 잘못되었습니다: 필수 발자국 파일이 없어 파일이 유효한 앱 패키지가 아닙니다. #### 문제 "중첩된 MSIXVC"가 있기 때문에 발생합니다(쉽게 발생할 수 있음). 데스크톱 빌드가 *C:\MyGame*이라고 가정해 보겠습니다. *C:\MyGame*의 하위 폴더(예: *C:\MyGame\Package*)에서 [makepkg.exe](/build/core-features/common/packaging/deployment/makepkg)를 사용하여 패키지를 만들기로 결정합니다. 처음에는 패키지가 생성되지 않았기 때문에 작동하지만 패키지를 다시 만들려고 시도한 후 이 문제가 발생합니다. 이러한 실패(패키지에 *AppxManifest.xml* 파일이 두 개 있어 발생) 외에도, *C:\MyGame*에서 *makepkg.exe*를 실행하면 기존 .msixvc를 새 패키지에 패키징하려고 합니다(genmap에서 제외하지 않는 한). #### 해결 방법 이 문제를 해결하려면 패키지 디렉터리가 *MicrosoftGame.config*를 포함하는 디렉터리 외부에 있는지 확인하세요. ### 오류 코드 0x80070490: 요소를 찾을 수 없습니다. #### 문제 이 문제는 `wdapp install`로 .XVC(XBOX 패키지용 패키징 형식)를 설치하려고 시도할 때 발생합니다. #### 해결 방법 `wdapp install`은 .MSIXVC 패키지(PC 패키지용 패키징 형식)에만 사용하세요. ### 타이틀 폴더가 공유되어 있을 때 wdapp을 통한 실행 오류 #### 문제 [wdapp.exe register](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_register)로 이전에 등록된 폴더를 Windows 파일 공유로 공유하면 Gaming Runtime이 공유 권한을 잃게 되어 다음 오류가 발생합니다. ``` '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 데이터를 저장하고 복원하는 것입니다. 1. 폴더를 공유하기 전에 'icacls /save AclFile'을 실행하여 패키지 폴더의 ACL을 저장합니다. 2. Windows 파일 공유를 사용하여 폴더를 공유합니다. 3. 이전 ACL을 복원하려면 'icacls /restore AclFile'을 실행합니다. 이 해결 방법 외에도 먼저 `wdapp.exe unregister`를 실행한 다음 `wdapp.exe register`를 실행하여 다시 등록할 수도 있습니다. 이렇게 하면 폴더 공유를 유지하면서 권한이 복원됩니다. ### 오류 코드 0x80070005: 액세스가 거부되었습니다. #### 문제 wdapp install 명령을 실행할 때 "0x8007005: Access is Denied" 오류가 발생합니다. #### 해결 방법 .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 launch 명령을 실행할 때 "0x000007b" 오류가 발생합니다. #### 해결 방법 문제는 실행되는 실행 파일이 MicrosoftGame.config에 지정된 것과 다른 플랫폼 아키텍처라는 것입니다. MicrosoftGame.config의 DesktopRegistration 요소에는 값으로 'x86' 또는 'x64'를 지정할 수 있는 ProcessorArchitecture라는 선택적 자식 요소가 있습니다. 이 사양이 Executable 요소에 정의된 실행 파일의 플랫폼 아키텍처와 일치하는지 확인하면 이 문제가 해결됩니다. ### 오류 코드 0x800701B1: 존재하지 않는 디바이스가 지정되었습니다. #### 문제 wdapp install /drive 명령을 실행할 때 "0x800701B1" 오류가 발생합니다. #### 해결 방법 문제는 Windows Store에서 대상 드라이브를 감지하지 못한 것입니다. 로컬 PC의 "설정 -> 저장소 설정 -> 새 콘텐츠가 저장되는 위치 변경"의 "새 앱이 저장될 드라이브:" 드롭다운 목록에 대상 드라이브가 있는지 확인하세요. 드라이브가 없으면 드라이브의 상태를 확인하고 로컬 PC에 최신 Windows 업데이트가 설치되어 있는지 확인하세요. ### 오류 코드 0x80072F78: WININET\_E\_INVALID\_SERVER\_RESPONSE #### 문제 wdapp install 명령을 실행할 때 "0x80072F78" 오류가 발생합니다. #### 해결 방법 이 문제는 방화벽 프록시 구성 설정이 "settings-win.data.microsoft.com" 주소를 차단하는 것과 관련이 있습니다. 이 주소는 PC GDK 타이틀을 설치할 때 설치 설정이 제대로 캐시되기 위해 필요합니다. 방화벽 소프트웨어에서 이 주소가 허용되어 있는지 확인하세요. ## 함께 보기 [Microsoft Game Development Kit 시작](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/get-started/get-started-home) [PC용 패키징 시작](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC) [PC Bootstrapper](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/gr-pc-bootstrapper) [MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-toc) [Application Management (wdapp.exe)](/tools/tools-pc/commandlinetools/gr-wdapp) [PC 게임 등록](/tools/tools-pc/title-registration-pc) [플랫 파일 설치 개요](/build/core-features/common/packaging/packaging-flatfileinstall) [명령줄 도구(PC용)](/tools/tools-pc/commandlinetools/gr-commandlinetools-toc) [PC 게임 개발(환경 및 도구)](/tools/tools-pc/gc-tools-pc-toc) ## Related topics - [MSIXVC 도구로 PC 타이틀 패키징 시작하기](/ko/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md) - [PC 게임 개발 환경 및 도구](/ko/tools/tools-pc/gc-tools-pc-toc.md) - [PC Bootstrapper](/ko/build/gdk-and-engines/guides/pc-bootstrapper.md) - [XBOX GDK를 위한 PC 개발자 도구](/ko/tools/tools-pc/index.md) - [Unreal Engine와 함께 GDK 사용](/ko/build/gdk-and-engines/unreal/unreal.md)