Memulai Layanan game Play untuk C++ di Android

Sebelum memulai

Panduan developer ini akan menunjukkan cara mengompilasi dan menjalankan game C++ di Android yang menggunakan Google Play API layanan game. Sebelum memulai, download dan konfigurasi persyaratan berikut:

Panduan developer ini menggunakan Android Native Development Kit (NDK). Jika Anda tidak terbiasa dengan NDK, lihat Dokumentasi dan contoh NDK sebelum melanjutkan.

Langkah 1: Menyiapkan lingkungan

  1. Download Android SDK dan Android NDK, lalu ekstrak ke mesin Anda. Di lingkungan, setel SDK_ROOT ke lokasi folder Android SDK dan NDK_ROOT ke lokasi lokasi folder Android NDK Anda.
  2. Download contoh game C++. Ini panduan developer mengacu pada lokasi sampel di komputer Anda sebagai SAMPLES_DIR.
  3. Download SDK C++ layanan game Google Play. Ekstrak SDK ke mesin pengembangan. Di lingkungan Anda, tetapkan variabel NDK_MODULE_PATH ke arahkan kursor ke direktori di atas direktori gpg-cpp-sdk. Anda harus memiliki struktur direktori: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Buka Eclipse. Jika belum melakukannya, beri tahu Eclipse tempat Anda menginstal NDK dengan mengklik Preferences > Android > NDK baru.

  5. Impor project library layanan Google Play ke ruang kerja Eclipse Anda.

    1. Di Eclipse, klik File > Impor > Android > Kode Android yang Ada ke dalam Workspace.
    2. Pilih SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib dengan SDK_ROOT adalah lokasi Android SDK Anda.
    3. Klik Selesai.

  6. Impor project contoh minimalis ke ruang kerja Eclipse Anda.

    1. Di Eclipse, klik File > Impor > Android > Kode Android yang Ada ke dalam Workspace.
    2. Pilih SAMPLES_DIR/samples-android/minimalist.
    3. Klik Selesai.

  7. Klik kanan project MinimalistActivity, lalu klik Properties. Di bagian Android, scroll ke bagian Library dan pastikan project google-play-services_lib sudah benar yang direferensikan. Jika tidak, hapus referensi tersebut dan tambahkan lagi dari ruang kerja Anda.

Eclipse akan secara otomatis mengompilasi sumber Java dan Android proyek Anda; Namun, kode native di folder jni harus dikompilasi secara terpisah. Untuk melakukannya secara manual, buka folder jni dan jalankan ndk-build. Ingatlah untuk melakukannya setelah Anda membuat perubahan di dalam folder jni.

Sekarang project Anda seharusnya dapat dikompilasi, meskipun belum bisa berfungsi. Anda harus mengonfigurasi game terlebih dahulu di Konsol Google Play.

Langkah 2: Siapkan game di Konsol Google Play

Buat entri untuk game Anda di Konsol Google Play. Tindakan ini mengaktifkan Layanan game untuk aplikasi, dan membuat ID klien OAuth 2.0, jika belum memilikinya.

  1. Buat entri untuk game Anda dengan mengikuti langkah-langkah yang dijelaskan di Menyiapkan Layanan game Google Play.
  2. Di AndroidManifest.xml, ubah atribut package dari tag <manifest> menjadi nama paket yang Anda pilih saat menyiapkan Konsol Google Play. Anda mungkin harus memperbaiki beberapa referensi selama project setelah melakukan perubahan ini (khususnya untuk class R yang dihasilkan).
  3. Buka res/values/ids.xml dan tempatkan ID Aplikasi Anda di sana. Perhatikan bahwa App ID tidak sama dengan ID klien; itu adalah angka di samping nama game Anda pada halaman Detail Game pada Konsol Google Play.

Langkah 3: Jalankan contoh

Untuk menjalankan contoh, Anda memerlukan perangkat Android fisik atau emulator dengan Layanan Google Play yang terinstal:

  1. Jalankan ndk-build untuk mengompilasi kode native.
  2. Di Eclipse, klik Run > Jalankan Sebagai > Aplikasi Android dan jalankan contoh di perangkat Anda.
  3. Saat sampel terbuka, ketuk di mana saja pada layar. Anda akan melihat logo Google Play Game akan muncul. Jika telah mengonfigurasi aplikasi dengan benar, Anda akan diminta untuk login.

Opsional: Membangun Secara Otomatis dengan Eclipse

Langkah-langkah berikut menunjukkan cara mengonfigurasi Eclipse agar otomatis menjalankan ndk-build saat Anda membuat perubahan pada file di folder jni.

  1. Klik kanan project MinimalistActivity, lalu klik Properties. Di jendela {i>Properties<i}, pilih panel Builders.
  2. Klik New untuk menambahkan Builder baru dan pilih Program, lalu klik OK.
  3. Di kolom Name, masukkan 'NDK Builder'.
  4. Di bagian Location, klik Browse File System, buka direktori NDK_ROOT, lalu pilih perintah ndk-build.
  5. Di bagian Working Directory, klik Browse Workspace, lalu pilih MinimalistActivity folder project.
  6. Klik tab Refresh. Pastikan kotak Muat ulang resource setelah selesai dicentang.
  7. Pilih tombol pilihan Specific resources, lalu klik Define Resources. Di kolom dialog yang dihasilkan, pilih folder jni di bawah MinimalActivity.
  8. Klik Apply, lalu OK untuk menyelesaikan pembuatan Builder Anda.

Sekarang, setiap kali Anda mengedit file dalam folder jni, Eclipse akan menjalankan ndk-build dan mencetak ke Konsol Eclipse.