이 페이지는 Cloud Translation API를 통해 번역되었습니다.

설치 프로그램 게시

이 문서에서는 게임 설치 프로그램을 사용하여 PC용 Google Play 게임즈에 게임을 게시하는 방법을 보여줍니다.

개발자 설치 흐름에서는 개발자가 제공하는 게임 설치 프로그램이 게임의 설치, 업데이트, 제거를 관리해야 합니다.

시작하기 전에

게임을 WAB 파일로 패키징

PC용 Google Play 게임즈를 사용하려면 게임의 설치 프로그램을 Windows App Bundle (WAB) 파일로 Google Play Console에 업로드해야 합니다. WAB 파일을 만들려면 다음 단계를 따르세요.

Play 게시 도구를 다운로드합니다. Windows 명령줄 또는 PowerShell에서 이 도구를 실행할 수 있습니다.
원하는 이름으로 Play 게시 구성 파일을 만듭니다. 예를 들어 다음 형식의 play_publishing_config.xml가 있습니다.
```
<?xml version="1.0" encoding="UTF-8"?>
<play-publishing-config version="1.0">
  <application>
    <package-name>PACKAGE_NAME</package-name>
    <version-name>VERSION_NAME</version-name>
  </application>
  <installer requiresElevation=INSTALLER_REQUIRES_ELEVATION>
    <path>INSTALLER_PATH</path>
    <installation-path-registry-location>
      <key-name>UNIQUE_REGISTRY_PATH</key-name>
      <value-name>InstallLocation</value-name>
    </installation-path-registry-location>
  </installer>
  <launcher requiresElevation=LAUNCHER_REQUIRES_ELEVATION>
    <launch-path-registry-location>
      <key-name>UNIQUE_REGISTRY_PATH</key-name>
      <value-name>InstallLocation</value-name>
    </launch-path-registry-location>
    <executable-invocation>
      <filename>RELATIVE_PATH_TO_LAUNCHER_EXE</filename>
      <arguments>LAUNCHER_ARGS_IF_ANY</arguments>
    </executable-invocation>
  </launcher>
  <uninstaller requiresElevation=UNINSTALLER_REQUIRES_ELEVATION>
    <uninstall-path-registry-location>
      <key-name>UNIQUE_REGISTRY_PATH</key-name>
      <value-name>UninstallString</value-name>
    </uninstall-path-registry-location>
  </uninstaller>
</play-publishing-config>
```
다음을 바꿉니다.
- PACKAGE_NAME: 게임의 패키지 이름입니다. Google Play에서 게임과 연결될 고유 식별자입니다. 예: com.yourcompany.yourgame 패키지 이름은 다음 규칙을 준수해야 합니다.
  - 애플리케이션 ID는 두 개 이상의 세그먼트(한 개 이상의 점)로 구성해야 합니다.
  - 각 세그먼트는 문자로 시작해야 합니다.
  - 모든 문자는 영숫자 또는 밑줄 ([a-zA-Z0-9_])이어야 합니다.
- VERSION_NAME: 게임의 버전 문자열입니다. 임의의 문자열일 수 있지만 게임에 업로드된 모든 WAB에서 고유해야 합니다. 예: 1.0, 1.0.1-beta, 2025.11.24, v1.rc1
  - INSTALLER_REQUIRES_ELEVATION: 설치 프로세스를 완료하기 위해 설치 프로그램 실행 파일을 관리자로 실행해야 하는지 나타냅니다.
    - 'true': 실행 파일을 관리자로 실행합니다.
    경고: 게이머에게 UAC 프롬프트를 표시합니다.
    - 'false': 실행 파일을 현재 사용자로 실행합니다.
  - INSTALLER_PATH: WAB 내 설치 프로그램 파일의 경로입니다. 이 경로는 Play 게시 구성의 상위 디렉터리에 대해 절대적이거나 상대적일 수 있습니다. 예로 path\to\test\installer를 들 수 있습니다. Authenticode 및 코드 서명을 사용하여 게임의 설치 프로그램 실행 파일에 서명해야 합니다.
  - UNIQUE_REGISTRY_PATH: 모든 레지스트리 정보가 포함될 루트 키입니다. 사용자 컴퓨터 전체에서 고유해야 합니다. HKLM을 기준으로 하는 상대 경로입니다. SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName를 예로 들 수 있습니다. 이 항목은 64비트 Windows 11 머신에서 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName 아래에 루트 키를 만듭니다.
  - LAUNCHER_REQUIRES_ELEVATION: 런처 또는 게임 실행 파일을 실행할 때마다 관리자로 실행해야 하는지 여부를 나타냅니다.
    - 'true': 실행 파일을 관리자로 실행합니다.
    경고: 게이머에게 UAC 프롬프트를 표시합니다.
    - 'false': 실행 파일을 현재 사용자로 실행합니다.
  - RELATIVE_PATH_TO_LAUNCHER_EXE: 설치 디렉터리 내 런처 또는 게임 실행 파일의 경로입니다. 여기에는 런처 또는 게임 실행 파일 이름이 포함되어야 합니다. 예를 들어 런처 또는 게임 파일의 이름이 mygame.exe이고 {INSTALL_DIR}\Resources\mygame.exe에 있는 경우 Resources\mygame.exe를 입력해야 합니다.
  - LAUNCHER_ARGS_IF_ANY: 런처나 게임에 전달해야 하는 명령줄 인수입니다. 이 항목은 선택사항입니다.
    - 실행 파일과 연결된 인수가 여러 개인 경우 공백으로 구분해야 합니다.
    - 실행 파일에 필요한 경우 인수 앞에 '--' 또는 '-'를 추가해야 합니다.
  - UNINSTALLER_REQUIRES_ELEVATION: 제거 프로세스를 완료하기 위해 제거 프로그램 실행 파일을 관리자로 실행해야 하는지 나타냅니다.
    - 'true': 실행 파일을 관리자로 실행합니다.
    경고: 게이머에게 UAC 프롬프트를 표시합니다.
    - 'false': 실행 파일을 현재 사용자로 실행합니다.
Play 게시 구성 파일 예시

게임 설치 프로그램 game_installer.exe, 게임의 런처 launcher.exe이 있는 MyGame이라는 게임을 고려해 보세요. 이 예에서는 CDATA를 사용하는 방법도 보여줍니다. play_publishing_config.xml는 다음과 같이 표시됩니다.
```
<?xml version="1.0" encoding="UTF-8"?>

<play-publishing-config version="1.0">
  <application>
    <package-name>com.mycompany.mygame</package-name>
    <version-name>1.0.0</version-name>
  </application>
  <installer requiresElevation="true">
    <path>game_installer.exe</path>
    <installation-path-registry-location>
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
      <value-name>InstallLocation</value-name>
    </installation-path-registry-location>
  </installer>

  <launcher requiresElevation="true">
    <launch-path-registry-location >
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
      <value-name>InstallLocation</value-name>
    </launch-path-registry-location>
    <executable-invocation>
      <filename>launcher.exe</filename>
      <arguments><![CDATA[arg1&arg2>arg3]]></arguments>
    </executable-invocation>
  </launcher>

  <uninstaller requiresElevation="true">
    <uninstall-path-registry-location>
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
      <value-name>UninstallString</value-name>
    </uninstall-path-registry-location>
  </uninstaller>
</play-publishing-config>
```
Windows 명령줄 또는 PowerShell에서 Play 게시 도구를 실행합니다.
```
playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH
```
이름이 같은 기존 WAB 파일을 덮어쓰려면 --force 인수를 사용하세요.
```
playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH --force
```
다음을 바꿉니다.
- PLAY_PUBLISHING_CONFIG_PATH: Play 게시 구성의 경로입니다. 예: path\to\play_publishing_config.xml
- WAB_OUTPUT_PATH: WAB 파일의 경로입니다. 예: path\to\output_bundle.wab
중요: --output의 WAB 파일 이름에는 .wab 확장자가 있어야 합니다.

참고: --input 및 --output 경로는 절대적이거나 현재 작업 디렉터리를 기준으로 할 수 있습니다.
Play 게시 도구 사용 방법

현재 작업 디렉터리에 Play 게시 도구 바이너리 playpublishingtool.exe, Play 게시 구성 play_publishing_config.xml, 게임 설치 프로그램 game_installer.exe이 있다고 가정해 보겠습니다.

현재 작업 디렉터리는 다음과 같습니다.
```
.\
├── game_installer.exe
├── play_publishing_config.xml
├── playpublishingtool.exe
```
동일한 디렉터리에 installer_bundle.wab이라는 이름의 WAB를 만들려면 명령어는 다음과 같습니다.
```
playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab
```
--force 인수를 사용하면 명령어는 다음과 같습니다.
```
playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab --force
```
성공하면 다음과 비슷한 출력이 표시됩니다.
```
Successfully built the installer bundle at installer_bundle.wab
```
폴더에서 WAB 파일을 찾습니다.
```
  .\
  ├── game_installer.exe
  ├── installer_bundle.wab
  ├── play_publishing_config.xml
  ├── playpublishingtool.exe
```

Play Console을 사용하여 게임 게시

게임의 WAB를 성공적으로 만든 후 Play Console에 업로드하고 설정과 요구사항을 관리합니다. 다음 단계에 따라 게임을 게시하세요.

PC용 Google Play 게임즈 폼 팩터 추가

이 단계는 게임을 처음 게시할 때만 필요합니다.

Play Console의 왼쪽 메뉴에서 테스트 및 출시 > 설정 > 고급 설정을 선택합니다 (바로가기).
폼 팩터 탭으로 이동하여 + 폼 팩터 추가 드롭다운에서 Google Play Games on PC를 추가합니다.

참고: 폼 팩터 탭에서 PC용 Google Play 게임즈에 액세스할 수 없는 경우 Play 파트너에게 문의하여 계정을 허용 목록에 추가할 수 있습니다.
오른쪽에 있는 PC용 Google Play 게임즈 폼 팩터에 해당하는 관리 버튼을 클릭합니다.
Windows App Bundle 게임에 전용 트랙 사용 옵션을 선택합니다.
저장을 클릭한 다음 확인 대화상자에서 저장을 다시 클릭합니다.

관리형 게시 사용 설정하기

관리형 게시를 사용 설정하려면 다음 단계를 따르세요.

게시 개요 페이지의 관리형 게시 섹션에서 관리형 게시 켜기를 클릭합니다.
대화상자가 나타납니다. 트랙을 관리형 게시 사용으로 전환합니다.
저장을 클릭합니다.

WAB 파일 업로드

WAB 파일을 업로드하려면 다음 단계를 따르세요.

Play Console의 왼쪽 메뉴에서 테스트 및 출시 > 고급 설정을 선택합니다 (바로가기).
고급 설정 페이지에서 폼 팩터 탭을 클릭합니다.
폼 팩터 탭에서 + 폼 팩터 추가를 클릭하고 PC용 Google Play 게임즈를 선택하여 추가합니다.
PC용 Google Play 게임즈 섹션에서 관리를 클릭합니다.
Windows App Bundle 게임에 전용 트랙 사용을 선택합니다.
저장을 클릭합니다.
Play Console의 왼쪽 메뉴에서 테스트 및 출시 > 프로덕션 (바로가기)을 선택합니다.
프로덕션 페이지의 폼 팩터 드롭다운에서 PC용 Google Play 게임즈 (Windows)만을 선택합니다.
Windows 앱 번들 탭에서 수정을 클릭하고 WAB 파일을 업로드합니다.

Windows PC 요구사항 구성

Windows PC 요구사항을 구성하려면 다음 단계를 따르세요.

Play Console의 왼쪽 메뉴에서 사용자 늘리기 > 앱 정보 > 스토어 설정을 선택합니다 (바로가기 링크).
PC 요구사항 섹션에서 오른쪽의 수정 버튼을 클릭합니다.
필드를 업데이트하고 저장을 클릭합니다.

인앱 구매 그래픽 구성

이 단계는 선택사항입니다. 인앱 구매 그래픽을 구성하려면 다음 단계를 따르세요.

Play Console의 왼쪽 메뉴에서 사용자 늘리기 > 앱 정보 > 스토어 등록정보(바로가기)를 선택합니다.
등록정보 탭의 기본 스토어 등록정보 섹션에서 오른쪽에 있는 -> (화살표) 버튼을 클릭합니다. 그러면 기본 스토어 등록정보 페이지로 이동합니다.
PC용 Google Play 게임즈 섹션으로 이동하여 PC용 Google Play 게임즈 (Windows) 인앱 구매 그래픽에 이미지를 업로드합니다.
저장을 클릭합니다.

검토를 위해 변경사항 전송

Play Console의 왼쪽 메뉴에서 게시 개요를 선택합니다.
전송하여 검토받지 않은 변경사항 섹션에서 변경사항을 전송하여 검토받기를 클릭합니다.

검토팀에서 변경사항을 승인하면 게임이 Google Play에 표시됩니다.

설치 프로그램 게시 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

시작하기 전에

게임을 WAB 파일로 패키징

Play 게시 구성 파일 예시

Play 게시 도구 사용 방법

Play Console을 사용하여 게임 게시

PC용 Google Play 게임즈 폼 팩터 추가

관리형 게시 사용 설정하기

WAB 파일 업로드

Windows PC 요구사항 구성

인앱 구매 그래픽 구성

검토를 위해 변경사항 전송

설치 프로그램 게시