إعداد بيئة التطوير

يتيح تشغيل تطبيقات Android على جهاز Chromebook للمستخدمين الوصول إلى منظومة Android المتكاملة الواسعة، كما يتيح لمطوّري تطبيقات Android فرصة الوصول إلى مستخدمي ChromeOS.

يوفّر نظام التشغيل ChromeOS لمطوّري تطبيقات Android الأدوات اللازمة لنشر تطبيقاتهم واختبارها على أجهزة Chromebook. لتحسين تجربة المستخدمين، عليك إثبات توافق تطبيقاتك مع مختلف عوامل الشكل.

سواء كنت تنشر تطبيق Android مباشرةً من ChromeOS (باستخدام Android Studio على جهاز Chromebook) أو من جهاز آخر، يمكنك استخدام Android Debug Bridge لنشر تطبيقك وتصحيح أخطاء التفاعلات المختلفة مع أجهزة Chromebook.

تفعيل خيار "تصحيح الأخطاء عبر ADB"

في السابق، كان استخدام ADB على جهاز Chromebook ممكنًا فقط في وضع المطوّرين. منذ الإصدار 81 من Chrome، يمكن للمطوّرين إبقاء أجهزتهم خارج وضع المطوّرين مع إمكانية نشر التطبيقات التي يطوّرونها مباشرةً في ChromeOS. وإليك الطريقة:

  1. انتقِل إلى الإعدادات وفعِّل Linux إذا لم يسبق لك ذلك.

    تفعيل Linux في إعدادات ChromeOS
    الشكل 1. تفعيل Linux في إعدادات ChromeOS
  2. بعد توفّر نظام التشغيل Linux، افتح إعدادات Linux.

  3. افتح الخيار تطوير تطبيقات Android.

  4. فعِّل خيار تفعيل تصحيح الأخطاء عبر ADB. تتم إعادة تشغيل جهاز Chromebook.

    تفعيل خيار "تصحيح الأخطاء عبر ADB" في إعدادات Linux
    الشكل 2. تفعيل خيار "تصحيح الأخطاء عبر ADB" في إعدادات Linux
  5. بعد إعادة تشغيل جهاز Chromebook، ستظهر رسالة لإعلامك بأنّه قد تكون هناك تطبيقات لم يتم تنزيلها من متجر التطبيقات على الجهاز.

    إشعار بشأن التطبيقات غير التابعة لمتجر Play بعد تفعيل تصحيح أخطاء ADB
    الشكل 3. إشعار بشأن التطبيقات غير التابعة لمتجر Play بعد تفعيل تصحيح أخطاء ADB
  6. يتوفّر الآن Android Debug Bridge (ADB) لنشر التطبيقات على جهاز Chromebook وتنفيذ أوامر تصحيح الأخطاء والتفاعل مباشرةً مع الجهاز.

للتأكّد من أنّ تطبيق Android يعمل بشكل جيد على مجموعة متنوعة من أجهزة Chromebook وأحجامها المتوفرة، تنصحك Google باختبار تطبيقك على الأجهزة التالية:

  • جهاز Chromebook مستند إلى معالِج البيانات ARM
  • جهاز Chromebook يستند إلى x86
  • جهاز مزوّد بشاشة تعمل باللمس وجهاز غير مزوّد بها
  • جهاز قابل للتحويل يمكن استخدامه ككمبيوتر محمول أو جهاز لوحي
  • جهاز مزوّد بقلم شاشة

النشر من ChromeOS

بعد تفعيل تصحيح أخطاء ADB، يمكنك تحميل تطبيق Android مباشرةً على جهاز ChromeOS باستخدام Android Studio. إذا كان لديك حزمة تطبيق Android (APK)، يمكنك تحميلها باستخدام الوحدة الطرفية.

النشر باستخدام "استوديو Android"

بعد إعداد استوديو Android وADB، يمكنك نقل تطبيقاتك إلى حاوية Android على جهاز Chromebook مباشرةً من "استوديو Android". يظهر جهاز Chromebook كخيار في قائمة الأجهزة:

تم إدراج جهاز Chromebook في قائمة الأجهزة في Android Studio.
الشكل 4. تم إدراج جهاز Chromebook في قائمة الأجهزة في Android Studio.

عند نقل تطبيقك إلى جهاز Chromebook، سيظهر مربع حوار تفويض ADB. بعد منح الإذن، سيتم تشغيل تطبيقك في نافذة جديدة.

منح الإذن باستخدام "أداة تصحيح أخطاء Android" (ADB) وتشغيل تطبيق من "استوديو Android"
الشكل 5. منح الإذن باستخدام "أداة تصحيح أخطاء Android" (ADB) وتشغيل تطبيق من "استوديو Android"

يمكنك الآن نشر التطبيق على جهاز Chromebook واختباره وتصحيح أخطائه.

النشر باستخدام الوحدة الطرفية

اتّبِع الخطوات التالية لنشر تطبيقك على جهاز Chromebook باستخدام الوحدة الطرفية:

  1. ثبِّت ADB إذا لزم الأمر باستخدام الأمر التالي:

    sudo apt install adb
    
  2. اتّصِل بالجهاز باستخدام الأمر التالي:

    adb connect arc
    
  3. يظهر مربّع حوار تفويض لتصحيح الأخطاء عبر USB. امنح التفويض باتّباع الخطوات التالية:

    مربّع حوار إذن تصحيح أخطاء الجهاز عبر USB
    الشكل 6. مربّع حوار إذن تصحيح أخطاء الجهاز عبر USB
  4. ثبِّت تطبيقك من الوحدة الطرفية باستخدام الأمر التالي:

    adb install [path to your APK]
    
الاتصال بجهاز Chromebook وتثبيت حزمة APK من خلال الوحدة الطرفية
الشكل 7. الاتصال بجهاز Chromebook وتثبيت حزمة APK من خلال الوحدة الطرفية

النشر من جهاز آخر

إذا لم تتمكّن من استخدام الطريقة السابقة وكنت بحاجة إلى نقل تطبيقك من جهاز آخر، يمكنك ربط الجهاز بـ ADB باستخدام اتصال USB أو عنوان شبكة.

الاتصال ببرنامج ADB عبر شبكة

اتّبِع الخطوات التالية للاتصال ببرنامج ADB عبر شبكة:

  1. تأكَّد من تفعيل خيار "تصحيح الأخطاء عبر ADB".

  2. يمكنك الحصول على عنوان IP لجهاز Chromebook باتّباع الخطوات التالية:

    • انقر على الساعة في أسفل يسار الشاشة.
    • انقر على رمز الترس.
    • انقر على نوع الشبكة التي يتصل بها جهازك، مثل شبكة Wi-Fi أو بيانات الجوّال، ثم على اسم الشبكة.
    • دوِّن عنوان IP.

للاتصال بجهاز Chromebook، اتّبِع الخطوات التالية:

  1. ارجع إلى جهاز التطوير واستخدِم ADB للاتصال بجهاز Chromebook باستخدام عنوان IP الخاص به:

    adb connect <ip_address>
    
  2. على جهاز Chromebook، انقر على السماح عندما يُطلب منك السماح ببرنامج تصحيح الأخطاء. تم إنشاء جلسة تصحيح أخطاء Android.

تحديد المشاكل في تصحيح الأخطاء عبر ADB على شبكة وحلّها

في بعض الأحيان، يظهر أنّ جهاز ADB غير متصل بالإنترنت مع أنّ كل شيء متصل بشكل صحيح. في هذه الحالة، يُرجى إكمال الخطوات التالية لتحديد المشكلة وحلّها:

  1. أوقِف تصحيح الأخطاء عبر ADB في خيارات المطوّرين.
  2. في نافذة الوحدة الطرفية، شغِّل adb kill-server.
  3. أعِد تفعيل خيار تصحيح الأخطاء عبر ADB.
  4. في نافذة الوحدة الطرفية، حاوِل تشغيل adb connect.
  5. انقر على السماح عندما يُطلب منك ذلك للسماح بتصحيح الأخطاء. يتم إنشاء جلسة ADB.

الاتصال بـ ADB عبر USB

لنقل حِزمة APK من جهاز آخر إلى جهاز Chromebook، عليك بدء تشغيل ChromeOS في وضع المطوّرين حتى تتمكّن من ضبط جهاز Chromebook ونقل التطبيقات من الجهاز المضيف.

اتّبِع الخطوات التالية للدخول إلى "وضع المطوّرين":

  1. فعِّل خيار "تصحيح الأخطاء عبر ADB".
  2. تحديد ما إذا كان جهازك يتيح تصحيح أخطاء USB
  3. اضغط على Control+Alt+T لبدء "وحدة طرفية ChromeOS".
  4. اكتب shell للوصول إلى وحدة تحكّم أوامر bash:

    crosh> shell
    chronos@localhost / $
    
  5. اكتب الأوامر التالية لإعداد جهازك:

    $ sudo crossystem dev_enable_udc=1
    $ sudo reboot
    
  6. بعد إعادة التشغيل، افتح الوحدة الطرفية مرة أخرى ونفِّذ الأمر التالي لتفعيل تصحيح أخطاء ADB على منفذ USB في جهاز Chromebook:

    $ sudo ectool usbpd <port number> dr_swap
    

استخدِم هذا الأمر في كل مرة تفصل فيها كابل USB وتعيد توصيله. للتأكّد من أنّ جهاز Chromebook في وضع منفذ مواجه للمصدر (UFP)، يمكنك تشغيل ectool usbpd <port number>.

لإنشاء جلسة تصحيح أخطاء ADB، اتّبِع الخطوات التالية:

  1. وصِّل كابل USB بمنفذ متوافق على جهازك.
  2. شغِّل adb devices من أدوات منصة Android SDK على جهازك المضيف للاطّلاع على جهاز Chromebook مُدرَجًا كجهاز متوافق مع تصحيح أخطاء Android.
  3. على جهاز Chromebook، انقر على السماح عندما يُطلب منك السماح ببرنامج تصحيح الأخطاء. تم إنشاء جلسة تصحيح أخطاء Android.