Skip to main content
타이틀이 최신 상태를 유지하는 것이 중요한 경우 업데이트를 확인하고 적용할 수 있습니다. 이 조건은 게임을 실행하는 모든 플레이어가 동일한 기능을 갖는 것이 매우 중요한 멀티플레이어 기능을 게임이 포함하는 경우에 특히 중요합니다. 타이틀은 다음 예제 코드에서 볼 수 있듯이 XStoreQueryGameAndDlcPackageUpdatesAsync를 사용하여 업데이트를 확인할 수 있습니다.
예를 들어 라이선스 용도로만 사용되는 빈 DLC 패키지처럼 업데이트 확인이 필요하지 않은 많은 DLC 항목이 타이틀에 포함된 경우, 위 코드는 각 항목을 확인하기 때문에 불필요한 오버헤드를 야기할 수 있습니다. 대신 XPackageGetCurrentProcessPackageIdentifier로 얻은 현재 게임의 패키지 ID로 필터링하거나 XPackageEnumeratePackages에서 반환된 패키지 ID를 필터링하여 XStoreQueryPackageUpdatesAsync를 사용하세요.

업데이트 다운로드 및 설치

업데이트 세트를 식별한 후 XStoreDownloadAndInstallPackageUpdatesAsync를 사용하여 모든 업데이트를 큐에 넣고 다운로드하세요.
이 시점에서 업데이트를 적용하기 위해 게임이 종료됩니다. 이 프로세스는 경고 없이 발생하므로, 이 함수를 호출하기 전에 사용자에게 충분한 알림 또는 확인을 제공하세요.

다운로드 진행률 모니터링

다운로드가 진행 중일 때 XPackageCreateInstallationMonitor를 사용해 다운로드의 진행률을 모니터링하세요.

업데이트 테스트

개발 중에는 로컬 패키지를 사용해서만 업데이트 가용성을 테스트할 수 있습니다.
  1. 업데이트 검사 및 다운로드 코드가 있는 V1 패키지를 만듭니다.
  2. 동일한 identity를 가지되 버전 번호가 증가된 V2 패키지를 만듭니다.
  3. xbapp/wdapp install V1을 실행합니다.
  4. xbapp/wdapp update V2 /a를 실행합니다.
  5. V1을 실행합니다.
패키지 간에 content ID가 일치하는지 확인합니다. 이 프로세스의 결과로 V1의 XStoreQueryGameAndDlcPackageUpdatesAsync 또는 XStoreQueryPackageUpdatesAsync 호출이 사용 가능한 업데이트를 찾고 XStoreDownloadAndInstallPackageUpdatesAsync가 광고된 V2 패키지를 사용하여 V1을 업데이트합니다. V2 “다운로드”가 진행 중일 때 이 상태는 XBOX 다운로드 큐, XBOX 앱 또는 Microsoft Store 앱에 큐의 항목으로 표시됩니다. 설치가 완료되면 V2가 설치됩니다. xbapp/wdapp list[dlc]를 사용하여 설치를 확인할 수 있습니다. /a 대신 /m을 사용하면 업데이트가 “mandatory(필수)“로 표시되며, 이는 단순히 XStorePackageUpdate.isMandatory 필드에 영향을 줍니다. 서명 차이로 인해 개발 빌드에서 스토어에서 다운로드되는 패키지로 업데이트할 수 없습니다. 효율적인 업데이트를 만들고 다양한 방법으로 테스트하는 방법에 대한 자세한 내용은 다음 섹션에서 참조하는 콘텐츠 업데이트 페이지를 참고하세요.

참조 API 문서

참고

커머스 개요 XStore 개발 및 테스트 활성화 콘텐츠 업데이트 모범 사례 콘텐츠 업데이트 만들기, 검토, 테스트 XStore API 참조
마지막 수정일 2026년 8월 24일