أدوات التحكم في المصدر

يتطلب العمل باستخدام كود Android استخدام كل من Git (نظام تحكم في الإصدار مفتوح المصدر) و Repo (أداة لإدارة المستودعات مبنية من Google وتعمل على قمة Git). راجع صفحة سير عمل التحكم بالمصدر للحصول على ملخص للإجراءات العادية التي يمكنك اتخاذها ، مثل تحميل التغييرات للمراجعة.

شخص سخيف

يتعامل Git مع المشاريع الكبيرة الموزعة على مستودعات متعددة. يستخدم Android Git للعمليات المحلية مثل التفريع المحلي والالتزامات والاختلافات والتعديلات. كان أحد التحديات في إعداد مشروع Android هو تحديد أفضل طريقة لدعم المجتمع الخارجي - من مجتمع الهواة إلى الشركات المصنعة للمعدات الأصلية الكبيرة التي تبني أجهزة استهلاكية في السوق الشامل. أرادت Google أن تكون المكونات قابلة للاستبدال ، وأرادت أن يكون للمكونات الممتعة حياة خاصة بها ، خارج نظام Android. اختارت Google أولاً نظام تحكم في المراجعة الموزعة ، ثم حصره في Git.

لمزيد من التفاصيل حول Git ، راجع وثائق Git هذه.

الريبو

يقوم Repo بتوحيد مستودعات Git عند الضرورة ، ويقوم بالتحميلات إلى نظام التحكم في مراجعة Gerrit ، وأتمتة أجزاء من سير عمل تطوير Android.

يوفر برنامج Repo Launcher نصًا بلغة Python يقوم بتهيئة الخروج وتنزيل الجزء الثاني ، وهو أداة Repo الكاملة. يتم تضمين أداة Repo الكاملة في عملية دفع رمز مصدر Android. إنه موجود افتراضيًا في $SRCDIR/.repo/repo/... ويتلقى الأوامر المعاد توجيهها من Repo Launcher الذي تم تنزيله.

لا يحل Repo محل Git ، فهو يجعل من السهل العمل مع Git في سياق Android. يستخدم Repo ملفات البيان لتجميع مشاريع Git في مشروع Android الخارق. يمكنك وضع أمر repo ، وهو نص برمجي Python قابل للتنفيذ ، في أي مكان في مسارك. عند العمل مع ملفات مصدر Android ، يمكنك استخدام Repo للعمليات عبر الشبكة مثل دليل عمل Repo واحد.

في معظم الحالات ، يمكنك استخدام Git بدلاً من Repo ، أو مزج أوامر Repo و Git لتكوين أوامر معقدة. ومع ذلك ، فإن استخدام Repo للعمليات الأساسية عبر الشبكة يجعل عملك أكثر بساطة. لمزيد من التفاصيل حول Repo ، راجع مرجع أوامر Repo و Repo README وخطافات التحميل المسبق (الاختبارات) التي يمكن تمكينها في Repo والمستندات العامة في AOSP .

لتنزيل برنامج Repo Launcher وتثبيته من تنزيلات git-repo ، راجع تثبيت Repo .

جيريت

Gerrit هو نظام مراجعة التعليمات البرمجية المستند إلى الويب للمشاريع التي تستخدم Git. يشجع Gerrit استخدام أكثر مركزية لـ Git من خلال السماح لجميع المستخدمين المصرح لهم بإرسال التغييرات ، والتي يتم دمجها تلقائيًا إذا اجتازوا مراجعة الكود. بالإضافة إلى ذلك ، يجعل Gerrit عملية المراجعة سهلة ، وعرض التغييرات جنبًا إلى جنب في المتصفح وتمكين التعليقات المضمنة.

ابحث عن واجهة مراجعة Android Gerrit على android-review.googlesource.com وواجهة تنقل التعليمات البرمجية على android.googlesource.com .

يسمح لك Android Code Search بالبحث عن AOSP دون تنزيل أي شيء. يمكنك استخدام Code Search لعرض كود مصدر AOSP ، والتبديل بين الفروع مفتوحة المصدر ، والتنقل بين المراجع التبادلية. لمزيد من المعلومات ، راجع موقع Google Developers للحصول على وثائق Code Search .

أدوات أخرى

Android Studio هي بيئة التطوير المتكاملة الرسمية (IDE) لتطوير تطبيقات Android.

يتيح لك Android Debug Bridge (ADB) توصيل محطة عمل التطوير الخاصة بك مباشرة بجهاز Android الخاص بك حتى تتمكن من تثبيت الحزم وتقييم التغييرات.

لنظام Android 10 والإصدارات الأحدث ، استخدم IntelliJ مع AIDEgen IDE لتطوير منصة Android.

تثبيت الريبو

اتبع هذه الخطوات لتثبيت الريبو.

  1. قم بتشغيل هذه الأوامر لاستخدام الحزمة الرسمية من توزيعة Linux الخاصة بك:
      sudo apt-get update
      sudo apt-get install repo
    
    إذا لم تعمل هذه الأوامر مع نظامك - على سبيل المثال ، ستلاحظ أن إصدار الحزمة قديم ، أو أنه لا توجد حزمة رسمية متاحة من توزيع Linux ، قم بتثبيت Repo يدويًا باستخدام الأوامر التالية:
    export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
    curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
    gpg --recv-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
    
  2. تقوم هذه الأوامر بإعداد ملف مؤقت ، وتنزيل الريبو إليه ، والتحقق من أن المفتاح المقدم يتوافق مع المفتاح المطلوب. في حالة نجاحها ، يستمر التثبيت.

    بعد التثبيت ، تحقق من أن repo version يُبلغ عن شيء مشابه لما يلي عند تشغيله في دليل عادي. (الدليل العادي ليس جزءًا من عميل الريبو ؛ على سبيل المثال ، هو الدليل الرئيسي الخاص بك.)

  3. قم بتشغيل هذا الأمر:
  4. repo version
  5. توقع تقريرًا مشابهًا لهذا التقرير:
  6. <repo not installed>
    repo launcher version 2.15
    (from /usr/bin/repo)
    
    • يشير رقم repo launcher version الذي يبلغ 2.15 أو أعلى إلى رقم الإصدار الصحيح والتثبيت المناسب.
    • (from /usr/bin/repo) يشير إلى التثبيت من حزمة.
    • (from /home/<>/bin/repo) يشير إلى التثبيت اليدوي.

إتمام التثبيت

التالي: لإكمال تثبيت أداة Repo بالكامل ، راجع تهيئة عميل Repo ، في صفحة تنزيل المصدر .