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ẽ chỉ cho bạn cách biên dịch và chạy trò chơi C++ trên Android sử dụng Google Play API dịch vụ trò chơi. Trước khi bạn 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ộ công cụ phát triển mã gốc của 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 chúng vào máy của bạn. Trong 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 trò chơi mẫu C++ xuống. Chiến dịch này Hướng dẫn cho nhà phát triển 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++ cho dịch vụ Google Play Games xuống. Trích xuất tệp 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 thành hãy trỏ đến thư mục bên trên thư mục gpg-cpp-sdk. Bạn phải có: cấu trúc thư mục: 
    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 nơi 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 của bạn.

    1. Trong Eclipse, hãy nhấp vào File > Nhập > Android > Đã thêm đoạn 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 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 của bạn.

    1. Trong Eclipse, hãy nhấp vào File > Nhập > Android > Đã thêm đoạn mã Android hiện có vào Workspace.
    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 DarkistActivity, rồi nhấp vào Properties (Thuộc tính). Trong Android, hãy cuộn xuống mục Library (Thư viện) và đảm bảo dự án google-play-services_lib có chính xác tham chiếu. Nếu không, hãy xoá rồi thêm lại tệp đối chiếu đó từ 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 trong dự án của bạn; tuy nhiên, mã gốc trong thư mục jni cần được biên dịch riêng. Để 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ớ làm điều này sau khi bạn thực hiện bất kỳ thay đổi nào bên trong thư mục jni.

Dự án của bạn hiện đã được biên dịch, mặc dù dự án này 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ụ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 và tạo một ID ứ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 bằng cách làm theo các bước được mô tả trong 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 đối chiếu trong toàn bộ dự án sau khi thực hiện thay đổi này (cụ thể 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 đó. Lưu ý rằng ID ứng dụng không giống với mã ứng dụng khách; đó là số bên cạnh tên trò chơi của bạn trên trang Chi tiết trò chơi Google Play Console.

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

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

  1. Chạy ndk-build để biên dịch mã gốc.
  2. Trong Eclipse, nhấp vào Run > (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 một biểu trưng Google Play Games xuất hiện. Nếu đã định cấu hình ứ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 hướng dẫn bạn 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 Tối thiểu hóa và nhấp vào 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 Builder 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 Location (Vị trí), hãy nhấp vào Browse File System (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 phần Work Directory (Thư mục làm việc), hãy nhấp vào Browse Workspace (Duyệt xem không gian làm việc) rồi chọn MinimumActivity (Hoạt động tối thiểu) thư mục dự án.
  6. Nhấp vào thẻ Làm mới. Hãy đảm bảo rằng bạn đã chọn hộp Làm mới tài nguyên sau khi hoàn thành.
  7. Chọn nút radio Specific resource (Tài nguyên cụ thể) rồi nhấp vào Specify Resource (Chỉ định tài nguyên). Trong hộp thoại thu được, chọn thư mục jni trong MinimumActivity.
  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 một tệp trong thư mục jni, Eclipse sẽ chạy ndk-build và in vào Bảng điều khiển Eclipse.