پشتیبانی از نسخه های قدیمی تر، پشتیبانی از نسخه های قدیمی تر

توجه: این الزامات فقط برای ساخت نسخه‌های قدیمی‌تر اندروید اعمال می‌شود. برای شاخه master پروژه منبع باز Android (AOSP)، به الزامات استاندارد و ایجاد محیط ساخت مراجعه کنید.

ساخت نسخه های قدیمی اخیر (>= 5.0 Lollipop)

برای نسخه های اندروید 8.0 (Oreo یا O) – 5.0 (Lollipop یا L)، استفاده از Dockerfile ارائه شده را برای سهولت نصب همه بسته های مورد نیاز در نظر بگیرید.

توجه: ساخت نسخه‌های جدید پلتفرم Android در Mac OS X از ۲۲ ژوئن ۲۰۲۱ پشتیبانی نمی‌شود. با این حال، نسخه‌های قدیمی‌تر Android همچنان در مک قابل ساخت هستند.

ساخت نسخه های بسیار قدیمی (<= 4.4 KitKat)

سیستم های عامل

اندروید معمولاً با گنو/لینوکس ساخته می‌شود. همچنین امکان ساخت اندروید در ماشین مجازی روی سیستم های پشتیبانی نشده مانند ویندوز وجود دارد.

توصیه می‌کنیم بر روی گنو/لینوکس بسازید. سیستم ساخت آندروید معمولاً ART را روی دستگاه ساخت اجرا می‌کند تا فایل‌های DEX سیستم را از قبل کامپایل کند. ART فقط بر روی لینوکس قابل اجرا است، بنابراین سیستم ساخت این مرحله پیش‌کامپایل را در سیستم‌عامل‌های غیر لینوکس نادیده می‌گیرد و در نتیجه یک ساخت اندروید با عملکرد کاهش می‌یابد.

گنو/لینوکس

• Android 6.0 (Marshmallow) – AOSP Master: Ubuntu 14.04 (Trusty)
• Android 2.3.x (نان زنجبیلی) – Android 5.x (Lollipop): اوبونتو 12.04 (دقیق)
• Android 1.5 (Cupcake) – Android 2.2.x (Froyo): Ubuntu 10.04 (Lucid)

Mac OS X (Intel/x86)

• Android 6.0 (Marshmallow) – AOSP Master: Mac OS X v10.10 (Yosemite) یا بالاتر با Xcode 4.5.2 و Command Line Tools
• Android 5.x (Lollipop): Mac OS X v10.8 (Mountain Lion) با Xcode 4.5.2 و Command Line Tools
• Android 4.1.x (Jelly Bean) – Android 4.4.x (KitKat): Mac OS X v10.6 (Snow Leopard) یا Mac OS X v10.7 (Lion) و Xcode 4.2 (ابزارهای توسعه دهنده اپل)
• Android 1.5 (Cupcake) – Android 4.0.x (Ice Cream Sandwich): Mac OS X v10.5 (Leopard) یا Mac OS X v10.6 (Snow Leopard) و Mac OS X v10.5 SDK

ساخت گنو

برای نسخه‌های پایین‌تر از شاخه اصلی AOSP از طریق Android 4.1.x (Jelly Bean)، از GNU make (gmake) 3.82 استفاده کنید. برای Android 4.0.x (Ice Cream Sandwich) و پایین تر، از gmake 3.82 برگردید تا از خطاهای ساخت جلوگیری کنید.

Xcode و بسته های دیگر

برای نسخه‌های پایین‌تر Mac OS X نسخه 10.8 یا پایین‌تر، Xcode را از سایت برنامه‌نویس اپل نصب کنید. اگر قبلاً به عنوان یک توسعه دهنده اپل ثبت نام نکرده اید، باید یک Apple ID برای دانلود ایجاد کنید.

اگر از Mac OS X نسخه 10.4 استفاده می کنید، Bison را نیز نصب کنید:

    POSIXLY_CORRECT=1 sudo port install bison

برای MacPort ها، مشکل:

    POSIXLY_CORRECT=1 sudo port install gmake libsdl git gnupg

برای Homebrew، شماره:

    brew install gmake libsdl git gnupg2

بازگشت از gmake 3.82

در Android 4.0.x (Ice Cream Sandwich) و پایین‌تر، gmake 3.82 باگی دارد که از ساخت اندروید جلوگیری می‌کند. شما می توانید نسخه 3.81 را با استفاده از MacPort با این مراحل نصب کنید:

1. /opt/local/etc/macports/sources.conf ویرایش کنید و این خط را اضافه کنید:

       file:///Users/Shared/dports

   بالای خط rsync. سپس این دایرکتوری را ایجاد کنید:

       mkdir /Users/Shared/dports

2. در دایرکتوری جدید dports ،

       svn co --revision 50980 http://svn.macports.org/repository/macports/trunk/dports/devel/gmake/ devel/gmake/

   را اجرا کنید
3. یک فهرست پورت برای مخزن محلی جدید خود ایجاد کنید:

       portindex /Users/Shared/dports

4. نسخه قدیمی gmake:

       sudo port install gmake @3.81

   را نصب کنید

JDK

نسخه های پشتیبانی شده

• اندروید 7.0 (نوقا) – اندروید 8.0 (اوریو):
  • اوبونتو: OpenJDK 8
  • Mac OS X: JDK 8u45 یا بالاتر
• Android 5.x (Lollipop) – Android 6.0 (Marshmallow):
  • اوبونتو: OpenJDK 7
  • Mac OS X: jdk-7u71-macosx-x64.dmg
• Android 2.3.x (Gingerbread) – Android 4.4.x (KitKat):
  • اوبونتو: جاوا JDK 6
  • Mac OS X: Java JDK 6
• Android 1.5 (Cupcake) – Android 2.2.x (Froyo):
  • اوبونتو: جاوا JDK 5

JDK برای لینوکس

شاخه master اندروید در پروژه منبع باز اندروید (AOSP) با نسخه های از پیش ساخته شده OpenJDK در زیر prebuilts/jdk/ ارائه می شود، بنابراین نیازی به نصب اضافی نیست.

نسخه های پایین تر اندروید نیاز به نصب جداگانه JDK دارند. در اوبونتو، از OpenJDK استفاده کنید.

برای اوبونتو 15.04 و بالاتر

موارد زیر را اجرا کنید:

sudo apt-get update
sudo apt-get install openjdk-8-jdk

برای اوبونتو LTS 14.04

هیچ بسته پشتیبانی شده OpenJDK 8 برای اوبونتو 14.04 وجود ندارد. بسته های اوبونتو 15.04 OpenJDK 8 با موفقیت با اوبونتو 14.04 استفاده شده است. نسخه های بسته بالاتر (به عنوان مثال، نسخه های 15.10، 16.04) با استفاده از دستورالعمل های زیر در 14.04 کار نمی کنند.

1. بسته های .deb را برای معماری 64 بیتی از old-releases.ubuntu.com دانلود کنید :
   • openjdk-8-jre-headless_8u45-b14-1_amd64.deb
     با SHA256 0f5aba8db39088283b51e00054813063173a4d8809f70033976f83e214ab56c0
   • openjdk-8-jre_8u45-b14-1_amd64.deb
     با SHA256 9ef76c4562d39432b69baf6c18f199707c5c56a5b4566847df908b7d74e15849
   • openjdk-8-jdk_8u45-b14-1_amd64.deb
     با SHA256 6e47215cf6205aa829e6a0a64985075bd29d1f428a4006a80c9db371c2fc3c4c
2. در صورت تمایل، چک‌جمع‌های فایل‌های دانلود شده را در برابر رشته SHA256 که با هر بسته در بالا فهرست شده است، تأیید کنید. به عنوان مثال، با ابزار sha256sum :

       sha256sum {downloaded.deb file}

3. بسته ها را نصب کنید:

       sudo apt-get update

   dpkg را برای هر یک از فایل های .deb که دانلود کرده اید اجرا کنید. ممکن است به دلیل وابستگی های از دست رفته خطا ایجاد کند:

       sudo dpkg -i {downloaded.deb file}

   برای رفع وابستگی های از دست رفته:

       sudo apt-get -f install

(اختیاری) نسخه پیش فرض جاوا را به روز کنید

در صورت تمایل، برای نسخه‌های اوبونتو بالا، نسخه پیش‌فرض جاوا را با اجرای:

sudo update-alternatives --config java
sudo update-alternatives --config javac

توجه: در حین ساخت، اگر با خطاهای نسخه برای جاوا مواجه شدید، برای دلایل و راه حل های احتمالی نسخه جاوا اشتباه را ببینید.

،

توجه: این الزامات فقط برای ساخت نسخه‌های قدیمی‌تر اندروید اعمال می‌شود. برای شاخه master پروژه منبع باز Android (AOSP)، به الزامات استاندارد و ایجاد محیط ساخت مراجعه کنید.

ساخت نسخه های قدیمی اخیر (>= 5.0 Lollipop)

برای نسخه های اندروید 8.0 (Oreo یا O) – 5.0 (Lollipop یا L)، استفاده از Dockerfile ارائه شده را برای سهولت نصب همه بسته های مورد نیاز در نظر بگیرید.

توجه: ساخت نسخه‌های جدید پلتفرم Android در Mac OS X از ۲۲ ژوئن ۲۰۲۱ پشتیبانی نمی‌شود. با این حال، نسخه‌های قدیمی‌تر Android همچنان در مک قابل ساخت هستند.

ساخت نسخه های بسیار قدیمی (<= 4.4 KitKat)

سیستم های عامل

اندروید معمولاً با گنو/لینوکس ساخته می‌شود. همچنین امکان ساخت اندروید در ماشین مجازی روی سیستم های پشتیبانی نشده مانند ویندوز وجود دارد.

توصیه می‌کنیم بر روی گنو/لینوکس بسازید. سیستم ساخت آندروید معمولاً ART را روی دستگاه ساخت اجرا می‌کند تا فایل‌های DEX سیستم را از قبل کامپایل کند. ART فقط بر روی لینوکس قابل اجرا است، بنابراین سیستم ساخت این مرحله پیش‌کامپایل را در سیستم‌عامل‌های غیر لینوکس نادیده می‌گیرد و در نتیجه یک ساخت اندروید با عملکرد کاهش می‌یابد.

گنو/لینوکس

• Android 6.0 (Marshmallow) – AOSP Master: Ubuntu 14.04 (Trusty)
• Android 2.3.x (نان زنجبیلی) – Android 5.x (Lollipop): اوبونتو 12.04 (دقیق)
• Android 1.5 (Cupcake) – Android 2.2.x (Froyo): Ubuntu 10.04 (Lucid)

Mac OS X (Intel/x86)

• Android 6.0 (Marshmallow) – AOSP Master: Mac OS X v10.10 (Yosemite) یا بالاتر با Xcode 4.5.2 و Command Line Tools
• Android 5.x (Lollipop): Mac OS X v10.8 (Mountain Lion) با Xcode 4.5.2 و Command Line Tools
• Android 4.1.x (Jelly Bean) – Android 4.4.x (KitKat): Mac OS X v10.6 (Snow Leopard) یا Mac OS X v10.7 (Lion) و Xcode 4.2 (ابزارهای توسعه دهنده اپل)
• Android 1.5 (Cupcake) – Android 4.0.x (Ice Cream Sandwich): Mac OS X v10.5 (Leopard) یا Mac OS X v10.6 (Snow Leopard) و Mac OS X v10.5 SDK

ساخت گنو

برای نسخه‌های پایین‌تر از شاخه اصلی AOSP از طریق Android 4.1.x (Jelly Bean)، از GNU make (gmake) 3.82 استفاده کنید. برای Android 4.0.x (Ice Cream Sandwich) و پایین تر، از gmake 3.82 برگردید تا از خطاهای ساخت جلوگیری کنید.

Xcode و بسته های دیگر

برای نسخه‌های پایین‌تر Mac OS X نسخه 10.8 یا پایین‌تر، Xcode را از سایت برنامه‌نویس اپل نصب کنید. اگر قبلاً به عنوان یک توسعه دهنده اپل ثبت نام نکرده اید، باید یک Apple ID برای دانلود ایجاد کنید.

اگر از Mac OS X نسخه 10.4 استفاده می کنید، Bison را نیز نصب کنید:

    POSIXLY_CORRECT=1 sudo port install bison

برای MacPort ها، مشکل:

    POSIXLY_CORRECT=1 sudo port install gmake libsdl git gnupg

برای Homebrew، شماره:

    brew install gmake libsdl git gnupg2

بازگشت از gmake 3.82

در Android 4.0.x (Ice Cream Sandwich) و پایین‌تر، gmake 3.82 باگی دارد که از ساخت اندروید جلوگیری می‌کند. شما می توانید نسخه 3.81 را با استفاده از MacPort با این مراحل نصب کنید:

1. /opt/local/etc/macports/sources.conf ویرایش کنید و این خط را اضافه کنید:

       file:///Users/Shared/dports

   بالای خط rsync. سپس این دایرکتوری را ایجاد کنید:

       mkdir /Users/Shared/dports

2. در دایرکتوری جدید dports ،

       svn co --revision 50980 http://svn.macports.org/repository/macports/trunk/dports/devel/gmake/ devel/gmake/

   را اجرا کنید
3. یک فهرست پورت برای مخزن محلی جدید خود ایجاد کنید:

       portindex /Users/Shared/dports

4. نسخه قدیمی gmake:

       sudo port install gmake @3.81

   را نصب کنید

JDK

نسخه های پشتیبانی شده

• اندروید 7.0 (نوقا) – اندروید 8.0 (اوریو):
  • اوبونتو: OpenJDK 8
  • Mac OS X: JDK 8u45 یا بالاتر
• Android 5.x (Lollipop) – Android 6.0 (Marshmallow):
  • اوبونتو: OpenJDK 7
  • Mac OS X: jdk-7u71-macosx-x64.dmg
• Android 2.3.x (Gingerbread) – Android 4.4.x (KitKat):
  • اوبونتو: جاوا JDK 6
  • Mac OS X: Java JDK 6
• Android 1.5 (Cupcake) – Android 2.2.x (Froyo):
  • اوبونتو: جاوا JDK 5

JDK برای لینوکس

شاخه master اندروید در پروژه منبع باز اندروید (AOSP) با نسخه های از پیش ساخته شده OpenJDK در زیر prebuilts/jdk/ ارائه می شود، بنابراین نیازی به نصب اضافی نیست.

نسخه های پایین تر اندروید نیاز به نصب جداگانه JDK دارند. در اوبونتو، از OpenJDK استفاده کنید.

برای اوبونتو 15.04 و بالاتر

موارد زیر را اجرا کنید:

sudo apt-get update
sudo apt-get install openjdk-8-jdk

برای اوبونتو LTS 14.04

هیچ بسته پشتیبانی شده OpenJDK 8 برای اوبونتو 14.04 وجود ندارد. بسته های اوبونتو 15.04 OpenJDK 8 با موفقیت با اوبونتو 14.04 استفاده شده است. نسخه های بسته بالاتر (به عنوان مثال، نسخه های 15.10، 16.04) با استفاده از دستورالعمل های زیر در 14.04 کار نمی کنند.

1. بسته های .deb را برای معماری 64 بیتی از old-releases.ubuntu.com دانلود کنید :
   • openjdk-8-jre-headless_8u45-b14-1_amd64.deb
     با SHA256 0f5aba8db39088283b51e00054813063173a4d8809f70033976f83e214ab56c0
   • openjdk-8-jre_8u45-b14-1_amd64.deb
     با SHA256 9ef76c4562d39432b69baf6c18f199707c5c56a5b4566847df908b7d74e15849
   • openjdk-8-jdk_8u45-b14-1_amd64.deb
     با SHA256 6e47215cf6205aa829e6a0a64985075bd29d1f428a4006a80c9db371c2fc3c4c
2. در صورت تمایل، چک‌جمع‌های فایل‌های دانلود شده را در برابر رشته SHA256 که با هر بسته در بالا فهرست شده است، تأیید کنید. به عنوان مثال، با ابزار sha256sum :

       sha256sum {downloaded.deb file}

3. بسته ها را نصب کنید:

       sudo apt-get update

   dpkg را برای هر یک از فایل های .deb که دانلود کرده اید اجرا کنید. ممکن است به دلیل وابستگی های از دست رفته خطا ایجاد کند:

       sudo dpkg -i {downloaded.deb file}

   برای رفع وابستگی های از دست رفته:

       sudo apt-get -f install

(اختیاری) نسخه پیش فرض جاوا را به روز کنید

در صورت تمایل، برای نسخه‌های اوبونتو بالا، نسخه پیش‌فرض جاوا را با اجرای:

sudo update-alternatives --config java
sudo update-alternatives --config javac

توجه: در حین ساخت، اگر با خطاهای نسخه برای جاوا مواجه شدید، برای دلایل و راه حل های احتمالی نسخه جاوا اشتباه را ببینید.