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:
- Android NDK, Revisi 14 atau yang lebih tinggi.
- Android SDK v10 atau yang lebih tinggi dan versi terbaru Eclipse ADT.
- Perangkat harus menjalankan Android 4.0 (API level 14) atau yang lebih baru.
- Versi terbaru SDK layanan Google Play.
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
- Download Android SDK dan Android NDK, lalu ekstrak ke mesin Anda. Di
lingkungan, setel
SDK_ROOT
ke lokasi folder Android SDK danNDK_ROOT
ke lokasi lokasi folder Android NDK Anda. - Download contoh game C++. Ini
panduan developer mengacu pada lokasi sampel di komputer Anda sebagai
SAMPLES_DIR
. - 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 direktorigpg-cpp-sdk
. Anda harus memiliki struktur direktori:NDK_MODULE_PATH/ gpg-cpp-sdk/
- Buka Eclipse. Jika belum melakukannya, beri tahu Eclipse tempat Anda menginstal NDK dengan mengklik Preferences > Android > NDK baru.
Impor project library layanan Google Play ke ruang kerja Eclipse Anda.
- Di Eclipse, klik File > Impor > Android > Kode Android yang Ada ke dalam Workspace.
- Pilih
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
denganSDK_ROOT
adalah lokasi Android SDK Anda. - Klik Selesai.
Impor project contoh minimalis ke ruang kerja Eclipse Anda.
- Di Eclipse, klik File > Impor > Android > Kode Android yang Ada ke dalam Workspace.
- Pilih
SAMPLES_DIR/samples-android/minimalist
. - Klik Selesai.
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.
- Buat entri untuk game Anda dengan mengikuti langkah-langkah yang dijelaskan di Menyiapkan Layanan game Google Play.
- Di
AndroidManifest.xml
, ubah atributpackage
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 classR
yang dihasilkan). - 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:
- Jalankan
ndk-build
untuk mengompilasi kode native. - Di Eclipse, klik Run > Jalankan Sebagai > Aplikasi Android dan jalankan contoh di perangkat Anda.
- 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
.
- Klik kanan project MinimalistActivity, lalu klik Properties. Di jendela {i>Properties<i}, pilih panel Builders.
- Klik New untuk menambahkan Builder baru dan pilih Program, lalu klik OK.
- Di kolom Name, masukkan 'NDK Builder'.
- Di bagian Location, klik Browse File System, buka direktori
NDK_ROOT
, lalu pilih perintahndk-build
. - Di bagian Working Directory, klik Browse Workspace, lalu pilih MinimalistActivity folder project.
- Klik tab Refresh. Pastikan kotak Muat ulang resource setelah selesai dicentang.
- Pilih tombol pilihan Specific resources, lalu klik Tentukan Resource. Di kolom
dialog yang dihasilkan, pilih folder
jni
di bawah MinimalActivity. - 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.