با Play Games Services for C++ در Android شروع کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
پس از منسوخ شدن Google Sign-In API، ما بازی‌ها v1 SDK را در سال 2026 حذف می‌کنیم. پس از فوریه 2025، نمی‌توانید عناوینی را که به تازگی با بازی‌های v1 SDK ادغام شده‌اند، در Google Play منتشر کنید. توصیه می کنیم به جای آن از بازی ها v2 SDK استفاده کنید. در حالی که عناوین موجود با ادغام های قبلی نسخه 1 برای چند سال به کار خود ادامه می دهند، شما تشویق می شوید که از ژوئن 2025 به نسخه 2 مهاجرت کنید . این راهنما برای استفاده از Play Games Services v1 SDK است. C++ SDK برای Play Games Services v2 هنوز در دسترس نیست.
این راهنمای توسعه‌دهنده به شما نشان می‌دهد که چگونه یک بازی C++ را در Android که از API خدمات بازی Google Play استفاده می‌کند، کامپایل و اجرا کنید. قبل از شروع، الزامات زیر را دانلود و پیکربندی کنید:
این راهنمای توسعه‌دهنده از کیت توسعه بومی Android (NDK) استفاده می‌کند. اگر با NDK آشنا نیستید، قبل از ادامه به مستندات و نمونه های NDK مراجعه کنید.
مرحله 1: محیط خود را تنظیم کنید
Android SDK و Android NDK را دانلود کنید و آنها را در دستگاه خود استخراج کنید. در محیط خود، SDK_ROOT روی محل پوشه Android SDK خود و NDK_ROOT در محل پوشه Android NDK خود تنظیم کنید.
دانلود نمونه بازی های ++C . این راهنمای توسعه‌دهنده به مکان نمونه‌ها در دستگاه شما به عنوان SAMPLES_DIR اشاره می‌کند.
سرویس بازی‌های Google Play C++ SDK را دانلود کنید. SDK را در دستگاه توسعه خود استخراج کنید. در محیط خود، متغیر NDK_MODULE_PATH طوری تنظیم کنید که به دایرکتوری بالای دایرکتوری gpg-cpp-sdk اشاره کند. شما باید ساختار دایرکتوری زیر را داشته باشید:
NDK_MODULE_PATH/
gpg-cpp-sdk/
Eclipse را باز کنید. اگر قبلاً این کار را نکرده‌اید، با کلیک روی Preferences > Android > NDK به Eclipse بگویید NDK را در کجا نصب کرده‌اید.
پروژه کتابخانه خدمات Google Play را به فضای کاری Eclipse خود وارد کنید.
در Eclipse، روی File > Import > Android > Existing Android Code در Workspace کلیک کنید.
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib را انتخاب کنید که در آن SDK_ROOT مکان SDK Android شما است.
روی Finish کلیک کنید.
پروژه نمونه مینیمالیستی را در فضای کاری Eclipse خود وارد کنید.
در Eclipse، روی File > Import > Android > Existing Android Code در Workspace کلیک کنید.
SAMPLES_DIR/samples-android/minimalist را انتخاب کنید.
روی Finish کلیک کنید.
روی پروژه MinimalistActivity کلیک راست کرده و روی Properties کلیک کنید. در Android ، به بخش کتابخانه بروید و مطمئن شوید که پروژه google-play-services_lib به درستی ارجاع داده شده است. اگر نه، مرجع را بردارید و دوباره از فضای کاری خود اضافه کنید.
Eclipse به طور خودکار منابع جاوا و اندروید پروژه شما را کامپایل می کند. با این حال، کد بومی در پوشه jni باید به طور جداگانه کامپایل شود. برای انجام این کار به صورت دستی، به پوشه jni بروید و ndk-build را اجرا کنید. به یاد داشته باشید که این کار را بعد از ایجاد هر گونه تغییر در پوشه jni انجام دهید.
پروژه شما اکنون باید کامپایل شود، اگرچه هنوز کار نخواهد کرد. ابتدا باید بازی خود را در کنسول Google Play پیکربندی کنید.
مرحله 2: بازی را در کنسول Google Play تنظیم کنید
یک ورودی برای بازی خود در کنسول Google Play ایجاد کنید. این سرویس‌های بازی‌ها را برای برنامه شما فعال می‌کند و شناسه مشتری OAuth 2.0 ایجاد می‌کند، اگر قبلاً آن را ندارید.
در AndroidManifest.xml ، ویژگی package تگ <manifest> را به نام بسته ای که هنگام راه اندازی کنسول Google Play انتخاب کرده اید، تغییر دهید. ممکن است مجبور شوید پس از انجام این تغییر، برخی از ارجاعات را در سراسر پروژه اصلاح کنید (به ویژه در کلاس R ایجاد شده).
res/values/ids.xml را باز کرده و App ID خود را در آنجا قرار دهید. توجه داشته باشید که شناسه برنامه با شناسه مشتری یکسان نیست. این شماره در کنار نام بازی شما در صفحه جزئیات بازی کنسول Google Play است.
مرحله 3: نمونه را اجرا کنید
برای اجرای نمونه به یک دستگاه اندروید فیزیکی یا شبیه ساز با سرویس های Google Play نصب شده نیاز دارید:
برای کامپایل کردن کد اصلی ndk-build اجرا کنید.
در Eclipse، روی Run > Run As > Android Application کلیک کنید و نمونه را روی دستگاه خود اجرا کنید.
وقتی نمونه باز شد، روی هر نقطه از صفحه ضربه بزنید. باید نشان‌واره بازی‌های Google Play ظاهر شود. اگر برنامه خود را به درستی پیکربندی کرده باشید، از شما خواسته می شود که وارد شوید.
اختیاری: ساخت خودکار با Eclipse
مراحل زیر به شما نشان می دهد که چگونه Eclipse را برای اجرای خودکار ndk-build هنگام ایجاد تغییرات در فایل های پوشه jni ، پیکربندی کنید.
روی پروژه MinimalistActivity کلیک راست کرده و روی Properties کلیک کنید. در پنجره Properties، پنجره Builders را انتخاب کنید.
برای افزودن یک سازنده جدید روی New کلیک کنید و برنامه را انتخاب کنید سپس روی OK کلیک کنید.
در قسمت نام ، «NDK Builder» را وارد کنید.
در قسمت Location روی Browse File System کلیک کنید و به دایرکتوری NDK_ROOT بروید و دستور ndk-build را انتخاب کنید.
در قسمت Working Directory روی Browse Workspace کلیک کنید و پوشه پروژه MinimalistActivity را انتخاب کنید.
روی تب Refresh کلیک کنید. مطمئن شوید که کادر Refresh resources after completion علامت زده شده است.
دکمه رادیویی منابع خاص را انتخاب کنید و سپس روی Specify Resources کلیک کنید. در گفتگوی به دست آمده، پوشه jni را در زیر MinimalActivity انتخاب کنید.
روی Apply و سپس OK کلیک کنید تا ساخت Builder خود را به پایان برسانید.
اکنون هر بار که فایلی را در پوشه jni ویرایش می کنید، Eclipse ndk-build اجرا می کند و خروجی را در Eclipse Console چاپ می کند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]
