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 برای عملیات محلی مانند انشعابات محلی ، تعهدات ، تغییرات و ویرایش ها استفاده می کند. یکی از چالش های راه اندازی پروژه اندروید این بود که چطور می توان به بهترین شکل از جامعه خارج حمایت کرد - از جامعه سرگرمی گرفته تا OEM های بزرگ که دستگاه های مصرف کننده در بازار گسترده تولید می کنند. ما می خواستیم که اجزای سازنده قابل تعویض باشند و اجزای جالب نیز می خواهند زندگی خارج از اندروید خود را داشته باشند. ما ابتدا یک سیستم کنترل بازبینی توزیع شده را انتخاب کردیم ، سپس آن را به Git محدود کردیم.

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

مخزن

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

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

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

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

ابزارهای دیگر

Gerrit یک سیستم بررسی کد مبتنی بر وب برای پروژه هایی است که از Git استفاده می کنند. گریت با اجازه دادن به همه کاربران مجاز برای ایجاد تغییراتی ، که به طور خودکار ادغام می شوند در صورت بازبینی کد ، استفاده از Git را تشویق می کند. علاوه بر این ، گریت بررسی را آسان می کند ، تغییرات را در کنار هم در مرورگر نمایش می دهد و نظرات درون را امکان پذیر می کند.

Android Code Search به شما امکان می دهد بدون بارگیری چیزی در AOSP جستجو کنید. برای مشاهده کد منبع AOSP ، جابجایی بین شاخه های منبع باز و پیمایش منابع متقابل می توانید از Code Search استفاده کنید. برای اطلاعات بیشتر ، به مستندات جستجوی کد به سایت Google Developers مراجعه کنید.

Android Studio محیط رسمی توسعه یکپارچه (IDE) برای توسعه برنامه Android است.

نصب Repo

Repo ابزاری است که کار با Git را در زمینه Android آسان می کند. برای بررسی هدف و پیوند به اسناد مرتبط ، به بررسی اجمالی Repo در بالا مراجعه کنید.

Repo به دو قسمت ارائه می شود: یکی اسکریپت راه اندازی کننده ای است که نصب می کنید ، و با قسمت دوم ، ابزار 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
    

repo قدیمی تر برای سیستم های قدیمی Python 2

اگر از سیستم قدیمی بدون پایتون 3.6+ استفاده می کنید ، سعی کنید نسخه قدیمی نسخه پرتاب کننده Repo را بارگیری کنید که هنوز از Python 2.7 پشتیبانی می کند. این کار به طور نامحدود کار نمی کند اما ممکن است تا زمان ارتقا سیستم شما کمک کند.

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