میتوانید همه تکالیف ساخت دردسترس برای پروژه Android خود را بااستفاده از ابزار خط فرمان
پوشاننده Gradle اجرا کنید. این ابزار بهصورت فایل دستهای برای
Windows (gradlew.bat) و اسکریپت پوسته برای Linux و Mac (gradlew.sh) دردسترس است و
از ریشه هر پروژهای که با «استودیو Android» ایجاد میکنید قابلدسترسی است.
برای اجرای تکلیف با پوشاننده، از یکی از فرمانهای زیر در پنجره «پایانه» استفاده کنید (از Android Studio، مشاهده > پنجرههای ابزار > پایانه را انتخاب کنید):
در Windows Command Shell:
gradlew task-nameدر Mac، Linux، یا Windows PowerShell:
./gradlew task-name
برای دیدن فهرست همه تکالیف ساخت دردسترس برای
پروژهتان، tasks را اجرا کنید:
gradlew tasks
بقیه این صفحه اصول اولیه ساخت و اجرای برنامه با Gradle wrapper را شرح میدهد. برای اطلاعات بیشتر درباره نحوه راهاندازی ساخت Android، پیکربندی ساخت را ببینید.
اگر ترجیح میدهید بهجای ابزارهای خط فرمان از ابزارهای Android Studio استفاده کنید، ساختن و اجرای برنامه را ببینید.
درباره انواع ساخت
بهطور پیشفرض، دو نوع ساخت برای هر برنامه Android دردسترس است: یکی برای اشکالزدایی برنامه شما—ساخت اشکالزدایی—و دیگری برای انتشار برنامه شما برای کاربران—ساخت انتشار. خروجی حاصل از هر ساخت باید با گواهی امضا شود تا بتوانید برنامهتان را در دستگاهی مستقر کنید. ساخت اشکالزدایی بهطور خودکار با کلید اشکالزدایی ارائهشده توسط ابزارهای کیت توسعه نرمافزار امضا میشود (این کلید ناامن است و نمیتوانید با آن در «فروشگاه Google Play» منتشر کنید)، و ساخت نسخه پخش باید با کلید خصوصی خودتان امضا شود.
اگر میخواهید برنامهتان را برای انتشار بسازید، مهم است که برنامهتان را با کلید امضای مناسب امضا کنید. اما اگر تازه شروع کردهاید، میتوانید با ساختن APK اشکالزدایی، برنامههایتان را بهسرعت در شبیهساز یا دستگاه متصلشده اجرا کنید.
همچنین میتوانید نوع ساخت سفارشی را در فایل build.gradle.kts تعریف کنید و
آن را پیکربندی کنید تا با گنجاندن debuggable true بهعنوان ساخت اشکالزدایی امضا شود. برای
اطلاعات بیشتر، به پیکربندی تنوعهای ساخت مراجعه کنید.
ساختن و مستقر کردن APK
اگرچه ساختن دسته برنامه بهترین روش برای بستهبندی برنامه و بارگذاری آن در «کنسول Play» است، ساختن APK برای زمانی مناسبتر است که میخواهید بهسرعت ساخت اشکالزدایی را آزمایش کنید یا برنامهتان را بهعنوان یک آرتیفکت قابلاستقرار با دیگران همرسانی کنید.
ساخت APK اشکالزدایی
برای آزمایش و اشکالزدایی فوری برنامه، میتوانید APK اشکالزدایی بسازید.
فایل APK اشکالزدایی با کلید اشکالزدایی ارائهشده توسط ابزارهای کیت توسعه نرمافزار امضا شده است و
امکان اشکالزدایی ازطریق
adb را فراهم میکند.
برای ساختن APK اشکالزدایی، خط فرمان را باز کنید و به ریشه دایرکتوری پروژهتان بروید. برای شروع ساخت اشکالزدایی، تکلیف
assembleDebug را فراخوانی کنید:
gradlew assembleDebug
با این کار، APK با نام module_name-debug.apk در
project_name/module_name/build/outputs/apk/ ایجاد میشود.
فایل ازقبل با کلید اشکالزدایی امضا شده است و با
zipalign همتراز است، بنابراین میتوانید
فوراً آن را در دستگاه نصب کنید.
یا برای ساختن APK و نصب فوری آن در شبیهساز درحال اجرا یا
دستگاه متصل، بهجای آن installDebug را فراخوانی کنید:
gradlew installDebug
بخش «Debug» در نام تکلیفها فقط نسخه نگارش شتری نام
تنوع ساخت
است، بنابراین میتوان آن را با هر نوع یا تنوع ساختی که میخواهید مونتاژ یا نصب کنید جایگزین کرد. برای مثال، اگر نسخه ویژه محصول «نمونه» دارید، میتوانید نسخه اشکالزدایی را با تکلیف assembleDemoDebug بسازید.
برای دیدن همه تکالیف ساخت و نصب دردسترس برای هر گونه (ازجمله
تکالیف حذف نصب)، تکلیف tasks را اجرا کنید.
همچنین بخش مربوط به نحوه اجرای برنامه در شبیهساز و اجرای برنامه در دستگاه را ببینید.
ساختن دسته نسخه پخش یا APK
وقتی برای انتشار و توزیع برنامهتان آماده بودید، باید دسته انتشار یا APK بسازید که با کلید خصوصیتان امضا شده باشد. برای اطلاعات بیشتر، به بخش مربوط به نحوه امضا کردن برنامه از خط فرمان بروید.
استقرار برنامه در شبیهساز
برای استفاده از «شبیهساز Android»، باید بااستفاده از «استودیو Android» یک «دستگاه مجازی Android» (AVD) ایجاد کنید.
وقتی AVD داشتید، «شبیهساز Android» را راهاندازی کنید و برنامهتان را بهصورت زیر نصب کنید:
در خط فرمان، به
android_sdk/tools/بروید و شبیهساز را با مشخص کردن AVD خود راهاندازی کنید:emulator -avd <var>avd_name</var>اگر از نام AVD مطمئن نیستید،
emulator -list-avdsرا اجرا کنید.اکنون میتوانید برنامهتان را بااستفاده از یکی از تکالیف نصب Gradle ذکرشده در بخش مربوط به نحوه ساختن APK اشکالزدایی یا ابزار
adbنصب کنید.اگر APK بااستفاده از کیت توسعه نرمافزار پیشنمایش توسعهدهندگان ساخته شده است (اگر
targetSdkVersionبهجای عدد، حرف باشد)، باید گزینه-tرا با فرمانinstallبرای نصب APK آزمایشی اضافه کنید.adb install <var>path/to/your_app</var>.apkهمه فایلهای APK که میسازید در
project_name/module_name/build/outputs/apk/ذخیره میشوند.
برای اطلاعات بیشتر، اجرای برنامهها در شبیهساز Android را ببینید.
برنامهتان را در دستگاه فیزیکی مستقر کنید
قبلاز اینکه بتوانید برنامهتان را در دستگاهی اجرا کنید، باید اشکالزدایی USB را در دستگاهتان فعال کنید. میتوانید این گزینه را در تنظیمات > گزینههای توسعهدهندگان پیدا کنید.
وقتی دستگاهتان راهاندازی شد و بااستفاده از USB متصل شد، میتوانید برنامهتان را
بااستفاده از تکالیف نصب Gradle که در بخش مربوط به نحوه ساخت APK اشکالزدایی ذکر شده است
یا ابزار adb نصب کنید:
adb -d install path/to/your_app.apk
همه فایلهای APK که میسازید در
project_name/module_name/build/outputs/apk/ ذخیره میشوند.
برای اطلاعات بیشتر، اجرای برنامهها در دستگاه سختافزاری را ببینید.
ساختن دسته برنامه
Android App Bundles شامل همه منابع و کد کامپایلشده برنامهتان است، اما تولید و امضای APK را به Google Play واگذار میکند. برخلاف APK، نمیتوانید دسته برنامه را مستقیماً در دستگاه مستقر کنید. بنابراین، اگر میخواهید بهسرعت یک APK را آزمایش کنید یا با فرد دیگری همرسانی کنید، باید بهجای آن یک APK بسازید.
آسانترین راه برای ساختن دسته برنامه
استفاده از Android Studio است. بااینحال، اگر لازم است دسته برنامه را از خط فرمان بسازید، میتوانید این کار را بااستفاده از Gradle یا bundletool انجام دهید، همانطور که در بخشهای زیر توضیح داده شده است.
ساختن بسته برنامه با Gradle
اگر ترجیح میدهید دسته برنامه را از خط فرمان تولید کنید،
bundleVariant تکلیف Gradle را در واحد پایه برنامهتان اجرا کنید.
برای مثال، فرمان زیر یک دسته برنامه برای نسخه اشکالزدایی
ماژول پایه میسازد:
./gradlew :base:bundleDebug
اگر میخواهید دسته امضاشدهای برای بارگذاری در «کنسول Play» بسازید، ابتدا باید فایل build.gradle.kts واحد پایه را با اطلاعات امضای برنامهتان پیکربندی کنید. برای کسب اطلاعات بیشتر، به بخش مربوط به نحوه
پیکربندی Gradle برای امضای برنامه بروید.
سپس میتوانید، برای مثال، نسخه پخش برنامهتان را بسازید و Gradle
بهطور خودکار دسته برنامهای تولید میکند و آن را با اطلاعات امضایی که
در فایل build.gradle.kts ارائه میدهید امضا میکند.
اگر میخواهید دسته برنامه را بهعنوان مرحلهای جداگانه امضا کنید، میتوانید از
jarsigner
برای امضا کردن دسته برنامه از خط فرمان استفاده کنید. فرمان ساختن دسته برنامه
عبارت است از:
jarsigner -keystore pathToKeystore app-release.aab keyAliasساختن دسته برنامه بااستفاده از bundletool
bundletool ابزاری برای خط فرمان است که Android Studio، افزونه Android Gradle، و Google Play از آن برای تبدیل کد و منابع کامپایلشده برنامهتان به بستههای برنامه و تولید فایلهای APK قابلاستقرار از آن بستهها استفاده میکنند.
بنابراین، هرچند
آزمایش کردن بستههای برنامه با bundletool و بازآفرینی محلی
نحوه تولید فایلهای APK توسط Google Play مفید است، معمولاً نیازی نیست
برای ساختن خود بسته برنامه، bundletool را فراخوانی کنید—درعوض باید
از Android Studio یا Gradle tasks استفاده کنید، همانطور که در بخشهای قبلی شرح داده شد.
بااینحال، اگر نمیخواهید از Android Studio یا Gradle tasks برای ساختن
دستهها استفاده کنید—برای مثال، اگر از زنجیره ابزار ساخت سفارشی استفاده میکنید—میتوانید از bundletool
در خط فرمان برای ساختن دسته برنامه از کد و منابع
ازپیش کامپایلشده استفاده کنید. اگر قبلاً این کار را نکردهاید،
bundletool را از مخزن GitHub بارگیری کنید.
این بخش نحوه بستهبندی کد و منابع کامپایلشده برنامه شما را شرح میدهد،
و نحوه استفاده از bundletool از خط فرمان برای تبدیل آنها به یک
بسته ترکیبی برنامه Android.
تولید مانیفست و منابع در قالب proto
bundletool به اطلاعات خاصی درباره پروژه برنامهتان نیاز دارد، مثلاً مانیفست و منابع برنامه باید در قالب میانگیر پروتکل Google باشد که به آن «protobuf» هم میگویند و از پسوند فایل *.pb استفاده میکند. Protobufs
سازوکاری مستقل از زبان، مستقل از پلاتفرم، و قابلتوسعه
برای سریالسازی دادههای ساختاریافته ارائه میدهد—شبیه XML است، اما کوچکتر، سریعتر، و
سادهتر است.
بارگیری AAPT2
میتوانید فایل مانیفست و جدول منابع برنامهتان را در قالب protobuf بااستفاده از جدیدترین نسخه AAPT2 از مخزن Google Maven تولید کنید.
برای بارگیری AAPT2 از مخزن Maven متعلق به Google، بهصورت زیر عمل کنید:
- به com.android.tools.build > aapt2 در نمایه مخزن بروید.
- نام جدیدترین نسخه AAPT2 را کپی کنید.
نام نسخهای را که کپی کردهاید در نشانی وب زیر درج کنید و سیستمعامل هدف خود را مشخص کنید: https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/ aapt2-version/aapt2-aapt2-version- [windows | linux | osx].jar
برای مثال، برای بارگیری نسخه 3.2.0-alpha18-4804415 برای Windows، از این نشانی استفاده میکنید: https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/3.2.0-alpha18-4804415/aapt2-3.2.0-alpha18-4804415-windows.jar
در مرورگر به نشانی وب بروید—بارگیری AAPT2 باید بهزودی شروع شود.
فایل JAR را که بهتازگی بارگیری کردهاید از حالت بستهبندی خارج کنید.
منابع برنامهتان را کامپایل و پیوند کنید
از AAPT2 برای کامپایل کردن منابع برنامهتان با فرمان زیر استفاده کنید:
aapt2 compile \ project_root/module_root/src/main/res/drawable/Image1.png \ project_root/module_root/src/main/res/drawable/Image2.png \ -o compiled_resources/
درطول مرحله پیوند، که AAPT2 منابع کامپایلشده مختلف شما را به یک APK پیوند میدهد، به AAPT2 دستور دهید تا مانیفست و منابع کامپایلشده برنامهتان را با گنجاندن پرچم --proto-format به قالب protobuf تبدیل کند، همانطور که در مثال زیر نشان داده شده است:
aapt2 link --proto-format -o output.apk \ -I android_sdk/platforms/android_version/android.jar \ --manifest project_root/module_root/src/main/AndroidManifest.xml \ -R compiled_resources/*.flat \ --auto-add-overlay
سپس میتوانید محتوا را از APK خروجی استخراج کنید، مثلاً
AndroidManifest.xml، resources.pb، و دیگر فایلهای منبع برنامهتان—اکنون
در قالب protobuf. هنگام آمادهسازی ورودی
bundletool برای ساختن دسته برنامهتان به این فایلها نیاز دارید، همانطور که در بخش زیر
توضیح داده شده است.
بستهبندی کد و منابع ازپیش کامپایلشده
قبلاز اینکه بتوانید از bundletool برای تولید دسته برنامه برای برنامهتان استفاده کنید، باید
ابتدا فایلهای ZIP را ارائه دهید که هرکدام حاوی کد و منابع کامپایلشده برای
یک مدول برنامه خاص باشد. محتوا و سازماندهی فایل ZIP هر واحد بسیار شبیه به قالب «بسته ترکیبی برنامه Android» است.
برای مثال، باید فایل base.zip را برای واحد پایه برنامهتان ایجاد کنید و
محتوای آن را بهصورت زیر سازماندهی کنید:
| فایل یا دایرکتوری | شرح |
|---|---|
manifest/AndroidManifest.xml
|
مانیفست واحد در قالب protobuf. |
dex/...
|
دایرکتوریای با یک یا چند فایل DEX کامپایلشده برنامهتان. این فایلها
باید بهاین صورت نامگذاری شوند: classes.dex،
classes2.dex، classes3.dex، و غیره.
|
res/...
|
حاوی منابع ماژول در قالب protobuf برای همه پیکربندیهای دستگاه است. زیرفهرستهای راهنما و فایلها باید مشابه یک APK معمولی سازماندهی شوند. |
root/...، assets/...، و lib/...
|
این دایرکتوریها با دایرکتوریهای شرحدادهشده در بخش مربوط به قالب بسته ترکیبی برنامه Android یکسان هستند. |
resources.pb
|
جدول منبع برنامهتان در قالب protobuf. |
پساز آماده کردن فایل ZIP برای هریک از پیمانههای برنامهتان، میتوانید آنها را به bundletool ارسال کنید تا دسته برنامهتان را بسازد، همانطور که در بخش زیر توضیح داده شده است.
ساختن بسته برنامه بااستفاده از bundletool
برای ساختن دسته برنامهتان، از فرمان bundletool build-bundle استفاده میکنید، همانطور که در مثال زیر نشان داده شده است:
bundletool build-bundle --modules=base.zip --output=mybundle.aab
جدول زیر پرچمهای فرمان build-bundle را با جزئیات بیشتر شرح میدهد:
| پرچم | شرح |
|---|---|
--modules=path-to-base.zip, path-to-module2.zip,path-to-module3.zip
|
فهرست فایلهای ZIP واحد را که bundletool باید برای ساختن دسته برنامه شما استفاده کند مشخص میکند.
|
--output=path-to-output.aab
|
مسیر و نام فایل را برای فایل خروجی *.aab مشخص میکند.
|
--config=path-to-BundleConfig.json
|
مسیر فایل پیکربندی اختیاری را که میتوانید برای سفارشیسازی فرایند ساخت استفاده کنید مشخص میکند. برای کسب اطلاعات بیشتر، بخش مربوط به سفارشیسازی تولید APK پاییندستی را ببینید. |
--metadata-file=target-bundle-path:local-file-path
|
به bundletool دستور میدهد فایل فراداده اختیاری را در بسته برنامهتان بستهبندی کند. میتوانید از این فایل برای گنجاندن دادههایی مثل نگاشتهای ProGuard یا فهرست کامل فایلهای DEX برنامهتان استفاده کنید که ممکن است برای مراحل دیگر در زنجیره ابزارتان یا فروشگاه برنامهها مفید باشد.
target-bundle-path مسیری را نسبتبه ریشه دسته برنامه که میخواهید فایل فراداده در آن بستهبندی شود مشخص میکند، و local-file-path مسیر خود فایل فراداده محلی را مشخص میکند. |
سفارشیسازی تولید APK پاییندست
دستههای برنامه شامل فایل BundleConfig.pb هستند که فرادادهای را ارائه میدهد که فروشگاههای برنامه، مانند Google Play، هنگام تولید APK از دسته به آن نیاز دارند.
اگرچه bundletool این فایل را برای شما ایجاد میکند، میتوانید برخیاز جنبههای
فراداده را در فایل BundleConfig.json پیکربندی کنید و آن را به
فرمان bundletool build-bundle ارسال کنید—bundletool بعداً این فایل را تبدیل میکند و
با نسخه protobuf موجود در هر بسته برنامه ادغام میکند.
برای مثال، میتوانید کنترل کنید کدام دستههای APK پیکربندی فعال یا غیرفعال شوند. نمونه زیر از فایل BundleConfig.json، فایلهای APK پیکربندی را که هرکدام زبان متفاوتی را هدف قرار میدهند غیرفعال میکند (یعنی منابع همه زبانها در فایلهای APK پایه یا ویژگی مربوطه گنجانده شدهاند):
{
"optimizations": {
"splitsConfig": {
"splitDimension": [{
"value": "LANGUAGE",
"negate": true
}]
}
}
}
در فایل BundleConfig.json، همچنین میتوانید مشخص کنید که کدام نوع فایلها هنگام بستهبندی APK بااستفاده از
الگوهای glob بهصورت زیر
غیرفشرده باقی بمانند:
{
"compression": {
"uncompressedGlob": ["res/raw/**", "assets/**.uncompressed"]
}
}
بهخاطر داشته باشید که بهطور پیشفرض، bundletool کتابخانههای بومی برنامهتان (در Android نسخه ۶.۰ یا بالاتر) و جدول منابع (resources.arsc) را فشرده نمیکند. برای شرح کامل آنچه میتوانید در BundleConfig.json پیکربندی کنید، فایل bundletool config.proto را که بااستفاده از نحو Proto3 نوشته شده است بررسی کنید.
برنامهتان را از بسته برنامه مستقر کنید
اگر بسته برنامهای را ساخته و امضا کردهاید،
از bundletool برای تولید فایلهای APK و استقرار آنها در
دستگاه استفاده کنید.
امضا کردن برنامه از خط فرمان
برای امضای برنامهتان به Android Studio نیاز ندارید. میتوانید برنامهتان را از
خط فرمان، بااستفاده از apksigner برای APK یا jarsigner برای بستههای برنامه امضا کنید،
یا Gradle را پیکربندی کنید تا آن را درطول ساخت برای شما امضا کند. در هر دو روش، ابتدا باید بااستفاده از
keytool
کلید خصوصی تولید کنید،
همانطور که در مثال زیر نشان داده شده است:
keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-alias
این مثال از شما میخواهد گذرواژههای keystore و کلید، و فیلدهای «نام متمایز» را برای کلیدتان وارد کنید. سپس
keystore را بهعنوان فایلی بهنام my-release-key.jks تولید میکند و آن را در
دایرکتوری فعلی ذخیره میکند (میتوانید آن را به هر جایی که میخواهید منتقل کنید). مخزن کلید
حاوی یک کلید است که برای ۱۰٬۰۰۰ روز معتبر است.
اکنون میتوانید APK یا دسته برنامه خود را بهصورت دستی امضا کنید، یا Gradle را پیکربندی کنید تا برنامه شما را درطول فرایند ساخت امضا کند، همانطور که در بخشهای زیر توضیح داده شده است.
امضا کردن دستی برنامه از خط فرمان
اگر میخواهید دسته برنامهای را از خط فرمان امضا کنید، میتوانید از
jarsigner استفاده کنید.
اگر درعوض میخواهید فایل APK را امضا کنید، باید از zipalign و apksigner استفاده کنید:
خط فرمان را باز کنید—از Android Studio، مشاهده > پنجرههای ابزار > پایانه را انتخاب کنید—و به دایرکتوریای که APK امضانشده شما در آن قرار دارد بروید.
فایل APK امضانشده را بااستفاده از
zipalignتراز کنید:zipalign -v -p 4 my-app-unsigned.apk my-app-unsigned-aligned.apk
zipalignتضمین میکند که همه دادههای فشردهنشده با تراز بایت خاصی نسبت به شروع فایل شروع میشوند، که ممکن است مقدار RAM مصرفشده توسط برنامه را کاهش دهد.بااستفاده از
apksigner، فایل APK را با کلید خصوصیتان امضا کنید:apksigner sign --ks my-release-key.jks --out my-app-release.apk my-app-unsigned-aligned.apk
این مثال APK امضاشده را در
my-app-release.apkپساز امضا کردن آن با کلید خصوصی و گواهی ذخیرهشده در یک فایل KeyStore تکی خروجی میدهد:my-release-key.jks.ابزار
apksignerاز گزینههای امضای دیگری پشتیبانی میکند، ازجمله امضای فایل APK بااستفاده از کلید خصوصی و فایلهای گواهی جداگانه، و امضای APK بااستفاده از چند امضاکننده. برای جزئیات بیشتر، به مرجعapksignerمراجعه کنید.تأیید کنید که APK شما امضا شده است:
apksigner verify my-app-release.apk
پیکربندی Gradle برای امضای برنامه
فایل build.gradle.kts در سطح ماژول را باز کنید و
بلوک signingConfigs {} را با ورودیهای storeFile،
storePassword، keyAlias و
keyPassword اضافه کنید، سپس آن شیء را به
ویژگی signingConfig در نوع ساخت خود ارسال کنید. برای مثال:
کاتلین
android { ... defaultConfig { ... } signingConfigs { create("release") { // You need to specify either an absolute path or include the // keystore file in the same directory as the build.gradle file. storeFile = file("my-release-key.jks") storePassword = "password" keyAlias = "my-alias" keyPassword = "password" } } buildTypes { getByName("release") { signingConfig = signingConfigs.getByName("release") ... } } }
شیک
android { ... defaultConfig { ... } signingConfigs { release { // You need to specify either an absolute path or include the // keystore file in the same directory as the build.gradle file. storeFile file("my-release-key.jks") storePassword "password" keyAlias "my-alias" keyPassword "password" } } buildTypes { release { signingConfig signingConfigs.release ... } } }
اکنون، وقتی برنامهتان را با فراخوانی تکلیف Gradle میسازید، Gradle برنامهتان را برای شما امضا میکند (و zipalign را اجرا میکند).
علاوهبراین، چون ساخت نسخه پخش را با کلید امضایتان پیکربندی کردهاید،
تکلیف «نصب» برای آن نوع ساخت دردسترس است. بنابراین میتوانید APK نسخه پخش را با تکلیف installRelease بسازید، تراز کنید، امضا کنید، و در شبیهساز یا دستگاه نصب کنید.
برنامهای که با کلید خصوصی شما امضا شده است برای توزیع آماده است، اما ابتدا باید درباره نحوه انتشار برنامه بیشتر بخوانید و بازبینه راهاندازی Google Play را مرور کنید.