ابزارهای کنترل منبع

کار با کد اندروید نیازمند استفاده از Git (یک سیستم کنترل نسخه منبع باز) و Repo (ابزار مدیریت مخزن ساخته شده توسط گوگل است که در بالای Git اجرا می شود). برای خلاصه ای از اقدامات معمولی که می توانید انجام دهید، مانند بارگذاری تغییرات برای بررسی، به صفحه گردش کار منبع کنترل مراجعه کنید.

Git

Git پروژه های بزرگی را مدیریت می کند که در چندین مخزن توزیع شده اند. اندروید از Git برای عملیات محلی مانند شاخه‌بندی محلی، commit‌ها، تفاوت‌ها و ویرایش‌ها استفاده می‌کند. یکی از چالش‌های راه‌اندازی پروژه اندروید، تعیین نحوه حمایت از جامعه بیرونی-از جامعه سرگرمی‌ها تا تولیدکنندگان بزرگ تولیدکننده دستگاه‌های مصرف‌کننده در بازار انبوه- بود. گوگل می‌خواست اجزا قابل تعویض باشند و می‌خواست اجزای جالبی خارج از اندروید زندگی خود را داشته باشند. گوگل ابتدا یک سیستم کنترل بازبینی توزیع شده را انتخاب کرد، سپس آن را به Git محدود کرد.

برای جزئیات بیشتر در مورد Git، به این مستندات Git مراجعه کنید.

مخزن

Repo در صورت لزوم مخازن Git را یکپارچه می کند، آپلودها را در سیستم کنترل بازبینی Gerrit انجام می دهد و بخش هایی از گردش کار توسعه Android را خودکار می کند.

راه‌انداز Repo یک اسکریپت پایتون ارائه می‌کند که یک پرداخت اولیه را آغاز می‌کند و قسمت دوم، ابزار کامل Repo را دانلود می‌کند. ابزار کامل Repo در بررسی کد منبع اندروید گنجانده شده است. به طور پیش‌فرض در $SRCDIR/.repo/repo/... قرار دارد و دستورات ارسال‌شده را از راه‌انداز Repo دانلود شده دریافت می‌کند.

Repo جایگزین Git نمی شود، فقط کار با Git را در زمینه اندروید آسان می کند. Repo از فایل های مانیفست برای جمع آوری پروژه های Git در ابرپروژه اندروید استفاده می کند. می توانید دستور repo را که یک اسکریپت اجرایی پایتون است، در هر نقطه از مسیر خود قرار دهید. در کار با فایل‌های منبع Android، می‌توانید از Repo برای عملیات‌های بین شبکه‌ای مانند با یک فهرست کاری Repo استفاده کنید.

در اکثر مواقع، می توانید به جای Repo از Git استفاده کنید یا دستورات Repo و Git را برای ایجاد دستورات پیچیده ترکیب کنید. با این حال، استفاده از Repo برای عملیات اساسی در سراسر شبکه، کار شما را بسیار ساده‌تر می‌کند. برای جزئیات بیشتر در مورد Repo، Repo Command Reference ، Repo README ، قلاب های پیش آپلود (آزمون) را که می توان در Repo فعال کرد، و اسناد عمومی در AOSP را ببینید.

برای دانلود و نصب Repo Launcher از git-repo-downloads ، به نصب 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 Debug Bridge (ADB) به شما امکان می دهد ایستگاه کاری توسعه خود را مستقیماً به دستگاه Android خود متصل کنید تا بتوانید بسته ها را نصب کرده و تغییرات خود را ارزیابی کنید.

برای Android 10 و بالاتر، از IntelliJ با AIDEgen IDE برای توسعه پلتفرم اندروید استفاده کنید.

در حال نصب Repo

برای نصب Repo این مراحل را دنبال کنید.

  1. این دستورات را برای استفاده از بسته رسمی از توزیع لینوکس خود اجرا کنید:
      sudo apt-get update
      sudo apt-get install repo
    
    اگر این دستورات برای سیستم شما کار نمی‌کردند – برای مثال، می‌بینید که نسخه بسته قدیمی است یا یک بسته رسمی در دسترس نیست. توزیع لینوکس، 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 زمانی که در یک دایرکتوری معمولی اجرا می‌شود، چیزی شبیه به زیر گزارش می‌دهد. (یک دایرکتوری معمولی بخشی از یک کلاینت repo نیست، برای مثال، دایرکتوری اصلی شما است.)

  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 مراجعه کنید.