استخدام حزمة تطوير البرامج (SDK) لأجهزة الكمبيوتر الشخصي أثناء التطوير
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يجب استيفاء عدة متطلبات من أجل إعداد حزمة تطوير البرامج (SDK) بنجاح داخل إحدى الألعاب. ومن بينها:
التشغيل من ملف تنفيذي للعبة موقَّع رقميًا
تشغيل ملف تنفيذ اللعبة من تطبيق "ألعاب Google Play"
ويمكن أن تكون هذه العملية مرهقة للمطوّرين الذين يعملون بنشاط على إنشاء ألعابهم داخل محرّر ألعاب أو بيئة تطوير متكاملة (IDE) للرموز البرمجية، لأنّها تتطلّب تجميع اللعبة ونشرها لإصدارها.
لتوفير سير عمل أفضل للمطوّرين، توفّر حزمة SDK وضع المطوّرين. عند تفعيل وضع المطوّر، يسمح هذا الوضع لحزمة SDK بالعمل داخل محرِّر ألعاب أو بيئة تطوير متكاملة (IDE) للرموز البرمجية. يمكن تهيئة حزمة SDK بدون الحاجة إلى توقيع الملف التنفيذي رقميًا أو تشغيله من "ألعاب Google Play".
المتطلّبات الأساسية
الحصول على معرّف فريد عالمي (GUID) لبرنامج استخدام المنتج قبل إطلاقه هذا مفتاح سري يتيح لفريق التطوير استخدام حزمة SDK من داخل محرِّر محرك الألعاب بدون الحاجة إلى تجميع أو توقيع ملف اللعبة التنفيذي رقميًا أو تشغيله من خلال برنامج "ألعاب Google Play".
الخطوة 1: تفعيل "وضع المطوّرين" في ملف البيان
فعِّل وضع المطوّر لتطبيقك من خلال ضبط IsDeveloperMode على
true داخل manifest.xml الخاص بتطبيقك.
فعِّل ميزة "استخدام التطبيق قبل إطلاقه" على الجهاز الذي تجري عليه الاختبار من خلال ضبط قيمة السلسلة
EarlyAccessPartnerGuid ضمن مفتاح التسجيل
HKLM\Software\Google\Play Games Services\EarlyAccessPartnerGuid.
يمكن إجراء ذلك باستخدام "محرّر قاعدة بيانات المسجّلين في Windows" أو من خلال نافذة طرفية cmd للمشرف باستخدام الأمر:
الخطوة 3: تسجيل الدخول إلى برنامج "ألعاب Google Play على الكمبيوتر"
عند تفعيل "وضع المطوّر"، تستخدم حزمة SDK الحساب الذي تم تسجيل الدخول به إلى ألعاب Google Play على الكمبيوتر عند إجراء طلبات البيانات من واجهة برمجة التطبيقات. إذا تم تسجيل الدخول إلى حسابات متعددة، سيتم استخدام الحساب النشط.
إذا لم يتم إصدار لعبتك بشكل علني (لم يتم نشرها مطلقًا في مسار الإصدار العلني داخل Play Console)، ننصحك باستخدام حساب Google انضم إلى مجموعة الاختبار الداخلي للعبتك. سيتمكّن المختبِرون الداخليون من الوصول إلى لعبتك قبل طرحها، وهو أمر ضروري لكي تعمل بعض واجهات برمجة التطبيقات في حزمة تطوير البرامج (SDK). على سبيل المثال، إكمال عملية شراء باستخدام خدمة الفوترة في Play. يمكنك إدارة المختبِرين الداخليين لتطبيقك من داخل Play Console.
الخطوات التالية
أضِف ميزات Google Play على الكمبيوتر إلى تطبيقك باتّباع الخطوات التالية:
تاريخ التعديل الأخير: 2025-09-02 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-02 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Use the PC SDK while developing\n\nIn order to successfully initialize the SDK inside of a game several\nrequirements must be satisfied. These include:\n\n- Running from a digitally signed game executable\n\n- Launching the game executable from Google Play Games\n\nThese can be burdensome for developers that are actively building their game\ninside of a game editor or code IDE as they require packaging \\& publishing the\ngame for release.\n\nTo provide a better development workflow the SDK offers a developer\nmode. When enabled, the developer mode allows the SDK to function inside\nof a game editor or code IDE. The SDK can be initialized without\nrequiring the executable to be digitally signed or launched from Google Play\nGames.\n\nPrerequisites\n-------------\n\n- Obtain an early-access partner (EAP) GUID. This a secret key that allows your development team to use the SDK from within your game engine editor without needing to package or digitally sign your game executable or launch it from Google Play Games.\n\n| **Note:** Work with your Google Partner to get an early-access partner GUID for your development team. If you don't have an early-access partner, complete the [express interest form](https://docs.google.com/forms/d/e/1FAIpQLScn35BX-X63ggG84S76okR37nwq6qRA1PNPk4fsBpDbD7J21Q/viewform?_ga=2.233777694.1640262997.1747860154-345235146.1745606832).\n\n**Step 1**: Enable developer mode in the manifest\n-------------------------------------------------\n\n| **Warning:** Make sure to remove the `\u003cIsDeveloperMode\u003e` tag before publishing your game.\n\nEnable developer mode for your application by setting `IsDeveloperMode` to\n`true` inside of the your application's `manifest.xml`. \n\n \u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n \u003cManifest version=\"1\"\u003e\n \u003cApplication\u003e\n \u003cPackageName\u003e\u003cvar translate=\"no\"\u003ecom.example.package\u003c/var\u003e\u003c/PackageName\u003e\n \\\u003cIsDeveloperMode\\\u003etrue\\\u003c/IsDeveloperMode\\\u003e\n \u003c/Application\u003e\n \u003c/Manifest\u003e\n\n**Step 2**: Enable early access\n-------------------------------\n\n| **Warning:** The early access partner GUID is a secret. Don't share this value.\n\nEnable early access on the device where your are testing by setting the\n`EarlyAccessPartnerGuid` string value under the\n`HKLM\\Software\\Google\\Play Games Services\\EarlyAccessPartnerGuid` registry key.\n\nThis can be done either using the Windows Registry Editor, or from an admin cmd\nterminal with the command: \n\n C:\\\u003e reg add \"HKLM\\Software\\Google\\Play Games Services\" /v EarlyAccessPartnerGuid /t REG_SZ /d \u003cvar translate=\"no\"\u003eEAP GUID\u003c/var\u003e\n\n**Step 3**: Sign into Google Play Games for PC\n----------------------------------------------\n\nWhen developer mode is enabled, the SDK uses the account signed into\n[Google Play Games for PC](https://play.google.com/googleplaygames) when making API\ncalls. If multiple accounts are signed in, the active account will be used.\n\nIf your game not been publicly released (has never published to the production\nrelease track inside of the Play Console), we recommend using a Google Account\nthat has joined your game's internal testing group. Internal testers will have\naccess to your game before release which is required for some SDK APIs to\nfunction. For example, completing a purchase with Play Billing. You may manage\nyour app's internal testers inside of the\n[Play Console](https://play.google.com/console/about/internal-testing/).\n\nNext steps\n----------\n\nAdd Google Play PC features to your app:\n\n- Sell digital goods with [Play Billing](/games/playgames/native-pc/billing)\n- Measure your marketing with [Play Install Referrer](/games/playgames/native-pc/install_referrer)"]]
