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

Trước khi bắt đầu

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 một trò chơi C++ trên Android sử dụng API Dịch vụ trò chơi của Google Play. Trước khi bắt đầu, hãy tải các yêu cầu sau xuống và thiết lập như sau:

Hướng dẫn dành cho nhà phát triển này sử dụng Android Native Development Kit (NDK). Nếu bạn chưa hiểu rõ về NDK, hãy tham khảo tài liệu và mẫu của 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, sau đó giải nén sang máy của bạn. Trong môi trường, hãy đặt SDK_ROOT thành vị trí của thư mục SDK Android và NDK_ROOT thành vị trí 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 tham chiếu đến vị trí của các mẫu trên máy của bạn dưới dạng SAMPLES_DIR.
  3. Tải SDK C++ của dịch vụ Google Play Games xuống. Trích xuất SDK vào máy phát triển của bạ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 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 Tệp > Nhập > Android > Mã Android hiện có vào Workspace.
    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 Finish (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 Tệp > Nhập > Android > Mã Android hiện có vào Workspace.
    2. Chọn SAMPLES_DIR/samples-android/minimalist.
    3. Nhấp vào Finish (Hoàn tất).

  7. Nhấp chuột phải vào dự án MinimalistActivity và nhấp vào Properties (Thuộc tính). Trong Android, hãy cuộn xuống phần Library (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 xóa tệp đối chiếu đó và thêm lại khỏi 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, mã gốc trong thư mục jni cần được biên dịch riêng biệt. Để thực hiện việc này theo cách thủ công, hãy chuyển đến thư mục jni rồi 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.

Dự án của bạn hiện đã được biên dịch, mặc dù dự án vẫn chưa hoạt động. Trước tiên, bạn phải định cấu hình trò chơi của mình trong Google Play Console.

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

Tạo một mục cho trò chơi 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ột mục cho trò chơi của bạn bằng cách làm theo các bước đượ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 suốt dự án sau khi thực hiện thay đổi này (đặc biệt là đối với lớp R được tạo).
  3. Mở res/values/ids.xml rồi đặt mã ứng dụng tại đó. Xin lưu ý rằng Mã ứng dụng không giống với mã ứng dụng khách. Đây là mã bên cạnh tên trò chơi của bạn trên trang Chi tiết trò chơi của Google Play Console.

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

Để chạy mẫu này, bạn cần có một thiết bị Android thực hoặc 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 Chạy > Chạy dưới dạng > Ứng dụng Android và chạy mẫu trên thiết bị của bạn.
  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 của Google Play Games xuất hiện. Nếu bạn đã định cấu hình chính xác ứng dụng của mình, bạn sẽ được nhắc đăng nhập.

Không bắt buộc: Tự động xây 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 thay đổi các tệp trong thư mục jni.

  1. Nhấp chuột phải vào dự án MinimalistActivity và nhấp vào Thuộc tính (Properties). Trong cửa sổ Properties (Thuộc tính), hãy chọn ngăn Builders.
  2. Nhấp vào New (Mới) để thêm một Builder có thể tạo mới rồi chọn Program (Chương trình) rồi nhấp vào OK.
  3. Trong trường Tên, hãy nhập "Trình tạo NDK".
  4. Trong mục Location (Vị trí), hãy nhấp vào Browse File System (Duyệt hệ thống tệp) rồi chuyển đến thư mục NDK_ROOT rồi chọn lệnh ndk-build.
  5. Trong Work Directory (Thư mục làm việc), 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ẻ Refresh (Làm mới). Hãy nhớ đánh dấu vào hộp Làm mới tài nguyên sau khi hoàn thành.
  7. Chọn nút chọn Tài nguyên cụ thể rồi nhấp vào Chỉ định tài nguyên. Trong hộp thoại xuất hiện, 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 Builder.

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