مرحبًا بك في تطوير ألعاب Android من خلال خدمات ألعاب Google Play.
توفّر "حزمة تطوير البرامج (SDK) الخاصة بـ "ألعاب Play" خدمات ألعاب Google Play من عدّة منصات، ما يتيح لك بسهولة دمج ميزات الألعاب الرائجة مثل الإنجازات وقوائم الصدارة خدمة "حفظ التقدم في الألعاب" في ألعاب الأجهزة اللوحية وألعاب الأجهزة الجوّالة
سترشدك هذه الدورة التدريبية إلى كيفية تثبيت نموذج لعبة على نظام التشغيل Android. وابدأ بسرعة في إنشاء لعبتك الخاصة على Android. نوع الرقم يوضح نموذج التحدي كيفية تحقيق الإنجازات قوائم الصدارة في لعبتك
قبل البدء
لإعداد تطبيقك، أكمِل الخطوات الواردة في الأقسام التالية.
المتطلّبات الأساسية للتطبيق
يُرجى التأكُّد من أنّ ملف الإصدار لتطبيقك يستخدم القيم التالية:
- درجة
minSdkVersion
من19
بمستوى أعلى compileSdkVersion
بقيمة28
أو أعلى
إعداد لعبتك في Google Play Console
أداة Google Play Console هي المكان الذي تدير فيه خدمات ألعاب Google Play وتكوين البيانات الوصفية لتفويض لعبتك ومصادقتها. بالنسبة مزيد من المعلومات، راجع إعداد "خدمات ألعاب Google Play":
إعداد تطبيقك
في ملف build.gradle
على مستوى المشروع، عليك تضمين
مستودع Maven من Google
ومستودع Maven المركزي
في كل من القسمين buildscript
وallprojects
:
buildscript {
repositories {
google()
mavenCentral()
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
أضِف الاعتمادية على خدمات Google Play لحزمة تطوير البرامج (SDK) الخاصة بـ "ألعاب Play" إلى
ملف إنشاء Gradle للوحدة، والذي عادةً ما
app/build.gradle
:
dependencies {
implementation 'com.google.android.gms:play-services-games:23.2.0'
}
نموذج دليل التطبيق
سترشدك هذه الدورة التدريبية إلى كيفية تثبيت نموذج لعبة على نظام التشغيل Android. وابدأ بسرعة في إنشاء لعبتك الخاصة على Android. نوع الرقم يوضح نموذج التحدي كيفية تحقيق الإنجازات قوائم الصدارة في لعبتك
الخطوة 1: تنزيل نموذج التطبيق
بالنسبة إلى دليل المطوِّر هذا، ستحتاج إلى تنزيل نموذج تحدي النوع رقم تطبيق Android.
لتنزيل نموذج التطبيق وإعداده في "استوديو Android":
- نزِّل نماذج Android من صفحة تنزيل النماذج.
- عليك استيراد مشروع "
android-basic-samples
". يتضمّن هذا المشروع "TypeANumber
" ولعبة أخرى على Android. العينات. لإجراء ذلك في "استوديو Android"، اتّبِع الخطوات التالية:- انقر على ملف >. استيراد مشروع:
- تصفُّح الدليل الذي نزّلت فيه تطبيق
android-basic-samples
أثناء تطويرك الجهاز. اختَر الملفandroid-basic-samples/build.gradle
وانقر على حسنًا.
- في وحدة
TypeANumber
، افتحAndroidManifest.xml
وغيِّر اسم الحزمة منcom.google.example.games.tanc
إلى اسم حزمة مختلف خاص بك. يجب أن يكون اسم الحزمة الجديد لا تبدأ بـcom.google
أوcom.example
أوcom.android
.
الخطوة 2: إعداد اللعبة في Google Play Console
أداة Google Play Console هي المكان الذي تُدير فيه خدمات "ألعاب Google Play" للعبتك. تهيئة البيانات الوصفية لتفويض لعبتك ومصادقتها.
لإعداد نموذج لعبة في Google Play Console:
- وجه متصفح الويب إلى Google Play Console لتسجيل الدخول. إذا لم يسبق لك التسجيل في Google Play Console، سيُطلب منك إجراء ذلك.
- اتّبِع هذه التعليمات
إضافة لعبتك إلى Google Play Console
- عند سؤالك عمّا إذا كنت تستخدم Google APIs في تطبيقك، اختَر لا أستخدم أيًا من واجهات Google APIs في لعبتي بعد.
- لأغراض دليل المطوِّر هذا، يمكنك ملء النموذج بمعلوماتك تفاصيل اللعبة. لتسهيل الاستخدام، يمكنك استخدام رموز العناصر النائبة ولقطات الشاشة. المقدمة في صفحة عمليات التنزيل.
- اتّبِع هذه التعليمات
إنشاء معرِّف عميل OAuth 2.0
لتطبيق Android.
- عند ربط تطبيق Android، احرص على تحديد الحزمة الدقيقة المستخدم سابقًا عند إعادة تسمية نموذج الحزمة.
- يمكنك استخدام "معالج إنشاء حِزم APK موقَّعة" في "استوديو Android" لتنفيذ ما يلي: إنشاء ملف تخزين مفاتيح جديد وشهادة موقعة إذا لم يكن لديك واحدة بالفعل. للتعرّف على كيفية تشغيل معالج إنشاء APK الموقَّع، راجع توقيع تطبيقك في "استوديو Android":
- احرص على تسجيل المعلومات التالية لاستخدامها في وقت لاحق:
- رقم تعريف التطبيق: هذه سلسلة. يتكون فقط من أرقام (عادةً 12 رقمًا أو أكثر)، في بداية معرِّف العميل الخاص بك.
- شهادة التوقيع: سجِّل الشهادة التي استخدمتها عند الإعداد وصولك إلى واجهة برمجة التطبيقات (الشهادة التي قدمت ملف SHA1 المرجعي إليها). إِنْتَ يجب استخدام الشهادة نفسها لتوقيع تطبيقك عند اختبار التطبيق.
- قم بتهيئة الإنجازات لتحدي النوع رقم:
- اختَر علامة التبويب الإنجازات في Google Play Console.
- أضِف نماذج الإنجازات التالية:
الاسم الوصف تعليمات خاصة رئيسي احصل على نتيجة تمثل رقمًا أوليًا. ما من شبكة Humble اطلب النتيجة 0. ما من شبكة لا تكن مغرورًا يا طفلي اطلب النتيجة 9999 في أي من الوضعين. ما من شبكة يا للعجب! احصل على النتيجة 1337. جعل هذا إنجازًا مخفيًا ملل لعب اللعبة 10 مرات. اجعل هذا إنجازًا متزايدًا من خلال 10 خطوات لفتحه. ملل حقيقي لعب اللعبة 100 مرة. يمكنك تحقيق إنجاز إضافي من خلال 100 خطوة يمكنك الاستفادة منها. - سجِّل أرقام التعريف (سلاسل أبجدية رقمية طويلة) لكل إنجاز تريد إنشاء.
- يمكنك ضبط الإنجازات المناسبة للعبتك. للمزيد من المعلومات يمكنك الاطّلاع على المفاهيم الكامنة وراء الإنجازات. وكيفية تنفيذ الإنجازات في Android.
- اضبط لوحات الصدارة في تحدي النوع رقم:
- اختَر علامة التبويب لوحات الصدارة في Google Play Console.
- أضِف نموذجَين للوحات الصدارة: إحداهما باسم "النتائج العالية السهلة" والأخرى يسمى "النتائج العالية الحادّة". يجب أن تستخدم كلتا لوحتَي الصدارة تنسيق عدد صحيح لا تتضمّن خانات عشرية، ونوع الطلب أكبر.
- سجِّل أرقام التعريف (سلاسل أبجدية رقمية طويلة) لكل لوحة صدارة تنشئها.
- يمكنك إعداد لوحات الصدارة المناسبة للعبتك. للمزيد من المعلومات يمكنك الاطّلاع على المفاهيم التي تستند إليها قوائم الصدارة كيفية تطبيق ميزة "لوحات الصدارة" في نظام التشغيل Android
- أضِف حسابات اختبارية للعبتك. هذه الخطوة مطلوبة فقط للتطبيقات التي لم يتم نشرها في Google Play Console. قبل نشر التطبيق، ستكون الحسابات التجريبية المدرجة فقط في Google Play Console يمكنهم تسجيل الدخول. ومع ذلك، بعد نشر أحد التطبيقات، يسمح للجميع بتسجيل الدخول.
الخطوة 3: تعديل الرمز
لتشغيل اللعبة، عليك ضبط رقم تعريف التطبيق كمورد في
مشروع Android. عليك أيضًا إضافة البيانات الوصفية الخاصة بالألعاب في AndroidManifest.xml
.
- افتح
res/values/ids.xml
واستبدِل أرقام تعريف العناصر النائبة. إذا كنت إذا كنت تنشئ لعبة Android من البداية، ستحتاج إلى إنشاء هذا الملف أولاً.- حدِّد رقم تعريف التطبيق في المرجع "
app_id
". - تحديد كل رقم تعريف إنجاز قمت بإنشائه مسبقًا في
مرجع واحد (
achievement_*
) - حدد كل رقم تعريف للوحة الصدارة قمت بإنشائه مسبقًا في
مرجع واحد (
leaderboard_*
)
- حدِّد رقم تعريف التطبيق في المرجع "
- افتح
AndroidManifest.xml
وأدخِل اسم الحزمة فيpackage
. لسمة <manifest
> العنصر. إذا كنت تنشئ لعبة Android من من البداية، فتأكد من إضافة الرمز التالي أيضًا في قسم <application
> العنصر:<meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/app_id" /> <meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version"/>
الخطوة 4: اختبار لعبتك
للتأكّد من عمل "خدمات ألعاب Google Play" بشكل صحيح في لعبتك، يمكنك اختبار التطبيق قبل نشره على Google Play.
لتشغيل لعبتك على جهاز الاختبار البدني:
- تأكَّد من أنّك أعددت الحساب التجريبي الذي تستخدمه لتسجيل الدخول. إلى التطبيق (كما هو موضّح في الخطوة 2).
- يمكنك تصدير حزمة APK وتوقيعها باستخدام الشهادة نفسها التي استخدمتها في إعدادها. للمشروع في Google Play Console. لتصدير ملف APK موقَّع في "استوديو Android"، انقر على إنشاء > إنشاء حِزمة APK موقَّعة
- ثبِّت حزمة APK الموقَّعة على جهاز الاختبار المادي باستخدام أداة
adb
. لمعرفة كيفية تثبيت أحد التطبيقات، راجع التشغيل على جهاز: