Sebelum memulai
Panduan developer ini akan menunjukkan cara mengompilasi dan menjalankan game C++ di Android yang menggunakan Google Play Game Services API. Sebelum memulai, download dan konfigurasikan persyaratan berikut:
- Android NDK, Revisi 14 atau yang lebih baru.
- Android SDK v10 atau yang lebih tinggi dan versi terbaru ADT ADT.
- Perangkat harus menjalankan Android 4.0 (API level 14) atau yang lebih tinggi.
- Versi terbaru SDK layanan Google Play.
Panduan developer ini menggunakan Android Native Development Kit (NDK). Jika Anda belum terbiasa dengan NDK, baca dokumentasi dan contoh NDK sebelum melanjutkan.
Langkah 1: Siapkan lingkungan Anda
- Download Android SDK dan Android NDK lalu ekstrak ke mesin Anda. Di lingkungan
Anda, tetapkan
SDK_ROOT
ke lokasi folder Android SDK danNDK_ROOT
ke lokasi folder Android NDK. - Download contoh game C++. Panduan
developer ini mengacu pada lokasi sampel di mesin Anda sebagai
SAMPLES_DIR
. - Download C++ SDK layanan Google Play Game. Ekstrak SDK ke mesin pengembangan Anda. Di lingkungan Anda, tetapkan variabel
NDK_MODULE_PATH
untuk mengarah ke direktori di atas direktorigpg-cpp-sdk
. Anda harus memiliki struktur direktori berikut:NDK_MODULE_PATH/ gpg-cpp-sdk/
- Buka Eclipse. Jika Anda belum melakukannya, beri tahu Eclipse tempat Anda menginstal NDK dengan mengklik Preferences > Android > NDK.
Impor project library layanan Google Play ke ruang kerja Eclipse.
- Di Eclipse, klik File > Import > Android > Existing Android Code into Workspace.
- Pilih
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
, denganSDK_ROOT
sebagai lokasi Android SDK Anda. - Klik Finish.
Impor project contoh minimalis ke ruang kerja Eclipse.
- Di Eclipse, klik File > Import > Android > Existing Android Code into Workspace.
- Pilih
SAMPLES_DIR/samples-android/minimalist
. - Klik Finish.
Klik kanan project MinimalistActivity, lalu klik Properties. Di bagian Android, scroll ke bawah ke bagian Library dan pastikan project google-play-services_lib direferensikan dengan benar. Jika tidak, hapus referensi dan tambahkan lagi dari ruang kerja Anda.
Eclipse akan mengompilasi sumber Java dan Android project Anda secara otomatis. Namun, kode native di folder jni
harus dikompilasi secara terpisah. Untuk melakukannya secara manual, buka
folder jni
dan jalankan ndk-build
. Jangan lupa untuk melakukan hal ini setelah Anda membuat perubahan di dalam folder jni
.
Project Anda sekarang harus dikompilasi, meskipun belum 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. Proses ini mengaktifkan layanan Game untuk aplikasi Anda, dan membuat client ID OAuth 2.0, jika Anda belum memilikinya.
- Buat entri untuk game Anda dengan mengikuti langkah-langkah yang dijelaskan dalam Menyiapkan Layanan game Google Play.
- Di
AndroidManifest.xml
, ubah atributpackage
dari tag<manifest>
ke nama paket yang Anda pilih saat menyiapkan Konsol Google Play. Anda mungkin harus memperbaiki beberapa referensi selama project setelah melakukan perubahan ini (khususnya untuk classR
yang dihasilkan). - Buka
res/values/ids.xml
dan tempatkan ID Aplikasi Anda di sana. Perlu diperhatikan bahwa ID Aplikasi tidak sama dengan client ID; ini adalah nomor di samping nama game Anda pada halaman Detail Game di Konsol Google Play.
Langkah 3: Jalankan contoh aplikasi
Untuk menjalankan contoh, Anda memerlukan perangkat Android fisik atau emulator yang menginstal layanan Google Play:
- Jalankan
ndk-build
untuk mengompilasi kode native. - Di Eclipse, klik Run > Run As > Android Application dan jalankan contoh di perangkat Anda.
- Saat sampel terbuka, ketuk di mana saja di layar. Anda akan melihat logo Google Play Game muncul. Jika telah mengonfigurasi aplikasi dengan benar, Anda akan diminta untuk login.
Opsional: Mem-build 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
.
- Klik kanan project MinimalistActivity, lalu klik Properties. Di jendela Properties, pilih panel Builders.
- Klik New untuk menambahkan Builder baru dan pilih Program, lalu klik OK.
- Pada kolom Name, masukkan 'NDK Builder'.
- Di bagian Location, klik Browse File System, lalu buka direktori
NDK_ROOT
dan pilih perintahndk-build
. - Di bagian Working Directory, klik Browse Workspace, lalu pilih folder project MinimalistActivity.
- Klik tab Refresh. Pastikan kotak Refresh resource setelah selesai dicentang.
- Pilih tombol pilihan Resource tertentu, lalu klik Tentukan Resource. Pada
dialog yang dihasilkan, pilih folder
jni
di bagian MinimalActivity. - Klik Apply, lalu OK untuk menyelesaikan pembuatan Builder.
Setiap kali Anda mengedit file dalam folder jni
, Eclipse akan menjalankan ndk-build
dan mencetak output ke Eclipse Console.