با Play Games Services for C++ در Android شروع کنید

پس از منسوخ شدن رابط برنامه‌نویسی کاربردی ورود گوگل (Google Sign-In API)، ما در سال ۲۰۲۶ کیت توسعه نرم‌افزاری بازی‌ها نسخه ۱ (games v1 SDK) را حذف خواهیم کرد. پس از فوریه ۲۰۲۵، شما قادر به انتشار عناوینی که به تازگی با کیت توسعه نرم‌افزاری بازی‌ها نسخه ۱ (games v1 SDK) ادغام شده‌اند، در گوگل پلی نخواهید بود. توصیه می‌کنیم به جای آن از کیت توسعه نرم‌افزاری بازی‌ها نسخه ۲ (games v2 SDK) استفاده کنید.
در حالی که عناوین موجود با بازی‌های قبلی نسخه ۱ ادغام‌شده تا چند سال دیگر به کار خود ادامه می‌دهند، توصیه می‌شود از ژوئن ۲۰۲۵ به نسخه ۲ مهاجرت کنید .
این راهنما برای استفاده از SDK نسخه ۱ سرویس بازی‌های Play Games است. SDK مربوط به C++ برای سرویس بازی‌های Play Games نسخه ۲ هنوز در دسترس نیست.

این راهنمای توسعه‌دهنده به شما نشان می‌دهد که چگونه یک بازی ++C را در اندروید که از API سرویس‌های بازی گوگل پلی استفاده می‌کند، کامپایل و اجرا کنید. قبل از شروع، پیش‌نیازهای زیر را دانلود و پیکربندی کنید:

• اندروید NDK ، نسخه ۱۴ یا بالاتر.
• اندروید SDK نسخه ۱۰ یا بالاتر و آخرین نسخه Eclipse ADT .
• دستگاه باید اندروید ۴.۰ (سطح API ۱۴) یا بالاتر را اجرا کند.
• آخرین نسخه SDK سرویس‌های گوگل پلی.

این راهنمای توسعه‌دهندگان از کیت توسعه بومی اندروید (NDK) استفاده می‌کند. اگر با NDK آشنا نیستید، قبل از ادامه به مستندات و نمونه‌های NDK مراجعه کنید.

مرحله ۱: محیط خود را تنظیم کنید

1. Android SDK و Android NDK را دانلود کرده و آنها را در دستگاه خود استخراج کنید. در محیط خود، SDK_ROOT روی محل پوشه Android SDK و NDK_ROOT را روی محل پوشه Android NDK خود تنظیم کنید.
2. بازی‌های نمونه ++C را دانلود کنید. این راهنمای توسعه‌دهنده به محل نمونه‌ها روی دستگاه شما با عنوان SAMPLES_DIR اشاره می‌کند.
3. کیت توسعه نرم‌افزار C++ مربوط به سرویس‌های بازی‌های گوگل پلی را دانلود کنید. کیت توسعه نرم‌افزار را روی دستگاه توسعه‌دهنده خود استخراج کنید. در محیط خود، متغیر NDK_MODULE_PATH طوری تنظیم کنید که به دایرکتوری بالای دایرکتوری gpg-cpp-sdk اشاره کند. ساختار دایرکتوری شما باید به صورت زیر باشد:

   NDK_MODULE_PATH/
   gpg-cpp-sdk/

4. Eclipse را باز کنید. اگر قبلاً این کار را نکرده‌اید، با کلیک روی Preferences > Android > NDK به Eclipse بگویید که NDK را کجا نصب کرده‌اید.

5. پروژه کتابخانه سرویس‌های گوگل پلی را به فضای کاری Eclipse خود وارد کنید.

   1. در Eclipse، روی File > Import > Android > Existing Android Code into Workspace کلیک کنید.
   2. SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib را انتخاب کنید که در آن SDK_ROOT محل SDK اندروید شما است.
   3. روی پایان کلیک کنید.

6. پروژه نمونه مینیمالیستی را به فضای کاری Eclipse خود وارد کنید.

   1. در Eclipse، روی File > Import > Android > Existing Android Code into Workspace کلیک کنید.
   2. SAMPLES_DIR/samples-android/minimalist را انتخاب کنید.
   3. روی پایان کلیک کنید.

7. روی پروژه MinimalistActivity کلیک راست کرده و Properties را انتخاب کنید. در قسمت Android ، به پایین اسکرول کنید تا به بخش Library برسید و مطمئن شوید که پروژه google-play-services_lib به درستی ارجاع داده شده است. در غیر این صورت، ارجاع را حذف کرده و دوباره آن را از فضای کاری خود اضافه کنید.

Eclipse به طور خودکار منابع جاوا و اندروید پروژه شما را کامپایل می‌کند؛ با این حال، کد native موجود در پوشه jni باید جداگانه کامپایل شود. برای انجام این کار به صورت دستی، به پوشه jni بروید و ndk-build را اجرا کنید. به یاد داشته باشید که این کار را پس از ایجاد هرگونه تغییر در پوشه jni انجام دهید.

پروژه شما اکنون باید کامپایل شود، هرچند هنوز کار نخواهد کرد. ابتدا باید بازی خود را در کنسول گوگل پلی پیکربندی کنید.

مرحله ۲: بازی را در کنسول گوگل پلی تنظیم کنید

یک ورودی برای بازی خود در کنسول گوگل پلی ایجاد کنید. این کار سرویس‌های بازی را برای برنامه شما فعال می‌کند و اگر از قبل شناسه کلاینت OAuth 2.0 ندارید، آن را ایجاد می‌کند.

1. با دنبال کردن مراحل شرح داده شده در «راه‌اندازی سرویس‌های بازی‌های گوگل پلی»، یک ورودی برای بازی خود ایجاد کنید.
2. در AndroidManifest.xml ، ویژگی package مربوط به تگ <manifest> را به نام package که هنگام تنظیم کنسول گوگل پلی انتخاب کرده‌اید، تغییر دهید. ممکن است لازم باشد پس از ایجاد این تغییر، برخی ارجاعات را در طول پروژه اصلاح کنید (به‌ویژه در مورد کلاس R تولید شده).
3. res/values/ids.xml را باز کنید و شناسه برنامه خود را در آنجا قرار دهید. توجه داشته باشید که شناسه برنامه با شناسه کلاینت یکسان نیست؛ بلکه عددی است که در کنار نام بازی شما در صفحه جزئیات بازی کنسول گوگل پلی قرار دارد.

مرحله ۳: اجرای نمونه

برای اجرای نمونه، به یک دستگاه اندروید فیزیکی یا یک شبیه‌ساز با سرویس‌های گوگل پلی نصب شده نیاز دارید:

1. برای کامپایل کد native، ndk-build را اجرا کنید.
2. در Eclipse، روی Run > Run As > Android Application کلیک کنید و نمونه را روی دستگاه خود اجرا کنید.
3. وقتی نمونه باز شد، روی هر قسمتی از صفحه ضربه بزنید. باید لوگوی بازی‌های گوگل پلی ظاهر شود. اگر برنامه خود را به درستی پیکربندی کرده باشید، از شما خواسته می‌شود که وارد سیستم شوید.

اختیاری: ساخت خودکار با Eclipse

مراحل زیر به شما نشان می‌دهد که چگونه Eclipse را طوری پیکربندی کنید که هنگام ایجاد تغییرات در فایل‌های پوشه jni به طور خودکار ndk-build را اجرا کند.

1. روی پروژه MinimalistActivity کلیک راست کرده و Properties را انتخاب کنید. در پنجره Properties، پنل Builders را انتخاب کنید.
2. برای افزودن یک سازنده جدید، روی «جدید» کلیک کنید و «برنامه» را انتخاب کنید، سپس روی «تأیید» کلیک کنید.
3. در فیلد نام ، عبارت «NDK Builder» را وارد کنید.
4. در قسمت Location روی Browse File System کلیک کنید و به پوشه NDK_ROOT بروید و دستور ndk-build را انتخاب کنید.
5. در زیر Working Directory روی Browse Workspace کلیک کنید و پوشه پروژه MinimalistActivity را انتخاب کنید.
6. روی برگه «به‌روزرسانی» کلیک کنید. مطمئن شوید که گزینه «به‌روزرسانی منابع پس از اتمام» علامت زده شده است.
7. دکمه رادیویی «Specify Resources» را انتخاب کنید و سپس روی «Specify Resources» کلیک کنید. در پنجره باز شده، پوشه jni را در زیر «MinimalActivity» انتخاب کنید.
8. برای تکمیل ساخت سازنده، روی اعمال و سپس تأیید کلیک کنید.

حالا هر بار که فایلی را درون پوشه jni ویرایش می‌کنید، Eclipse ndk-build را اجرا کرده و خروجی را در کنسول Eclipse چاپ می‌کند.