PC Bootstrapper

PC Bootstrapper는 일관성 제공, 실행 상태 전달, 설치된 게임의 최신 상태 보장, 클라우드 저장 동기화, 그리고 게임의 여러 인스턴스가 실행되지 않도록 함으로써 MSIXVC로 패키징된 PC 게임의 실행 경험을 개선합니다. 사이드 로드 개발 워크플로 중, 그리고 설치된 MSIXVC 패키지 타이틀이 리테일 시나리오에서 실행될 때 표시됩니다. 2022년 5월 Gaming Runtime Services(GRTS) 릴리스 이전에는 다음과 같은 문제가 PC 게임 실행 경험에 영향을 미쳤습니다.

• 최종 사용자는 게임 창이 표시되기 전까지 게임 실행 상태에 대해 안내받지 못합니다.
• 개발자는 설치된 게임이 최신 상태인지 확인해야 합니다.
• 게임 프로세스가 실행되기 전까지 클라우드 저장이 동기화되지 않습니다.
• 개발자는 게임의 여러 인스턴스가 실행되지 않도록 방지해야 합니다.

2022년 5월 GRTS 릴리스부터 PC Bootstrapper는 위의 실행 문제를 다음과 같이 해결합니다.

• 사용자가 게임을 실행하려고 시도한 즉시 스플래시 화면을 표시해 프로세스가 시작되었음을 전달합니다.
• 게임 프로세스가 시작되기 전에 설치된 게임이 Partner Center에서 사용 가능한 최신 버전으로 업데이트되도록 합니다. 선택적으로 업데이트 확인 단계를 따라 수동으로 업데이트를 확인하고 적용할 수 있습니다.
• 게임 프로세스가 시작되기 전에 클라우드 저장을 자동으로 동기화합니다.
• 설치된 게임을 자동으로 단일 인스턴스로 제한해 여러 실행을 방지합니다.

간소화된 사용자 모드(Simplified User Mode)(2022년 6월 GDK부터 사용 가능)를 사용하는 개발자의 경우, 메인 PC Bootstrapper 플로우가 호출되지 않는 loose deploy 시나리오에서도 런타임이 적절한 시행을 수행합니다.

​

PC Bootstrapper란

PC Bootstrapper는 MSIXVC로 패키징된 PC 게임이 게임 프로세스가 시작되기 전에 정상 상태인지 확인하도록 도와주는 Gaming Runtime 유틸리티(GamingServicesUI.exe)입니다. 설치된 MSIXVC 패키지 PC 게임이 실행될 때마다(XBOX 앱, 시작 메뉴, 데스크톱 바로 가기, 명령줄 도구를 통해) Gaming Runtime Services(GRTS)가 먼저 PC Bootstrapper를 호출합니다. PC Bootstrapper가 사전 실행 요구 사항이 충족되었는지 확인하면 PC Bootstrapper 프로세스가 게임을 실행합니다. PC Bootstrapper는 2022년 5월 GRTS 릴리스부터 XBOX App 또는 Microsoft Store를 통해 획득한 모든 MSIXVC 패키지 PC 게임의 게임 실행 플로우의 일부입니다. wdapp.exe install로 사이드 로드된 개발자 패키지의 경우 /bootstrapper 플래그를 포함해야 합니다. PC Bootstrapper가 활성화된 상태에서 MSIXVC 패키지 타이틀을 디버깅할 때 게임 프로세스는 다른 헬퍼 프로세스의 자식 프로세스가 됩니다.

​

동작 방식

다음은 PC Bootstrapper의 동작 요약입니다.

• MSIXVC 패키지 PC 게임이 실행되면 PC Bootstrapper는 먼저 게임이 이미 실행 중인지 확인합니다. 게임이 실행 중이면 PC Bootstrapper는 게임 창을 전면에 가져오고 PC Bootstrapper 프로세스를 종료합니다. (참고: 이 경우 게임의 새 인스턴스는 시작되지 않습니다.)
• 게임의 다른 인스턴스가 실행 중이지 않다면 PC Bootstrapper는 실행 직후 SplashScreenImage(MicrosoftGame.config 파일에 지정됨)를 표시해 게임이 시작 중이라는 피드백을 제공합니다.
• 스플래시 화면이 보이면 게임 프로세스를 시작합니다. PC Bootstrapper는 게임 창이 보일 때까지 계속 실행됩니다.
• 게임 창이 보이면 PC Bootstrapper의 작업이 완료되고 PC Bootstrapper 프로세스가 종료됩니다.

​

이점

다음은 PC Bootstrapper의 이점 요약입니다.

• 게임 프로세스의 현재 작업 디렉터리를 게임 설치 위치의 루트로 설정합니다.
  • 설치된 게임 디렉터리에서 한 번에 하나의 실행 파일 프로세스만 실행되도록 보장합니다.
• 인스턴스가 이미 실행 중이라면 그 실행 파일의 창을 전면으로 가져옵니다.
• 실행 경험을 추가해 게임을 실행한 시점부터 게임의 기본 창이 표시되는 사이에 진행이 이루어지고 있음을 더 명확하게 전달합니다.

​

Gaming Runtime Services(GRTS) 의존성

PC Bootstrapper는 모든 Windows 10/11 PC에 자동으로 배포되는 Gaming RunTime Service(GRTS)에 의존합니다. 개발 PC의 GRTS가 오래되었다면 로그인 시도 시 오류(E_FAIL)가 발생할 수 있습니다. PC에 최신 버전의 Gaming Services가 설치되어 있는지 확인하려면:

1. Windows 10/11 개발 환경이 RETAIL 모드로 설정되어 있고 개발자 샌드박스가 아닌지 확인합니다.
2. 다른 모든 게임과 앱을 닫습니다.
3. 다음 링크를 사용해 Microsoft Gaming Services의 Microsoft Store 페이지로 이동합니다(필요하면 “More details”를 선택해 스토어 페이지를 확장): https://www.microsoft.com/store/productId/9MWPM2CQNLHN
4. 최신 상태이고 업데이트가 필요하다는 메시지가 표시되지 않는지 확인합니다.
5. 또한 Microsoft Store 앱의 Library 뷰로 이동해 모든 앱과 구성 요소를 업데이트합니다.

​

질문 또는 우려 사항

PC Bootstrapper에 대한 질문이나 우려 사항이 있다면 XBOX Developer Forums에 게시하거나 담당 Account Manager에게 문의하세요.

​

참고

• MicrosoftGame.config Reference(샘플 MicrosoftGame.config 및 스키마)
• Microsoft Gaming Development Kit 도구를 활용해 PC 타이틀 설치 및 실행하기