Memulai Layanan game Play untuk C++ di Android

Setelah penghentian penggunaan API Login dengan Google, kami akan menghapus SDK game v1 pada tahun 2026. Setelah Februari 2025, Anda tidak akan dapat memublikasikan judul yang baru diintegrasikan dengan SDK game v1, di Google Play. Sebaiknya gunakan SDK game v2.
Meskipun game lama dengan integrasi game v1 sebelumnya akan terus berfungsi selama beberapa tahun, sebaiknya Anda bermigrasi ke v2 mulai Juni 2025.
Panduan ini ditujukan untuk penggunaan SDK Layanan game Play v1. SDK C++ untuk Layanan game Play v2 belum tersedia.

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

• Android NDK, Revisi 14 atau yang lebih tinggi.
• Android SDK v10 atau yang lebih tinggi dan Eclipse ADT versi terbaru.
• Perangkat harus menjalankan Android 4.0 (level API 14) atau yang lebih tinggi.
• SDK layanan Google Play versi terbaru.

Panduan developer ini menggunakan Android Native Development Kit (NDK). Jika Anda belum memahami NDK, lihat dokumentasi dan contoh NDK sebelum melanjutkan.

Langkah 1: Siapkan lingkungan Anda

1. Download Android SDK dan Android NDK, lalu ekstrak ke komputer Anda. Di lingkungan Anda, tetapkan SDK_ROOT ke lokasi folder Android SDK dan NDK_ROOT ke lokasi folder Android NDK.
2. Download game contoh C++. Panduan developer ini merujuk ke lokasi sampel di komputer Anda sebagai SAMPLES_DIR.
3. Download SDK C++ layanan game Google Play. Ekstrak SDK ke mesin pengembangan Anda. Di lingkungan Anda, tetapkan variabel NDK_MODULE_PATH agar mengarah ke direktori di atas direktori gpg-cpp-sdk. Anda akan memiliki struktur direktori berikut:

   NDK_MODULE_PATH/
   gpg-cpp-sdk/

4. Buka Eclipse. Jika Anda belum melakukannya, beri tahu Eclipse tempat Anda menginstal NDK dengan mengklik Preferences > Android > NDK.

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

   1. Di Eclipse, klik File > Import > Android > Existing Android Code into 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 Finish.

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

   1. Di Eclipse, klik File > Import > Android > Existing Android Code into Workspace.
   2. Pilih SAMPLES_DIR/samples-android/minimalist.
   3. Klik Finish.

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

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

Project Anda sekarang akan 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. Langkah ini akan mengaktifkan layanan Game untuk aplikasi Anda, dan membuat ID klien OAuth 2.0, jika Anda belum memilikinya.

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

Langkah 3: Jalankan contoh aplikasi

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 > Run As > Android Application dan jalankan contoh di perangkat Anda.
3. Saat sampel terbuka, ketuk di mana saja pada layar. Anda akan melihat logo Google Play Game muncul. Jika telah mengonfigurasi aplikasi dengan benar, Anda akan diminta untuk login.

Penting: Pastikan untuk menandatangani APK Anda dengan sertifikat yang sama dengan sertifikat yang sidik jarinya Anda konfigurasi di Konsol Google Play. Jika tidak melakukannya, akan terjadi error.

Penting: Jika Anda sedang menguji game yang belum dipublikasikan, pastikan akun yang akan Anda gunakan untuk login (biasanya, akun di perangkat pengujian) tercantum sebagai penguji dalam project. Buka halaman Pengujian, di subtab Layanan game di Konsol Google Play, untuk memeriksa atau melakukan daftar putih. Jika langkah ini tidak dilakukan, server akan bertindak seolah-olah project Anda tidak ada, dan menampilkan error.

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 Properti, pilih panel Builders.
2. Klik Baru untuk menambahkan Builder baru, pilih Program, lalu klik Oke.
3. Di kolom Name, masukkan 'NDK Builder'.
4. Di bagian Location, klik Browse File System, lalu buka direktori NDK_ROOT dan pilih perintah ndk-build.
5. Di bagian Working Directory, klik Browse Workspace, lalu pilih folder project MinimalistActivity.
6. Klik tab Perbarui. Pastikan kotak Perbarui resource setelah selesai dicentang.
7. Pilih tombol pilihan Specific resources, lalu klik Specify Resources. Dalam dialog yang dihasilkan, pilih folder jni di bagian MinimalActivity.
8. Klik Terapkan, lalu Oke untuk menyelesaikan pembuatan Builder.

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

Catatan: Jika Anda melihat error saat mengedit file C atau C++ di Eclipse yang mencegah Anda mem-build project, Anda dapat menonaktifkan pelaporan error C/C++ di Eclipse. Di properti project Anda, buka C/C++ General > Code Analysis > Launching dan pastikan kedua kotak tidak dicentang. Kemudian, klik Terapkan dan Oke. Ini adalah solusi untuk mencegah Eclipse memeriksa kode native Anda, dan tidak memperbaiki error mendasar yang mungkin Anda alami.