Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

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

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

شخص سخيف

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

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

الريبو

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

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

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

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

جيريت

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 الخاص بك حتى تتمكن من تثبيت الحزم وتقييم التغييرات.

تثبيت الريبو

Repo هي أداة تسهل العمل مع Git في سياق Android. راجع نظرة عامة حول الريبو أعلاه لغرضها وروابط للمستندات ذات الصلة.

يأتي Repo في جزأين: أحدهما عبارة عن برنامج نصي للمشغل تقوم بتثبيته ، ويتصل بالجزء الثاني ، وهو أداة Repo الكاملة المضمنة في عملية دفع الكود المصدري. لتثبيت الريبو:

  1. تأكد من أن لديك bin/ دليل في دليلك الرئيسي وأنه مضمن في مسارك:

    mkdir ~/bin
    PATH=~/bin:$PATH
    
  2. قم بتنزيل Repo Launcher وتأكد من أنه قابل للتنفيذ:

    curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
    chmod a+x ~/bin/repo
    
  3. اختياريًا تحقق من أن المشغل يطابق توقيعاتنا:

    gpg --recv-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ~/bin/repo
    

أقدم الريبو لأنظمة بايثون 2 القديمة

إذا كنت تستخدم نظامًا أقدم بدون Python 3.6+ ، فحاول تنزيل إصدار أقدم من Repo Launcher الذي لا يزال يدعم Python 2.7. لن يعمل هذا إلى أجل غير مسمى ولكنه قد يساعد حتى تتم ترقية نظامك.

curl https://storage.googleapis.com/git-repo-downloads/repo-1 > ~/bin/repo
chmod a+x ~/bin/repo