Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Setelah penghentian
Google Sign-In
API, 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 judul yang ada dengan integrasi game v1 sebelumnya akan terus berfungsi selama
beberapa tahun, sebaiknya Anda
bermigrasi ke v2
mulai Juni 2025.
Panduan ini ditujukan untuk menggunakan 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:
Panduan developer ini menggunakan Android Native Development Kit (NDK). Jika Anda tidak terbiasa dengan NDK,
lihat dokumentasi dan contoh NDK
sebelum melanjutkan.
Langkah 1: Siapkan lingkungan Anda
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.
Download game contoh C++. Panduan developer ini merujuk ke lokasi sampel di komputer Anda sebagai SAMPLES_DIR.
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/
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 Anda.
Di Eclipse, klik File > Import > Android > Existing Android Code into Workspace.
Pilih SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
dengan SDK_ROOT adalah lokasi Android SDK Anda.
Klik Finish.
Impor project contoh minimalis ke ruang kerja Eclipse Anda.
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 dirujuk
dengan benar. Jika tidak, hapus referensi dan tambahkan lagi dari ruang kerja Anda.
Eclipse akan otomatis mengompilasi sumber Java dan Android project Anda; tetapi, kode native di folder jni perlu dikompilasi secara terpisah. Untuk melakukannya secara manual, buka
folder jni dan jalankan ndk-build. Jangan lupa untuk melakukannya setelah Anda melakukan 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. Tindakan ini akan mengaktifkan layanan game untuk
aplikasi Anda, dan membuat client ID OAuth 2.0, jika Anda belum memilikinya.
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
di seluruh project setelah melakukan perubahan ini (terutama pada class R yang dihasilkan).
Buka res/values/ids.xml dan tempatkan ID Aplikasi Anda di sana. Perhatikan bahwa ID Aplikasi tidak sama dengan
client ID; ID Aplikasi adalah angka di samping nama game Anda di halaman Detail Game di
Konsol Google Play.
Langkah 3: Jalankan contoh
Untuk menjalankan contoh, Anda memerlukan perangkat Android fisik atau emulator dengan
layanan Google Play yang diinstal:
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 pada 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 untuk menjalankan ndk-build secara otomatis 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.
Di kolom Name, masukkan 'NDK Builder'.
Di bagian Location, klik Browse File System dan buka direktori NDK_ROOT, lalu
pilih perintah ndk-build.
Di bagian Working Directory, klik Browse Workspace, lalu pilih folder project
MinimalistActivity.
Klik tab Refresh. Pastikan kotak Refresh resources upon completion dicentang.
Pilih tombol pilihan Specific resources, lalu klik Specify Resources. Dalam
dialog yang dihasilkan, pilih folder jni di bagian MinimalActivity.
Klik Apply, lalu OK untuk menyelesaikan pembuatan Builder.
Sekarang, setiap kali Anda mengedit file dalam folder jni, Eclipse akan menjalankan ndk-build dan mencetak output ke Eclipse Console.
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-27 UTC."],[],[],null,["# Get Started with Play Games Services for C++ on Android\n\nFollowing the deprecation of the\n[Google Sign-In](https://android-developers.googleblog.com/2024/09/streamlining-android-authentication-credential-manager-replaces-legacy-apis.html)\nAPI, we are removing the games v1 SDK in 2026. After February 2025, you will be unable to publish\ntitles that are newly integrated with games v1 SDK, on Google Play. We recommend that you use the\ngames v2 SDK instead. \n\nWhile existing titles with the previous games v1 integrations continue to function for a\ncouple of years, you are encouraged to\n[migrate to v2](/games/pgs/android/migrate-to-v2)\nstarting June 2025. \n\nThis guide is for using the Play Games Services v1 SDK. The C++ SDK for\nPlay Games Services v2 is not yet available.\n\nThis developer guide will show you how to compile and run a C++ game on Android that uses the Google Play\nGame services API. Before you begin, download and configure the following requirements:\n\n- [Android NDK](/ndk), Revision 14 or higher.\n- [Android SDK v10 or higher and latest version of the Eclipse ADT](/studio/tools/sdk/eclipse-adt).\n- Device must be running Android 4.0 (API level 14) or higher.\n- [The latest version of the Google Play services SDK.](https://developers.google.com/android/guides/setup)\n\nThis developer guide uses the Android Native Development Kit (NDK). If you are unfamiliar with the NDK,\nrefer to the [NDK documentation and samples](/ndk)\nbefore continuing.\n\nStep 1: Set up your environment\n-------------------------------\n\n1. Download the Android SDK and the Android NDK and extract them to your machine. In your environment, set `SDK_ROOT` to the location of your Android SDK folder and `NDK_ROOT` to the location of your Android NDK folder.\n2. Download the [C++ sample games](//github.com/playgameservices/cpp-android-basic-samples). This developer guide refers to the location of the samples on your machine as `SAMPLES_DIR`.\n3. Download the [Google Play Games services C++ SDK](/games/pgs/downloads#sdk). Extract the SDK onto your development machine. In your environment, set the variable `NDK_MODULE_PATH` to point to the directory **above** the `gpg-cpp-sdk` directory. You should have the following directory structure: \n\n ```\n NDK_MODULE_PATH/\n gpg-cpp-sdk/\n ```\n4. Open Eclipse. If you have not already done so, tell Eclipse where you installed the NDK by clicking **Preferences \\\u003e Android \\\u003e NDK**.\n5. Import the Google Play services library project into your Eclipse workspace.\n\n 1. In Eclipse, click **File \\\u003e Import \\\u003e Android \\\u003e Existing Android Code into Workspace**.\n 2. Select `SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib` where `SDK_ROOT` is the location of your Android SDK.\n 3. Click **Finish**.\n6. Import the minimalist sample project into your Eclipse workspace.\n\n 1. In Eclipse, click **File \\\u003e Import \\\u003e Android \\\u003e Existing Android Code into Workspace**.\n 2. Select `SAMPLES_DIR/samples-android/minimalist`.\n 3. Click **Finish**.\n7. Right click the MinimalistActivity project and click **Properties** . Under **Android** , scroll\n down to the **Library** section and make sure the google-play-services_lib project is correctly\n referenced. If not, remove the reference and add it again from your workspace.\n\nEclipse will automatically compile the Java and Android sources of your project; however, the\nnative code in the `jni` folder needs to be compiled separately. To do this manually, navigate to\nthe `jni` folder and run `ndk-build`. Remember to do this after you make any changes inside\nthe `jni` folder.\n\nYour project should now compile, though it will not work yet. You must first configure your game\nin the Google Play Console.\n\nStep 2: Set up the game in the Google Play Console\n--------------------------------------------------\n\nCreate an entry for your game in the Google Play Console. This enables Games services for your\napplication, and creates an OAuth 2.0 client ID, if you don't already have one.\n\n1. Create an entry for your game by following the steps described in [Setting Up Google Play Games Services](/games/pgs/console/setup).\n2. In `AndroidManifest.xml`, change the `package` attribute of the `\u003cmanifest\u003e` tag to the package name you chose when setting up the Google Play Console. You may have to fix some references throughout the project after making this change (particularly to the generated `R` class).\n3. Open `res/values/ids.xml` and place your App ID there. Note that the App ID is not the same as the client ID; it is the number next to the name of your game in the **Game Details** page of the Google Play Console.\n\nStep 3: Run the sample\n----------------------\n\nIn order to run the sample you will need a physical Android device or an emulator with\nGoogle Play services installed:\n\n1. Run `ndk-build` to compile the native code.\n2. In Eclipse, click **Run \\\u003e Run As \\\u003e Android Application** and run the sample on your device.\n3. When the sample opens, tap anywhere on the screen. You should see a Google Play Games logo appear. If you have correctly configured your app, you will be prompted to sign in.\n\n| **Important:** Make sure to sign your APK with the same certificate as the one whose fingerprint you configured on Google Play Console. Failure to do so will produce errors.\n| **Important:** If you are testing an unpublished game, make sure that the account with which you intend to sign in (usually, the account on the test device) is listed as a tester in the project. Open the **Testing** page, in the **Game services** subtab of the Google Play Console, to check or perform whitelisting. Failure to perform this step causes the server to act as though your project does not exist, and return errors.\n\nOptional: Build automatically with Eclipse\n------------------------------------------\n\nThe following steps show you how to configure Eclipse to automatically run `ndk-build` when you\nmake changes to files in the `jni` folder.\n\n1. Right-click the MinimalistActivity project and click **Properties** . In the Properties window, select the **Builders** pane.\n2. Click **New** to add a new Builder and select **Program** then click **OK**.\n3. In the **Name** field, enter 'NDK Builder'.\n4. Under **Location** click **Browse File System** and navigate to the `NDK_ROOT` directory and select the `ndk-build` command.\n5. Under **Working Directory** click **Browse Workspace** and select the MinimalistActivity project folder.\n6. Click the **Refresh** tab. Make sure the **Refresh resources upon completion** box is checked.\n7. Select the **Specific resources** radio button and then click **Specify Resources** . In the resulting dialog, select the `jni` folder under MinimalActivity.\n8. Click **Apply** and then **OK** to finish creating your Builder.\n\nNow every time you edit a file within the `jni` folder, Eclipse will run `ndk-build` and print the\noutput to the Eclipse Console.\n| **Note:** If you see errors when editing C or C++ files in Eclipse that prevent you from building the project, you may want to disable C/C++ error reporting in Eclipse. In your project properties, navigate to **C/C++ General \\\u003e Code Analysis \\\u003e Launching** and make sure that both boxes are unchecked. Then click **Apply** and **OK** . This is a workaround to prevent Eclipse from checking your native code, it does **not** fix any real underlying errors you may have."]]
