Làm quen với Dịch vụ trò chơi của Play dành cho C++ trên Android

Hướng dẫn dành cho nhà phát triển này sẽ hướng dẫn bạn cách biên dịch và chạy trò chơi C++ trên Android bằng API Dịch vụ trò chơi của Google Play. Trước khi bắt đầu, hãy tải xuống và định cấu hình các yêu cầu sau:

Hướng dẫn dành cho nhà phát triển này sử dụng Bộ phát triển mã gốc Android (NDK). Nếu bạn chưa quen với NDK, hãy tham khảo tài liệu và mẫu NDK trước khi tiếp tục.

Bước 1: Thiết lập môi trường

  1. Tải SDK Android và Android NDK xuống rồi giải nén vào máy của bạn. Trong môi trường của bạn, hãy đặt SDK_ROOT thành vị trí của thư mục SDK Android và NDK_ROOT thành vị trí của thư mục Android NDK.
  2. Tải các trò chơi mẫu C++ xuống. Hướng dẫn dành cho nhà phát triển này gọi vị trí của các mẫu trên máy là SAMPLES_DIR.
  3. Tải SDK C++ của dịch vụ Google Play Games. Giải nén SDK vào máy phát triển. Trong môi trường của bạn, hãy đặt biến NDK_MODULE_PATH để trỏ đến thư mục ở phía trên thư mục gpg-cpp-sdk. Bạn sẽ có cấu trúc thư mục sau: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Mở Eclipse. Nếu bạn chưa thực hiện việc này, hãy cho Eclipse biết vị trí bạn đã cài đặt NDK bằng cách nhấp vào Preferences (Lựa chọn ưu tiên) > Android > NDK.

  5. Nhập dự án thư viện Dịch vụ Google Play vào không gian làm việc Eclipse.

    1. Trong Eclipse, hãy nhấp vào File > Import > Android > Existing Android Code into Workspace (Tệp > Nhập > Android > Mã Android hiện có vào không gian làm việc).
    2. Chọn SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib, trong đó SDK_ROOT là vị trí của SDK Android.
    3. Nhấp vào Hoàn tất.

  6. Nhập dự án mẫu tối giản vào không gian làm việc Eclipse.

    1. Trong Eclipse, hãy nhấp vào File > Import > Android > Existing Android Code into Workspace (Tệp > Nhập > Android > Mã Android hiện có vào không gian làm việc).
    2. Chọn SAMPLES_DIR/samples-android/minimalist.
    3. Nhấp vào Hoàn tất.

  7. Nhấp chuột phải vào dự án MinimalistActivity rồi nhấp vào Properties (Thuộc tính). Trong phần Android, hãy di chuyển xuống phần Thư viện và đảm bảo dự án google-play-services_lib được tham chiếu chính xác. Nếu không, hãy xoá tệp đối chiếu rồi thêm lại tệp đó vào không gian làm việc của bạn.

Eclipse sẽ tự động biên dịch các nguồn Java và Android của dự án; tuy nhiên, bạn cần biên dịch riêng mã gốc trong thư mục jni. Để thực hiện việc này theo cách thủ công, hãy chuyển đến thư mục jni và chạy ndk-build. Hãy nhớ thực hiện việc này sau khi bạn thực hiện bất kỳ thay đổi nào trong thư mục jni.

Lúc này, dự án của bạn sẽ biên dịch, mặc dù chưa hoạt động. Trước tiên, bạn phải định cấu hình trò chơi trong Google Play Console.

Bước 2: Thiết lập trò chơi trong Google Play Console

Tạo một mục nhập cho trò chơi của bạn trong Google Play Console. Thao tác này sẽ bật Dịch vụ trò chơi cho ứng dụng của bạn và tạo mã ứng dụng khách OAuth 2.0 nếu bạn chưa có.

  1. Tạo mục nhập cho trò chơi của bạn bằng cách làm theo các bước mô tả trong phần Thiết lập Dịch vụ trò chơi của Google Play.
  2. Trong AndroidManifest.xml, hãy thay đổi thuộc tính package của thẻ <manifest> thành tên gói mà bạn đã chọn khi thiết lập Google Play Console. Bạn có thể phải sửa một số tệp tham chiếu trong dự án sau khi thực hiện thay đổi này (đặc biệt là đối với lớp R đã tạo).
  3. Mở res/values/ids.xml và đặt Mã ứng dụng của bạn vào đó. Xin lưu ý rằng Mã ứng dụng không giống với mã ứng dụng khách; đó là con số bên cạnh tên trò chơi của bạn trong trang Thông tin chi tiết về trò chơi của Google Play Console.

Bước 3: Chạy mẫu

Để chạy mẫu này, bạn sẽ cần một thiết bị Android thực hoặc một trình mô phỏng đã cài đặt Dịch vụ Google Play:

  1. Chạy ndk-build để biên dịch mã gốc.
  2. Trong Eclipse, hãy nhấp vào Run > Run As > Android Application (Chạy > Chạy dưới dạng > Ứng dụng Android) rồi chạy mẫu trên thiết bị.
  3. Khi mẫu mở ra, hãy nhấn vào vị trí bất kỳ trên màn hình. Bạn sẽ thấy biểu trưng Google Play Games xuất hiện. Nếu đã thiết lập ứng dụng đúng cách, bạn sẽ được nhắc đăng nhập.

Không bắt buộc: Tự động tạo bản dựng bằng Eclipse

Các bước sau đây cho bạn biết cách định cấu hình Eclipse để tự động chạy ndk-build khi bạn thực hiện thay đổi đối với các tệp trong thư mục jni.

  1. Nhấp chuột phải vào dự án MinimalistActivity rồi nhấp vào Properties (Thuộc tính). Trong cửa sổ Properties (Thuộc tính), chọn ngăn Builders (Trình tạo).
  2. Nhấp vào New (Mới) để thêm một Trình tạo mới, rồi chọn Program (Chương trình) rồi nhấp vào OK.
  3. Trong trường Name (Tên), hãy nhập "NDK Builder".
  4. Trong mục Vị trí, hãy nhấp vào Duyệt qua hệ thống tệp rồi chuyển đến thư mục NDK_ROOT và chọn lệnh ndk-build.
  5. Trong Working Directory (Thư mục đang hoạt động), hãy nhấp vào Browse Workspace (Duyệt qua không gian làm việc) rồi chọn thư mục dự án MinimalistActivity.
  6. Nhấp vào thẻ Làm mới. Đảm bảo bạn đã đánh dấu vào hộp Refresh resources upon completion (Tải lại tài nguyên khi hoàn tất).
  7. Chọn nút chọn Tài nguyên cụ thể, sau đó nhấp vào Chỉ định tài nguyên. Trong hộp thoại thu được, hãy chọn thư mục jni trong MinimalActivity.
  8. Nhấp vào Apply (Áp dụng) rồi nhấp vào OK để hoàn tất việc tạo Trình tạo.

Giờ đây, mỗi khi bạn chỉnh sửa một tệp trong thư mục jni, Eclipse sẽ chạy ndk-build và in kết quả vào Eclipse Console.