Trang này được dịch bởi Cloud Translation API.

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

Tài liệu này hướng dẫn bạn cách xuất bản 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 do nhà phát triển cài đặt, 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 Google Play Games SDK vào trò chơi của bạn.

Đó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 của 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:

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.
Tạo tệp cấu hình phát hành trên Play bằng tên bất kỳ. Ví dụ: play_publishing_config.xml có định dạng như 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ế nội dung sau:
- PACKAGE_NAME: Tên gói của trò chơi. Đây là giá trị 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. Ví dụ: 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 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 của trình cài đặt có cần chạy dưới dạng 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 Quản trị viên.
    Cảnh báo: Hiển thị lời nhắc UAC cho người chơi.
    - "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 của trình cài đặt trò chơi.
  - UNIQUE_REGISTRY_PATH: Khoá gốc sẽ chứa tất cả thông tin đăng ký của bạn. Giá trị này phải là duy nhất trên máy của người dùng. Đây sẽ là đường dẫn tương đối ở trên cùng của HKLM. Ví dụ: SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName. Mục này sẽ tạo một khoá gốc trong HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName trên máy chạy Windows 11 64 bit.
  - 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 Quản trị viên mỗi khi được chạy hay không.
    - "true": Chạy tệp thực thi với tư cách Quản trị viên.
    Cảnh báo: Hiển thị lời nhắc UAC cho người chơi.
    - "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. Bạn phải thêm tên tệp thực thi của trình chạy hoặc trò chơi vào đây. Ví dụ: nếu tệp trình chạy hoặc tệp 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. Bạn không bắt buộc phải nhập thông tin này.
    - Trong trường hợp có nhiều đối số 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.
    - Các đối số cần được thêm tiền tố "--" hoặc "-", nếu tệp thực thi yêu cầu.
  - UNINSTALLER_REQUIRES_ELEVATION: Cho biết liệu tệp thực thi của trình gỡ cài đặt có cần chạy với tư cách 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 Quản trị viên.
    Cảnh báo: Hiển thị lời nhắc UAC cho người chơi.
    - "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 xem xét 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>
    <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>
```
Chạy công cụ xuất bản của 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 dùng đối số --force.
```
playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH --force
```
Thay thế nội dung sau:
- PLAY_PUBLISHING_CONFIG_PATH: Đường dẫn đến cấu hình xuất bản trên Play. Ví dụ: path\to\play_publishing_config.xml.
- WAB_OUTPUT_PATH: Đường dẫn đến tệp WAB. Ví dụ: path\to\output_bundle.wab.
Quan trọng: Tên tệp WAB trong --output phải có đuôi .wab.

Lưu ý: Đường dẫn --input và --output có thể là đường dẫn tuyệt đối hoặc tương đối so với thư mục đang hoạt động hiện tại.
Cách sử dụng công cụ xuất bản của Play

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

Thư mục làm việc hiện tại của bạn sẽ có dạng như sau:
```
.\
├── game_installer.exe
├── play_publishing_config.xml
├── playpublishingtool.exe
```
Để tạo một WAB có tên là 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
```
Nếu 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 bạn tạo thành công WAB cho trò chơi, hãy tải WAB đó lên Play Console và quản lý các chế độ cài đặt cũng như yêu cầu của WAB. Làm theo các bước để xuất bản trò chơi:

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

Bạn chỉ cần thực hiện bước này trong lần đầu tiên xuất bản trò chơi.

Trong Play Console, trên trình đơn bên trái, hãy chọn Kiểm thử và phát hành > Thiết lập > Cài đặt nâng cao (đường liên kết trực tiếp).
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.

Lưu ý: Nếu không truy cập được Google Play Games trên máy tính trong thẻ hệ số hình dạng, bạn có thể liên hệ với các đối tác của Play để đưa tài khoản của bạn vào danh sách cho phép.
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.
Chọn mục Dùng một kênh chuyên dụng cho trò chơi trong gói ứng dụng Windows.
Nhấp vào Lưu rồi nhấp vào Lưu một lần nữa trên hộp thoại xác nhận.

Bật chế độ 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.

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 chế độ xuất bản có quản lý.
Một hộp thoại sẽ xuất hiện. Chuyển sang chế độ Xuất bản có quản lý đang bật cho kênh.
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:

Trong Play Console, trên trình đơn bên trái, hãy chọn Kiểm thử và phát hành > Cài đặt nâng cao (đường liên kết trực tiếp).
Trong trang Cài đặt nâng cao, hãy nhấp vào thẻ Hệ số hình dạng.
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.
Trong phần Google Play Games trên máy tính, hãy nhấp vào Quản lý.
Chọn Dùng một kênh chuyên dụng cho trò chơi trong gói ứng dụng Windows.
Nhấp vào Lưu.
Trong Play Console, trên trình đơn bên trái, hãy chọn Kiểm thử và phát hành > Bản phát hành công khai (đường liên kết trực tiếp).
Trên trang Phát hành công khai, hãy chọn Chỉ Google Play Games trên máy tính (Windows) trong trình đơn thả xuống về hệ số hình dạng.
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.

Định cấu hình các yêu cầu đối với máy tính Windows

Cách định cấu hình các yêu cầu đối với máy tính Windows:

Trong Play Console, trên trình đơn bên trái, hãy chọn Tăng số lượng người dùng > Sự hiện diện trong Cửa hàng Play > Cài đặt cửa hàng (đường liên kết trực tiếp).
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.
Cập nhật các trường rồi nhấp vào Lưu.

Định cấu hình 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 định cấu hình hình ảnh về giao dịch mua hàng trong ứng dụng:

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 Play > Trang thông tin trên Cửa hàng Play(đường liên kết trực tiếp).
Trong mục Trang thông tin mặc định trên Cửa hàng Play trong 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.
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).
Nhấp vào Lưu.

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

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.
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 của bạn, người dùng sẽ có thể tìm thấy trò chơi của bạn trên Google Play.

Phát hành trình cài đặt Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Trước khi bắt đầu

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

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

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

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

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

Bật chế độ Xuất bản có quản lý

Tải tệp WAB lên

Định cấu hình các yêu cầu đối với máy tính Windows

Định cấu hình hình ảnh về tính năng mua hàng trong ứng dụng

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

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