ابزارهای ساخت کیت توسعه نرم‌افزار اندروید (Android SDK Build-Tools) بخشی از کیت توسعه نرم‌افزار اندروید (Android SDK) است که برای ساخت برنامه‌های اندروید مورد نیاز است. این ابزار در دایرکتوری <sdk>/build-tools/ نصب می‌شود.
شما همیشه باید کامپوننت Build Tools خود را با دانلود آخرین نسخه با استفاده از Android SDK Manager به‌روز نگه دارید. اگر از افزونه اندروید برای Gradle 3.0.0 یا بالاتر استفاده می‌کنید، پروژه شما به‌طور خودکار از نسخه پیش‌فرض ابزارهای ساختی که افزونه مشخص می‌کند استفاده می‌کند. برای استفاده از نسخه دیگری از ابزارهای ساخت، آن را با استفاده از buildToolsVersion در build.gradle ماژول خود، به شرح زیر مشخص کنید:
گرووی
android { buildToolsVersion "35.0.0" ... }
کاتلین
android { buildToolsVersion = "35.0.0" ... }
اصلاحات
بخش‌های زیر نکاتی در مورد نسخه‌های ابزارهای ساخت ارائه می‌دهند. برای تعیین اینکه کدام نسخه‌های ابزارهای ساخت در SDK شما موجود است، به فهرست بسته‌های نصب‌شده در Android SDK Manager مراجعه کنید.
ابزارهای ساخت، نسخه ۳۴.۰.۰ RC3 (آوریل ۲۰۲۳)
رفع اشکالات عمومی و بهبودها.
ابزارهای ساخت، نسخه ۳۴.۰.۰ (فوریه ۲۰۲۳)
این به‌روزرسانی شامل پشتیبانی از ساخت با APIهای پیش‌نمایش اندروید ۱۴ است.
ابزارهای ساخت، نسخه ۳۳.۰.۲ (فوریه ۲۰۲۳)
این به‌روزرسانی مشکل زیر را برطرف می‌کند:
- نسخه ۳۳.۰.۰
core-lambda-stubs.jarدر macOS با لینوکس/ویندوز متفاوت است. (به شماره ۲۳۷۲۹۹۶۹۸ مراجعه کنید.)
ابزارهای ساخت، نسخه ۳۳.۰.۱ (نوامبر ۲۰۲۲)
این به‌روزرسانی مشکل زیر را برطرف می‌کند:
- AIDL با build-tools نسخه ۳۳.۰.۰ با شکست مواجه می‌شود. (به شماره ۲۳۶۱۶۷۹۷۱ مراجعه کنید)
ابزارهای ساخت، نسخه ۳۰.۰.۰ rc4 (مه ۲۰۲۰)
این به‌روزرسانی شامل پشتیبانی از ساخت با APIهای پیش‌نمایش اندروید ۱۱ است.
ابزارهای ساخت، نسخه ۲۹.۰.۳ (ژانویه ۲۰۲۰)
این به‌روزرسانی مشکل زیر را برطرف می‌کند:
- مشکل ساخت با Renderscript در macOS Catalina. ( به مشکل #142590626 مراجعه کنید)
ابزارهای ساخت، نسخه ۲۹.۰.۲ (آگوست ۲۰۱۹)
این به‌روزرسانی مشکل زیر را برطرف می‌کند:
ابزارهای ساخت، نسخه ۲۹.۰.۰ (ژوئن ۲۰۱۹)
این به‌روزرسانی شامل پشتیبانی از ساخت با API سطح ۲۹ است.
ابزارهای ساخت، نسخه ۲۸.۰.۳ (سپتامبر ۲۰۱۸)
این به‌روزرسانی شامل پشتیبانی از افزونه‌ی اندروید Gradle نسخه ۳.۲.۰ است و مشکلات زیر را برطرف می‌کند:
- اشکال کتابخانه JNI که باعث می‌شد برنامه‌ها هنگام فراخوانی
androidx.renderscript.RenderScript.create()از کار بیفتند، برطرف شد. - اشکالی که باعث می‌شد خطاهای ساخت
Program type already presentبا منابعandroidx.annotationوجود داشته باشد، برطرف شد.
ابزارهای ساخت، نسخه ۲۸.۰.۲ (آگوست ۲۰۱۸)
شامل آخرین نسخه D8 است.
ابزارهای ساخت، نسخه ۲۷.۰.۳ (دسامبر ۲۰۱۷)
پشتیبانی از کامپایل لامبداها را هنگام فعال کردن ویژگی‌های زبان جاوا ۸ بهبود می‌بخشد.
ابزارهای ساخت، نسخه ۲۷.۰.۲ (دسامبر ۲۰۱۷)
پشتیبانی از ویژگی‌های زبان جاوا ۸ بهبود یافته است.
ابزارهای ساخت، نسخه ۲۷.۰.۱ (نوامبر ۲۰۱۷)
پشتیبانی از multidex قدیمی برای APK های آزمایشی اضافه شد. ( شماره 37324038 )
ابزارهای ساخت، نسخه ۲۶.۰.۲ (اکتبر ۲۰۱۷)
این نسخه علاوه بر رفع اشکالات عمومی، شامل به‌روزرسانی‌های زیر نیز می‌شود:
-
apksignerبه نسخه ۰.۸ به‌روزرسانی شد:- سازگاری با جاوا ۹. ( شماره ۳۷۱۳۷۸۶۹ )
- پارامتر جدید
--pass-encodingبرای مدیریت keystoreها و کلیدهایی که با استفاده از رمزهای عبور غیر ASCII رمزگذاری شده‌اند. اگر به جاوا ۹ تغییر دهید وapksignerنتواند keystore یا کلید شما را رمزگشایی کند، از این پارامتر برای مشخص کردن کدگذاری کاراکتری که برای ایجاد keystore یا کلید استفاده کرده‌اید، استفاده کنید. برای اطلاعات بیشتر، به مستنداتapksignerمراجعه کنید یاapksigner sign --helpاز خط فرمان اجرا کنید. - پیام خطای بهتری هنگام عدم تأیید امضای JAR
apksignerبه دلیل پشتیبانی نشدن الگوریتم خلاصه یا امضا. ( شماره ۶۳۵۲۵۶۱۸ )
- پشتیبانی از حالت دیمن AAPT2 هنگام استفاده از افزونه اندروید برای Gradle
3.0.0-beta7یا بالاتر.
ابزارهای ساخت، نسخه ۲۶.۰.۱ (ژوئیه ۲۰۱۷)
علاوه بر رفع اشکالات عمومی، این نسخه apksigner به بسته ابزارهای ساخت (که به اشتباه در نسخه 26.0.0 حذف شده بود) بازگردانده و شامل به‌روزرسانی‌های زیر برای این ابزار است:
- پشتیبانی از PKCS #11 را اضافه می‌کند تا امکان امضا با کلیدهایی که در سخت‌افزار امن نگهداری می‌شوند، فراهم شود. ( شماره #37140484 )
- پشتیبانی از بارگیری ارائه‌دهندگان JCA اضافی قبل از امضا را اضافه می‌کند.
- هنگام تأیید فایل‌های APK، از
android:targetSandboxVersionپشتیبانی می‌کند. - هنگام امضا، فایل‌های APK که شامل کاراکترهای ویژه «CR» (بازگشت به خط)، «LF» (تغذیه خط) یا «NUL» (تهی) در نام فایل باشند را رد می‌کند.
- رفع مشکل مدیریت صحیح پارامترهای حاوی فاصله
apksigner.bat( شماره 38132450 ) - اشکالی در تأیید امضای JAR برطرف شد، زمانی که چندین خلاصه برای یک ورودی در
MANIFEST.MFوجود دارد. ( شماره 38497270 )
ابزارهای ساخت، نسخه ۲۶.۰.۰ (ژوئن ۲۰۱۷)
پشتیبانی از ساخت با API سطح ۲۶ را اضافه می‌کند و شامل رفع اشکالات عمومی است.
ابزارهای ساخت، نسخه ۲۵.۰.۳ (آوریل ۲۰۱۷)
به‌روزرسانی‌های apksigner :
- پارامتر
--inبرای تقارن با پارامتر--outموجود اضافه شد. - اگر رمز عبور کلید را با استفاده از
--key-passمشخص نکنید،apksignerاز رمز عبور keystore به عنوان رمز عبور کلید استفاده می‌کند. با این حال، اگر کلید به رمز عبور متفاوتی نیاز داشته باشد، اکنون از شما خواسته می‌شود که رمز عبور کلید را از خط فرمان وارد کنید. ( شماره #۳۷۱۳۴۹۸۶ ) - سازگاری با
jarsignerبرای رمزهای عبور غیر ASCII اضافه شد. ( شماره 37135737 )
ابزارهای ساخت، نسخه ۲۵.۰.۲ (دسامبر ۲۰۱۶)
رفع اشکالات.
ابزارهای ساخت، نسخه ۲۵.۰.۱ (نوامبر ۲۰۱۶)
این نسخه شامل رفع اشکالات و بهبودهای زیر در apksigner است:
- پشتیبانی از فایل‌های APK با نام‌های ورودی JAR مبهم.
- سوئیچ
--print-certsاکنون اثر انگشت‌های MD5 را نیز ذخیره می‌کند.
ابزارهای ساخت، نسخه ۲۵.۰.۰ (اکتبر ۲۰۱۶)
رفع اشکالات مربوط به ابزار Jack:
- مشکل پشتیبانی جک از فایل‌های منبع غیر ASCII برطرف شد. ( شماره ۲۱۸۸۹۲ )
- مشکلی که باعث ایجاد
AssertionErrorدر برخی کامپایل‌ها می‌شد، برطرف شد. ( شماره 208414 )
ابزارهای ساخت، نسخه ۲۴.۰.۳ (سپتامبر ۲۰۱۶)
-
apksigner، یک ابزار امضای APK، برای جایگزینیjarsignerاضافه شد. به طور پیش‌فرض،apksignerفایل‌های APK را با استفاده از طرح امضای JAR مرسوم (که توسطjarsignerاستفاده می‌شود) و طرح امضای APK نسخه ۲ که در اندروید ۷.۰ (سطح API ۲۴) معرفی شده است، امضا می‌کند. هرگونه تغییر در یک APK امضا شده با طرح امضای APK نسخه ۲، امضای آن را باطل می‌کند. بنابراین، پس‌پردازش APK، مانندzipalign، باید قبل از فراخوانیapksignerانجام شود، نه بعد از آن. فراخوانیzipalignقبل ازapksignerبه خوبی کار می‌کند زیراapksignerترازبندی و فشرده‌سازی APK را حفظ می‌کند (برخلافjarsigner).
ابزارهای ساخت، نسخه ۲۳.۰.۳ (مارس ۲۰۱۶)
- مشکلات موجود در کتابخانه پشتیبانی RenderScript در دستگاه‌های arm64 برطرف شد.
- رفع مشکلات موجود در کتابخانه پشتیبانی RenderScript در برخی از دستگاه‌های Jelly Bean.
- پشتیبانی از
renderscriptTargetAPI 21+هنگام استفاده از افزونه اندروید برای Gradle، نسخه 2.1.0 و بالاتر.
ابزارهای ساخت، نسخه ۲۳.۰.۲ (نوامبر ۲۰۱۵)
- عملکرد ادغام ابزار
dxبهبود یافته است. - مشکلات موجود در کامپایلر RenderScript برای ویندوز برطرف شد.
ابزارهای ساخت، نسخه ۲۳.۰.۱ (اکتبر ۲۰۱۵)
مشکلات مربوط به ابزارهای RenderScript برطرف شد.
ابزارهای ساخت، نسخه ۲۳.۰.۰ (آگوست ۲۰۱۵)
پشتیبانی از نسخه اندروید ۶.۰ (API سطح ۲۳) اضافه شد.
ابزارهای ساخت، نسخه ۲۲.۰.۱ (مارس ۲۰۱۵)
مشکلات سازگاری با هسته‌های RenderScript در دستگاه‌های اندروید ۴.۴ (سطح API ۱۹) تا اندروید ۴.۱ (سطح API ۱۶) برطرف شد.
ابزارهای ساخت، نسخه ۲۲.۰.۰ (مارس ۲۰۱۵)
پشتیبانی از اندروید ۵.۱ (سطح API ۲۲) اضافه شد.
ابزارهای ساخت، نسخه ۲۱.۱.۲ (فوریه ۲۰۱۵)
مشکل ساخت طرح‌بندی داده‌ها در حالت ۳۲ بیتی برطرف شد.
ابزارهای ساخت، نسخه ۲۱.۱.۱ (نوامبر ۲۰۱۴)
مشکلات اسکریپت چندرسانه‌ای برطرف شد.
ابزارهای ساخت، نسخه ۲۱.۱ (اکتبر ۲۰۱۴)
پشتیبانی از فایل‌های چندرسانه‌ای برای فایل‌های APK و پشتیبانی از Jack برای رفع محدودیت مرجع روش ۶۴ کیلوبایتی اضافه شد.
ابزارهای ساخت، نسخه ۲۱.۰.۲ (اکتبر ۲۰۱۴)
به‌روزرسانی‌های کامل برای Eclipse ADT برای حل مشکلات ناپایداری در پلتفرم‌های ویندوز.
ابزارهای ساخت، نسخه ۲۱.۰.۱ (اکتبر ۲۰۱۴)
به‌روزرسانی‌های اولیه برای Eclipse ADT در ویندوز. لطفاً از نسخه ۲۱.۰.۲ استفاده کنید.
ابزارهای ساخت، نسخه ۲۱.۰.۰ (اکتبر ۲۰۱۴)
- نکات عمومی:
- پشتیبانی از اندروید ۵.۰ (سطح API ۲۱) اضافه شد.
- RenderScript اکنون از عملیات یکپارچه ۳۲/۶۴ بیتی برای API سطح ۲۱ و بالاتر پشتیبانی می‌کند.
- مشکل سیستم ساخت Gradle هنگام استفاده از افزونه JaCoCo ( شماره 69174 ) برطرف شد.
- گزینه‌ای برای فهرست ورودی‌ها برای استفاده با خطوط فرمان طولانی در ویندوز اضافه شد.
ابزارهای ساخت، نسخه ۲۰.۰.۰ (ژوئن ۲۰۱۴)
- نکات عمومی:
- پشتیبانی از اندروید ویر اضافه شد.
ابزارهای ساخت، نسخه ۱۹.۱.۰ (مه ۲۰۱۴)
- نکات عمومی:
-
zipalignبه ابزارهای ساخت اضافه شد. -
aaptطوری اصلاح شد که فایل‌های XML که کامپایل نمی‌شوند را نادیده بگیرد.
-
ابزارهای ساخت، نسخه ۱۹.۰.۳ (مارس ۲۰۱۴)
مشکلی در پشتیبانی از RenderScript برطرف شد.
ابزارهای ساخت، نسخه ۱۹.۰.۲ (فوریه ۲۰۱۴)
- مشکلات ساخت RenderScript برطرف شد:
- مشکل رمزگذاری بیت‌کد RenderScript برطرف شد. ( شماره ۶۴۷۷۵ )
- مشکل مربوط به عدم نمایش نمادهای ریاضی در RenderScript ( شماره ۶۴۱۱۰ ) برطرف شد.
ابزارهای ساخت، نسخه ۱۹.۰.۱ (دسامبر ۲۰۱۳)
- مشکلات ساخت متفرقه برطرف شد:
- پشتیبانی از کامپایل RenderScript در حالت NDK با Gradle برطرف شد.
- مشکل
BufferOverflowExceptionدر ساخت dx برطرف شد. ( شماره ۶۱۷۱۰ )
ابزارهای ساخت، ویرایش ۱۹ (اکتبر ۲۰۱۳)
پشتیبانی از اهداف ساخت اندروید ۴.۴ (سطح API ۱۹) اضافه شد.
ابزارهای ساخت، نسخه ۱۸.۱.۱ (سپتامبر ۲۰۱۳)
چندین مشکل جزئی در ساخت برطرف شد.
ابزارهای ساخت، نسخه ۱۸.۱.۰ (سپتامبر ۲۰۱۳)
مشکل مربوط به حالت پشتیبانی RenderScript برطرف شد.
ابزارهای ساخت، نسخه ۱۸.۰.۱ (ژوئیه ۲۰۱۳)
پشتیبانی از اهداف ساخت اندروید ۴.۳ (سطح API ۱۸) اضافه شد.
ابزارهای ساخت، ویرایش ۱۷ (مه ۲۰۱۳)
انتشار اولیه.
- نکات عمومی:
- پشتیبانی از اهداف ساخت اندروید ۴.۲ (API سطح ۱۷) نیز اضافه شده است.
- اجزای مخصوص ساخت SDK اندروید را از مؤلفه ابزارهای پلتفرم جدا کرد، به طوری که ابزارهای ساخت بتوانند مستقل از اجزای محیط توسعه یکپارچه (IDE) به‌روزرسانی شوند.