Phát hành trình cài đặt

Tài liệu này hướng dẫn cách phát hành trò chơi trên Google Play Games trên máy tính bằng trình cài đặt trò chơi.

Với quy trình Cài đặt do nhà phát triển, trình cài đặt trò chơi mà bạn cung cấp phải quản lý việc cài đặt, cập nhật và gỡ cài đặt trò chơi.

Trước khi bắt đầu

Tích hợp SDK Google Play Games vào trò chơi.

Đóng gói trò chơi dưới dạng tệp WAB

Google Play Games trên máy tính yêu cầu bạn tải trình cài đặt trò chơi lên Google Play Console dưới dạng tệp gói ứng dụng Windows (WAB). Để tạo tệp WAB, hãy làm theo các bước sau:

  1. Tải công cụ xuất bản trên Play xuống. Bạn có thể chạy công cụ này trên dòng lệnh Windows hoặc PowerShell.

  2. Tạo tệp cấu hình xuất bản trên Play bằng bất kỳ tên nào. Ví dụ: play_publishing_config.xml có định dạng sau:

    <?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>

    Thay thế những nội dung sau:

    • PACKAGE_NAME: Tên gói của trò chơi. Đây là mã nhận dạng duy nhất sẽ được liên kết với trò chơi của bạn trên Google Play. Ví dụ: com.yourcompany.yourgame. Tên gói phải tuân thủ các quy tắc sau:
      • Mã ứng dụng phải có ít nhất 2 phân đoạn (gồm một hoặc nhiều dấu chấm).
      • Mỗi phân đoạn phải bắt đầu bằng một chữ cái.
      • Tất cả ký tự phải có dạng chữ-số hoặc dấu gạch dưới ([a-zA-Z0-9_]).

    • VERSION_NAME: Chuỗi phiên bản của trò chơi. Đây có thể là một chuỗi tuỳ ý, nhưng phải là duy nhất trên tất cả các tệp WAB đã tải lên cho trò chơi của bạn. Ví dụ: 1.0, 1.0.1-beta, 2025.11.24, v1.rc1.

      • INSTALLER_REQUIRES_ELEVATION: Cho biết liệu tệp thực thi trình cài đặt có cần chạy với tư cách là Quản trị viên để hoàn tất quy trình cài đặt hay không.

        • "true": Chạy tệp thực thi với tư cách là Quản trị viên.
        • "false": Chạy tệp thực thi với tư cách là người dùng hiện tại.

      • INSTALLER_PATH: Đường dẫn đến tệp trình cài đặt trong WAB. Đường dẫn này có thể là tuyệt đối hoặc tương đối so với thư mục mẹ của cấu hình xuất bản trên Play. Ví dụ: path\to\test\installer. Hãy nhớ sử dụng authenticode và tính năng ký mã để ký tệp thực thi trình cài đặt trò chơi.

      • UNIQUE_REGISTRY_PATH: Đường dẫn khoá đăng ký Windows. Bạn phải cung cấp đường dẫn này tương ứng với một nhóm đăng ký, chẳng hạn như HKEY_LOCAL_MACHINE hoặc HKEY_CURRENT_USER; không đưa tên nhóm vào chuỗi đường dẫn. Ví dụ: nếu trình cài đặt của bạn ghi vào HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName, hãy chỉ định Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName. Google Play Games trên máy tính tìm kiếm đường dẫn này trong nhiều nhóm để xác định vị trí các giá trị cần thiết cho việc khởi chạy và gỡ cài đặt.

        Tệp thực thi được chỉ định trong INSTALLER_PATH phải tạo các khoá đăng ký này. Trước khi quá trình cài đặt hoàn tất, bạn phải tạo các cặp khoá đăng ký và tên giá trị được chỉ định trong installation-path-registry-location, launch-path-registry-location và uninstall-path-registry-location. Mặc dù ví dụ sử dụng InstallLocation và UninstallString, nhưng bạn có thể chỉ định bất kỳ tên nào trong các thẻ <value-name> này, miễn là trình cài đặt của bạn tạo các mục đăng ký tương ứng cho cả ba. Google Play Games trên máy tính sử dụng các giá trị này để khởi chạy và gỡ cài đặt trò chơi. Nếu trò chơi của bạn sử dụng Trình chạy, thì đường dẫn này phải trỏ đến khoá đăng ký chứa thông tin cài đặt cho Trình chạy và giá trị trong mục đăng ký do launch-path-registry-location chỉ định phải trỏ đến thư mục của Trình chạy.

        Đường dẫn này phải là duy nhất trên máy của người dùng. Ví dụ: SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.

        Nếu trình cài đặt trò chơi của bạn là một ứng dụng 32 bit chạy trên Windows 64 bit, thì Windows sẽ sử dụng tính năng chuyển hướng đăng ký để ghi các mục đăng ký trong HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node. Ví dụ: một thao tác ghi vào HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName sẽ được chuyển hướng đến HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.

      • LAUNCHER_REQUIRES_ELEVATION: Cho biết liệu trình chạy hoặc tệp thực thi trò chơi có cần chạy với tư cách là Quản trị viên mỗi khi được khởi chạy hay không.

        • "true": Chạy tệp thực thi với tư cách là Quản trị viên.
        • "false": Chạy tệp thực thi với tư cách là người dùng hiện tại.

      • RELATIVE_PATH_TO_LAUNCHER_EXE: Đường dẫn đến trình chạy hoặc tệp thực thi trò chơi trong thư mục cài đặt. Đường dẫn này phải bao gồm tên tệp thực thi trình chạy hoặc trò chơi. Ví dụ: nếu tệp trình chạy hoặc trò chơi của bạn có tên là mygame.exe và nằm trong {INSTALL_DIR}\Resources\mygame.exe, thì bạn phải đặt Resources\mygame.exe

      • LAUNCHER_ARGS_IF_ANY: Mọi đối số dòng lệnh cần được truyền vào trình chạy hoặc trò chơi của bạn. Mục này là không bắt buộc.

        • Trong trường hợp có nhiều đối số được liên kết với một tệp thực thi, bạn cần phân tách các đối số đó bằng dấu cách.
        • Bạn cần thêm tiền tố '--' hoặc '-' vào các đối số nếu tệp thực thi yêu cầu.

      • UNINSTALLER_REQUIRES_ELEVATION: Cho biết liệu tệp thực thi trình gỡ cài đặt có cần chạy với tư cách là Quản trị viên để hoàn tất quy trình gỡ cài đặt hay không.

        • "true": Chạy tệp thực thi với tư cách là Quản trị viên.
        • "false": Chạy tệp thực thi với tư cách là người dùng hiện tại.

    Ví dụ về tệp cấu hình xuất bản trên Play

    Hãy cân nhắc một trò chơi có tên là MyGame, với trình cài đặt trò chơi game_installer.exe, trình chạy trò chơi launcher.exe. Ví dụ này cũng cho thấy cách sử dụng CDATA. Sau đây là giao diện của play_publishing_config.xml:

    <?xml version="1.0" encoding="UTF-8"?>

<play-publishing-config version="1.0">
  <application>
    <!-- The package name for your game. -->
    <package-name>com.mycompany.mygame</package-name>
    <!-- The game's version string. -->
    <version-name>1.0.0</version-name>
  </application>
  <!-- If requiresElevation is "true", installer runs as Administrator
       and a UAC prompt is displayed. This is required for system-wide
       installs (e.g., to Program Files) or writing to HKLM. -->
  <installer requiresElevation="true">
    <!-- Path to your installer executable. -->
    <path>game_installer.exe</path>
    <!-- The registry location where the installer writes the installation path. -->
    <installation-path-registry-location>
      <!-- Registry key path (typically under HKLM or HKCU).
           game_installer.exe MUST create this key. -->
      <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name>
      <!-- game_installer.exe, specified in <path>, creates the registry
           value called 'InstallLocation' within
           SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey
           by the time it exits. -->
      <value-name>InstallLocation</value-name>
    </installation-path-registry-location>
  </installer>

  <!-- If requiresElevation is "true", launcher runs as Administrator
       and a UAC prompt is displayed on every game launch. -->
  <launcher requiresElevation="true">
    <!-- Specifies the registry location where Google Play Games reads the installation path
         in order to launch the game. -->
    <launch-path-registry-location >
      <!-- Registry key path (typically under HKLM or HKCU) where
           the launch path can be found. -->
      <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name>
      <!-- Google Play Games reads the installation directory from this
           registry value, for example InstallLocation, to launch the game. -->
      <value-name>InstallLocation</value-name>
    </launch-path-registry-location>
    <executable-invocation>
      <!-- Game executable or launcher filename, relative to the
           directory path specified in the InstallLocation registry value. -->
      <filename>launcher.exe</filename>
      <!-- Optional arguments to pass to the executable.
           CDATA is used here to avoid issues with special characters
           like & or >. -->
      <arguments><![CDATA[arg1&arg2>arg3]]></arguments>
    </executable-invocation>
  </launcher>

  <!-- If requiresElevation is "true", uninstaller runs as
       Administrator and a UAC prompt is displayed for uninstall. -->
  <uninstaller requiresElevation="true">
    <!-- Registry key where Google Play Games finds the
         uninstallation command. -->
    <uninstall-path-registry-location>
      <!-- Registry key path (typically under HKLM or HKCU) where
           uninstall command can be found. -->
      <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name>
      <!-- game_installer.exe also creates the registry value, for example, 'UninstallString'
           within SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey,
           containing the command Google Play Games executes to uninstall
           the game. -->
      <value-name>UninstallString</value-name>
    </uninstall-path-registry-location>
  </uninstaller>
</play-publishing-config>

  3. Chạy công cụ xuất bản trên Play trên dòng lệnh Windows hoặc Powershell.

    playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH

    Để ghi đè một tệp WAB hiện có có cùng tên, hãy sử dụng đối số --force.

    playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH --force

    Thay thế những nội dung sau:

    • PLAY_PUBLISHING_CONFIG_PATH: Đường dẫn đến cấu hình xuất bản trên Play. Ví dụ: path\to\play_publishing_config.xml.
    • WAB_OUTPUT_PATH: Đường dẫn đến tệp WAB. Ví dụ: path\to\output_bundle.wab.

    Cách sử dụng công cụ xuất bản trên Play

    Giả sử bạn có tệp nhị phân công cụ xuất bản trên Play playpublishingtool.exe, cấu hình xuất bản trên Play play_publishing_config.xml và trình cài đặt trò chơi game_installer.exe trong thư mục hiện đang xử lý.

    Thư mục hiện đang xử lý của bạn sẽ có dạng như sau:

    .\
├── game_installer.exe
├── play_publishing_config.xml
├── playpublishingtool.exe

    Để tạo một tệp WAB có tên, chẳng hạn như installer_bundle.wab trong cùng một thư mục, lệnh sẽ có dạng như sau:

    playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab

    Với đối số --force, lệnh sẽ có dạng như sau:

    playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab --force

    Khi thành công, bạn sẽ thấy kết quả tương tự như sau:

    Successfully built the installer bundle at installer_bundle.wab

    Tìm tệp WAB trong thư mục:

      .\
  ├── game_installer.exe
  ├── installer_bundle.wab
  ├── play_publishing_config.xml
  ├── playpublishingtool.exe

Phát hành trò chơi bằng Play Console

Sau khi tạo thành công tệp WAB cho trò chơi, hãy tải tệp đó lên Play Console rồi quản lý các chế độ cài đặt và yêu cầu của tệp. Làm theo các bước để phát hành trò chơi:

Thêm hệ số hình dạng Google Play Games trên máy tính

Bạn chỉ cần thực hiện bước này vào lần đầu tiên phát hành trò chơi.

  1. Trong Play Console, trên trình đơn bên trái, hãy chọn Thử nghiệm và phát hành > Thiết lập > Cài đặt nâng cao (đường liên kết trực tiếp).

  2. Chuyển đến thẻ Hệ số hình dạng rồi thêm Google Play Games on PC trong trình đơn thả xuống + Thêm hệ số hình dạng.

  3. Nhấp vào nút Quản lý tương ứng với hệ số hình dạng Google Play Games trên máy tính ở bên phải.

  4. Chọn tuỳ chọn Dùng một kênh chuyên dụng cho trò chơi trong gói ứng dụng Windows.

  5. Nhấp vào Lưu rồi nhấp lại vào Lưu trên hộp thoại xác nhận.

Bật tính năng Xuất bản có quản lý

Để bật tính năng Xuất bản có quản lý, hãy làm theo các bước sau.

  1. Trên trang Tổng quan về việc xuất bản, trong phần Xuất bản có quản lý, hãy nhấp vào Bật tính năng Xuất bản có quản lý.
  2. Một hộp thoại sẽ xuất hiện. Chuyển sang Xuất bản có quản lý đang bật cho kênh.
  3. Nhấp vào Lưu.

Tải tệp WAB lên

Để tải tệp WAB lên, hãy làm theo các bước sau:

  1. Trong Play Console, trên trình đơn bên trái, hãy chọn Thử nghiệm và phát hành > Cài đặt nâng cao (đường liên kết trực tiếp).
  2. Trên trang Cài đặt nâng cao, hãy nhấp vào thẻ Hệ số hình dạng.
  3. Trong thẻ Hệ số hình dạng, hãy nhấp vào + Thêm hệ số hình dạng rồi chọn Google Play Games trên máy tính để thêm.
  4. Trong phần Google Play Games trên máy tính, hãy nhấp vào Quản lý.
  5. Chọn Dùng một kênh chuyên dụng cho trò chơi trong gói ứng dụng Windows.
  6. Nhấp vào Lưu.
  7. Trong Play Console, trên trình đơn bên trái, hãy chọn Thử nghiệm và phát hành > Bản chính thức (đường liên kết trực tiếp).
  8. Trên trang Bản chính thức, hãy chọn Chỉ Google Play Games trên máy tính (Windows) trong trình đơn thả xuống hệ số hình dạng.
  9. Trong thẻ Gói ứng dụng Windows, hãy nhấp vào Chỉnh sửa rồi tải tệp WAB lên.

Thiết lập các yêu cầu đối với máy tính Windows

Cách thiết lập các yêu cầu đối với máy tính Windows:

  1. Trong Play Console, trên trình đơn bên trái, hãy chọn Phát triển người dùng > Sự hiện diện trong cửa hàng > Cài đặt cửa hàng (đường liên kết trực tiếp).
  2. Trong phần Yêu cầu đối với máy tính, hãy nhấp vào nút Chỉnh sửa ở bên phải.
  3. Cập nhật các trường rồi nhấp vào Lưu.

Thiết lập hình ảnh về tính năng mua hàng trong ứng dụng

Đây là bước không bắt buộc. Cách thiết lập hình ảnh về tính năng mua hàng trong ứng dụng:

  1. Trong Play Console, trên trình đơn bên trái, hãy chọn Phát triển người dùng > Sự hiện diện trong cửa hàng > Trang thông tin trên Cửa hàng Play(đường liên kết trực tiếp).
  2. Trong phần Trang thông tin mặc định trên Cửa hàng Play của thẻ Trang thông tin, hãy nhấp vào nút -> (mũi tên) ở bên phải. Thao tác này sẽ đưa bạn đến trang Trang thông tin mặc định trên Cửa hàng Play.
  3. Chuyển đến phần Google Play Games trên máy tính rồi tải hình ảnh lên tại Hình ảnh về tính năng mua hàng trong ứng dụng của Google Play Games trên máy tính (Windows).
  4. Nhấp vào Lưu.

Gửi các thay đổi đi xem xét

  1. Trong Play Console, trên trình đơn bên trái, hãy chọn Tổng quan về việc xuất bản.
  2. Trong phần Các thay đổi chưa được gửi đi xem xét, hãy nhấp vào Gửi các thay đổi đi xem xét.

Khi nhóm Xem xét đã phê duyệt các thay đổi, trò chơi của bạn sẽ có thể được tìm thấy trên Google Play.