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

يتطلب العمل باستخدام كود 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 ، وهو برنامج نصي بايثون قابل للتنفيذ، في أي مكان في المسار الخاص بك. في العمل مع ملفات مصدر Android، يمكنك استخدام Repo للعمليات عبر الشبكة مثل دليل عمل Repo واحد.

في معظم الحالات، يمكنك استخدام Git بدلاً من Repo، أو مزج أوامر Repo وGit لتكوين أوامر معقدة. ومع ذلك، فإن استخدام Repo للعمليات الأساسية عبر الشبكة يجعل عملك أسهل بكثير. لمزيد من التفاصيل حول Repo، راجع Repo Command Reference و 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 للحصول على وثائق البحث عن التعليمات البرمجية .

أدوات أخرى

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

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

لتطوير AOSP، استخدم Android Studio for Platform (ASfP) .

تثبيت الريبو

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

  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-keys 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 ، في صفحة تنزيل المصدر .