إعداد بيئة تطوير متكاملة (IDE) لتطوير SDV

استوديو Android للمنصة (ASfP) هو بيئة التطوير المتكاملة (IDE) المقترَحة لتطوير نظام Android الأساسي، بما في ذلك مشاريع "المركبة المحدّدة بالبرامج" (SDV) لنظام التشغيل Android Automotive. توفّر ASfP مجموعة كبيرة من الأدوات لتعديل الرموز البرمجية وإنشائها وتصحيح أخطائها واختبارها، بما في ذلك:

• المساعدة المستندة إلى الذكاء الاصطناعي (Gemini)
• توافُق لغة Rust أو C أو C++‎ أو Java
• عمليات دمج مفيدة لتطوير المركبات المزوّدة ببرامج (SDV) في نظام التشغيل Android Automotive (على سبيل المثال، دعم محاكي Cuttlefish ودعم لغة VSIDL)

تثبيت استوديو Android للنظام الأساسي

لتثبيت ASfP، اتّبِع الخطوات التالية:

1. نزِّل Android Studio for Platform.

2. اختَر الإصدار الذي يناسب احتياجاتك على أفضل وجه:

   • الإصدار الثابت: هو أحدث إصدار علني، وننصح به معظم المستخدمين
   • Canary: إصدارات تتيح استخدام الميزات الجديدة قبل إطلاقها، ولكنها قد تكون أقل ثباتًا

3. اتّبِع تعليمات التثبيت المتوفّرة في صفحة التنزيل.

إعداد مشروع SDV على نظام التشغيل Android Automotive

لإعداد مشروع "مركبة محدّدة البرامج" (SDV) في نظام التشغيل Android Automotive OS، اتّبِع الخطوات التالية:

1. تأكَّد من إمكانية الوصول إلى مستودع الرموز البرمجية لـ AAOS SDV ومن أنّك قد بدأت عملية استخراج محلية وربطتها. راجِع مقالة التنزيل والإنشاء والتنفيذ للحصول على تفاصيل حول الوصول إلى المصدر وبدء المستودع.

2. شغِّل استوديو Android للنظام الأساسي.

3. إذا كنت تستخدم هذه الميزة للمرة الأولى، اتّبِع "معالج الإعداد" لتخصيص بيئة التطوير.

4. إنشاء مشروع جديد:

   • إذا لم يكن لديك مشروع مفتوح، انقر على جديد في شاشة الترحيب.
   • إذا كان لديك مشروع مفتوح، انقر على فتح أو اختَر ASfP > المشروع > استيراد مشروع ASfP من القائمة.

5. املأ تفاصيل إعداد المشروع في المعالج:

   • استخراج المستودع: حدِّد المسار المطلق إلى جذر عملية استخراج الرمز المصدري المحلي لأداة تطوير البرامج (SDV) في نظام التشغيل Android Automotive (على سبيل المثال، /path/to/sdv_source).

   • هدف الغداء: أدخِل هدف الغداء المناسب لتطوير AAOS SDV على Cuttlefish، على سبيل المثال، sdv_core_cf-trunk_staging-userdebug. اطّلِع على اختيار هدف لمعرفة المزيد من الأهداف المتاحة.

   • مصادر المشروع: أدرِج الأدلة أو الوحدات الأولية التي تريد تضمينها في مشروعك أو انقر على رمز المجلد لفتح متصفح نظام الملفات واختيار الأدلة. يؤثر اختيار عدد كبير جدًا من الأدلة أو الوحدات في عملية الفهرسة وأداء البحث في بيئة التطوير المتكاملة، لذا يجب تضمين الأدلة أو الوحدات ذات الصلة فقط.

   • اللغات المتوافقة: اختَر Rust وC++ كلغات متوافقة.

   • اسم المشروع: أدخِل اسمًا وصفيًا لمشروعك.

   • إنهاء عملية الإعداد: انقر على إنهاء. ينشئ ASfP بنية المشروع وملف الإعداد .asfp-project.

يبدأ ASfP تلقائيًا عملية مزامنة أولية. تحلّل ASfP رمز المصدر، وتحدّد التبعيات باستخدام نظام التصميم Soong، وتنشئ المعلومات اللازمة لميزات "فهم الرموز". قد يستغرق ذلك وقتًا طويلاً، خاصةً عند المزامنة للمرة الأولى.

تخصيص المشروع

يتيح ملف .asfp-project في جذر مشروعك إجراء المزيد من التخصيصات. يمكنك تعديل هذا الملف لإجراء ما يلي:

• إضافة أدلة ووحدات أو إزالتها
• تفعيل إمكانية استخدام لغات أخرى، مثل C++‎ أو Rust (تكون Java وKotlin هما اللغتان التلقائيتان)
• ضبط علامات الإنشاء

لإجراء تغييرات على ملف الإعداد، اختَر ASfP > المشروع > فتح ملف الإعداد. يمكنك الاطّلاع على نظرة عامة على المشاريع لمعرفة خيارات الإعداد المتاحة.

تصحيح الأخطاء والاختبار

لتصحيح أخطاء الرمز واختباره في "منصة AdSense لمنصات النشر"، يمكنك الاطّلاع على تصحيح أخطاء رمز المنصة واختبار رمز المنصة باستخدام atest.

عمليات الدمج المتاحة

تتضمّن "منصة تطوير تطبيقات Android للسيارات" بعض عمليات الدمج المفيدة لتطوير المركبات المحدّدة بالبرامج في نظام التشغيل Android Automotive، بما في ذلك التوافق مع Cuttlefish وبروتوكول خادم اللغة (LSP) في VSIDL.

المكوّن الإضافي Cuttlefish

تتيح إضافة Cuttlefish للمستخدمين إنشاء أجهزة Cuttlefish محلية وتشغيلها مباشرةً من ASfP.

تثبيت المكوّن الإضافي

يتم تثبيت مكوّن Cuttlefish الإضافي مسبقًا مع ASfP ولا يتطلّب أي عملية إعداد. يتطلّب البرنامج المساعد تثبيت أدوات Cuttlefish على الجهاز. اتّبِع التعليمات لتثبيت أدوات Cuttlefish إذا لزم الأمر.

إنشاء جهاز Cuttlefish

لإنشاء جهاز جديد، اتّبِع الخطوات التالية:

1. افتح نافذة أداة "إدارة الأجهزة" من خلال اختيار أدوات > إدارة الأجهزة أو النقر على رمز الأجهزة قيد التشغيل في اللوحة اليمنى إذا كانت أداة "إدارة الأجهزة" مثبّتة هناك.

2. انقر على الرمز + واختَر إنشاء جهاز Cuttlefish.

3. اضبط إعدادات جهاز Cuttlefish الجديد. يمكنك إنشاء أجهزة Cuttlefish بطريقتَين:

   • من عملية استخراج شجرة مصدر Android المحلية:

     • اختَر مسار العنصر المستهدف الذي تم إنشاؤه والذي يتوافق مع إعدادات التشغيل (راجِع اختيار عنصر مستهدف لمزيد من التفاصيل).
     • اختَر مسار المضيف.
     • يمكنك اختياريًا اختيار إعدادات الجهاز المتاحة أو بدون إعدادات للحصول على الإعدادات التلقائية.

   • من الإعدادات الأساسية (استخدِم هذا الخيار لإنشاء أجهزة متعددة من الإعدادات الفردية):

     • اختَر مسار إعدادات الجهاز.
     • اختياريًا، قدِّم أي علامات إلغاء لتجاوز خيارات الإعداد.

4. انتظِر إلى أن يتم إنشاء جهاز Cuttlefish وإضافته إلى قائمة الأجهزة قيد التشغيل في "أداة إدارة الأجهزة".

5. اختَر جهاز Cuttlefish من قائمة الأجهزة قيد التشغيل.

يمكنك بدء أجهزة Cuttlefish الفردية أو إيقافها من خلال النقر على رمز الإيقاف أو البدء بجانب الجهاز في "أداة إدارة الأجهزة".

الوصول إلى صفحة جهاز Cuttlefish

يحتوي مكوّن Cuttlefish الإضافي على نافذة أدوات تعرض صفحة جهاز Cuttlefish، حيث يمكنك الوصول إلى ميزات مشاركة الشاشة.

لفتح نافذة الأدوات Cuttlefish، انقر على الرمز ... في اللوحة الجانبية اليمنى واختَر Cuttlefish. يمكنك أيضًا البحث عن Cuttlefish في عنصر القائمة مساعدة > البحث عن إجراء.

بروتوكول خادم اللغة في VSIDL

في VSIDL، يوفّر LSP مجموعة كبيرة من ميزات بيئة التطوير المتكاملة لتحسين سير عملك في التطوير عند العمل مع ملفات VSIDL (التي تحمل الامتداد .vsidl) في ASfP.

تمييز البنية الدلالية

يوفّر خادم LSP تمييزًا للتركيب اللغوي استنادًا إلى ملفات VSIDL.

• الوظيفة: تمييز الكلمات الرئيسية (service_bundle وpublisher) والحقول (package: وmessage:) والنصوص الحرفية

• كيفية التجربة: افتح أي ملف VSIDL. يتم ترميز الملف بالألوان للتمييز بين الكلمات الرئيسية البنيوية والمعرّفات التي يحدّدها المستخدم.

بيانات التشخيص المباشرة (الأخطاء والتحذيرات)

يتحقّق خادم LSP باستمرار من صحة الملفات ويبلغ عن المشاكل في الوقت الفعلي.

• الوظيفة: يرصد هذا الإجراء أخطاء البنية وأخطاء المراجع غير الصالحة للأنواع وغيرها من الأخطاء في جميع أجزاء قائمة الأعمال وتبعياتها.

• كيفية تجربة هذه الميزة: أدخِل خطأ إملائيًا في اسم رسالة (على سبيل المثال، TiiirePressure). سيظهر خط أحمر متعرّج تحت الخطأ الإملائي. مرِّر مؤشر الماوس فوق الكلمة للاطّلاع على رسالة الخطأ، أو اعرض القائمة الكاملة في نافذة الأدوات المشاكل في أسفل بيئة التطوير المتكاملة.

التنقّل والذكاء

يمكنك استخدام ميزات التنقّل والذكاء لاستكشاف العلاقات بين الأجزاء المختلفة من كتالوج VSIDL.

• الإكمال التلقائي: اضغط على Control+Space للاطّلاع على اقتراحات بشأن الكلمات الرئيسية ورسائل مخزن البروتوكولات المؤقت وخدمات الإجراء عن بُعد والمواضيع والقنوات. تتضمّن اقتراحات الكلمات الرئيسية شرحًا موجزًا ومفيدًا للغرض منها مباشرةً في قائمة الإكمال. تقدّم LSP أيضًا مقتطفات ذكية للكتل، مثل publisher أو server، لتسريع سير عملك.

• الانتقال إلى تعريف: اضغط مع الاستمرار على Control وانقر (أو اضغط على Control+B) على رسالة أو خدمة أو موضوع أو مرجع قناة للانتقال مباشرةً إلى تعريف المصدر، حتى إذا كان في ملف VSIDL أو protobuf مختلف.

• العثور على مراجع: ضَع المؤشر على الكلمة الرئيسية publisher أو subscriber أو server أو client، ثم اضغط على Alt+Shift+F7 للعثور على جميع المَواضع التي تظهر فيها.

• معلومات التمرير: حرِّك المؤشر إلى نوع أو سمة (أو اضغط على Control+Q). ستظهر تلميحة أدوات تعرض تعليقات التوثيق (إذا كانت متوفرة).

الميزات البنيوية

يساعدك خادم LSP في إدارة بنية ملفات VSIDL الكبيرة والتنقّل فيها:

• رموز المستند (المخطط التفصيلي): اضغط على Control+F12 للحصول على تلميح سريع للتنقل، أو افتح نافذة الأداة البنية (Control+Alt+7) للاطّلاع على عرض شجري لجميع الحِزم والوحدات في الملف.

• نطاقات الطيّ: انقر على الرمز > أو V في الهامش (بجانب أرقام الأسطر) لتصغير أو توسيع كتل منطقية كبيرة، مثل service_bundle أو تعريفات الربط.

• تنسيق المستند: اضغط على Control+Alt+L لإعادة تنسيق الملف تلقائيًا، ما يؤدي إلى إنشاء مسافة بادئة ومسافة متسقتَين.