وقتی کد خود را اجرا، اشکال زدایی یا آزمایش می کنید، Android Studio از یک پیکربندی run/debug برای تعیین نحوه انجام عملیات استفاده می کند. به طور معمول، پیکربندی ایجاد شده در ابتدا برای اجرا یا اشکال زدایی یک برنامه کافی است. با این حال، می‌توانید پیکربندی‌های جدید را تغییر دهید و ایجاد کنید، و الگوهای پیکربندی را مطابق با فرآیند توسعه خود تغییر دهید، همانطور که در این صفحه توضیح داده شده است.
برای اطلاعات بیشتر، اسناد IntelliJ زیر را نیز ببینید:
درباره پیکربندی‌های اجرا/اشکالزدایی
پیکربندی‌های Run/Debug جزئیاتی مانند نصب برنامه، راه‌اندازی و گزینه‌های آزمایشی را مشخص می‌کنند. می توانید پیکربندی را برای یک بار استفاده تعریف کنید، یا آن را برای استفاده بعدی ذخیره کنید. پس از ذخیره آن، می توانید پیکربندی را از لیست کشویی Select Run/Debug Configuration در نوار ابزار انتخاب کنید. Android Studio پیکربندی ها را به عنوان بخشی از پروژه ذخیره می کند.
پیکربندی اجرا/اشکالزدایی در ابتدا ایجاد شد
وقتی برای اولین بار پروژه ای را ایجاد می کنید، Android Studio یک پیکربندی اجرا/اشکال زدایی برای فعالیت اصلی بر اساس الگوی برنامه Android ایجاد می کند. برای اجرا یا اشکال زدایی پروژه خود، همیشه باید حداقل یک پیکربندی run/debug تعریف شده باشد. به همین دلیل، توصیه می کنیم پیکربندی ایجاد شده در ابتدا را حذف نکنید.
محدوده پروژه و کنترل نسخه
پیکربندی‌های اجرا/اشکالزدایی و تغییرات الگو فقط برای پروژه فعلی اعمال می‌شود. شما می توانید یک پیکربندی اجرا/اشکال (اما نه یک الگو) را از طریق سیستم کنترل نسخه خود به اشتراک بگذارید. برای اطلاعات بیشتر در مورد نحوه اشتراک‌گذاری یک پیکربندی، به گزینه‌های پیکربندی نام و اشتراک‌گذاری مراجعه کنید.
گفتگوی Run/Debug Configurations را باز کنید
برای باز کردن گفتگوی Run/Debug Configurations، Run > Edit Configurations را انتخاب کنید. همانطور که در شکل 1 نشان داده شده است، کادر گفتگوی Run/Debug Configurations ظاهر می شود.
شکل 1 . گفتگوی Run/Debug Configurations
پانل سمت چپ دیالوگ پیکربندی های تعریف شده شما را بر اساس نوع قالب گروه بندی می کند و به شما امکان می دهد الگوهای پیکربندی را در پایین ویرایش کنید . می توانید پیکربندی انتخاب شده را در پنل سمت راست ویرایش کنید. اندازه دیالوگ را تغییر دهید تا موارد پنهان را ببینید.
در این گفتگو می توانید:
- پیکربندی‌های اجرا/اشکالزدایی جدید ایجاد کنید .
- تنظیمات اجرا/اشکالزدایی را ویرایش کنید.
- ویرایش قالب های پیکربندی
- مرتب سازی و گروه بندی تنظیمات
یک پیکربندی run/debug جدید ایجاد کنید
می‌توانید پیکربندی‌های run/debug جدید را از پنجره Run/Debug Configurations ، پنجره پروژه یا ویرایشگر کد تعریف کنید. پیکربندی جدید باید بر اساس یک الگوی پیکربندی باشد.
گفتگوی Run/Debug Configurations پیکربندی های run/debug و قالب های پیکربندی موجود را نمایش می دهد. می توانید یک پیکربندی جدید را مستقیماً از یک الگو یا از یک کپی از پیکربندی دیگر شروع کنید. سپس می توانید مقادیر فیلد را در صورت نیاز تغییر دهید.
از طرف دیگر، می‌توانید روی یک آیتم در پنجره Project کلیک راست کنید تا به طور خودکار یک پیکربندی خاص برای آن مورد ایجاد شود. برای مثال، اگر می‌خواهید فعالیت خاصی را اجرا کنید، می‌توانید روی فایل Java Activity کلیک راست کرده و Run را انتخاب کنید. بسته به مورد، Android Studio از یک برنامه Android ، Android Instrumented Tests یا الگوی پیکربندی JUnit برای ایجاد پیکربندی استفاده می‌کند.
در ویرایشگر کد، می توانید به راحتی یک پیکربندی تست و اجرا/اشکال زدایی برای یک کلاس یا متد ایجاد کنید و سپس آن را اجرا کنید.
وقتی پیکربندی را خارج از کادر گفتگوی Run/Debug Configurations ایجاد می‌کنید، پیکربندی موقتی است مگر اینکه آن را ذخیره کنید. به‌طور پیش‌فرض، می‌توانید تا پنج پیکربندی موقت در پروژه قبل از شروع حذف آنها توسط Android Studio داشته باشید. برای تغییر این پیش‌فرض، تنظیمات Android Studio را باز کنید و تنظیمات پیشرفته > اجرا/اشکالزدایی > محدودیت تنظیمات موقت را تغییر دهید. برای اطلاعات بیشتر در مورد پیکربندی‌های موقت، به ایجاد و ذخیره پیکربندی‌های اجرای موقت/اشکالزدایی مراجعه کنید.
پیکربندی را بر اساس یک الگو شروع کنید
برای تعریف یک پیکربندی run/debug بر اساس یک الگو، مراحل زیر را دنبال کنید:
- گفتگوی Run/Debug Configurations را باز کنید .
- روی Add New Configuration کلیک کنید
. - یک الگوی پیکربندی را انتخاب کنید.
- در قسمت Name یک نام تایپ کنید.
- در صورت نیاز پیکربندی را تغییر دهید.
- روی Apply یا OK کلیک کنید.
مطمئن شوید که خطاهای نمایش داده شده در پایین کادر گفتگو را تصحیح کنید.
پیکربندی را از یک کپی شروع کنید
برای تعریف یک پیکربندی run/debug که از یک کپی از پیکربندی دیگر شروع می‌شود، این مراحل را دنبال کنید:
- گفتگوی Run/Debug Configurations را باز کنید .
- یک پیکربندی اجرا/اشکالزدایی موجود را در پنجره سمت چپ انتخاب کنید.
- روی گزینه Copy Configuration کلیک کنید
. - در قسمت Name یک نام تایپ کنید.
- در صورت نیاز پیکربندی را تغییر دهید.
- روی Apply یا OK کلیک کنید.
مطمئن شوید که خطاهای نمایش داده شده در پایین کادر گفتگو را تصحیح کنید.
یک پیکربندی برای یک آیتم در پروژه تعریف کنید
Android Studio می‌تواند یک پیکربندی run/debug برای برخی موارد نمایش داده شده در پنجره پروژه ایجاد کند. پیکربندی بر اساس یک الگوی پیکربندی به شرح زیر است:
- فعالیت فایل جاوا: قالب برنامه اندروید .
- بسته: تست‌های ابزاری Android یا قالب Android JUnit ، بسته به مجموعه منبع شما. اگر یک تست ابزاری را انتخاب کنید، از الگوی تست‌های ابزاری Android استفاده می‌کند. اگر تست واحد محلی را انتخاب کنید، از الگوی Android JUnit استفاده می کند. برای تست واحد محلی، می‌توانید به صورت اختیاری با پوشش کد اجرا کنید. برای اطلاعات بیشتر، پوشش کد را ببینید.
برای ایجاد یک پیکربندی run/debug برای یک آیتم در پروژه خود، این مراحل را دنبال کنید:
- یک پروژه را در Android یا Project view باز کنید.
- در پنجره Project ، روی یک مورد قابل آزمایش کلیک راست کرده و Run filename یا Debug filename را انتخاب کنید. Android Studio یک پیکربندی اجرا/اشکالزدایی موقت ایجاد می‌کند و برنامه شما را راه‌اندازی می‌کند.
- لیست کشویی Select Run/Debug Configuration را در نوار ابزار باز کنید.
- از گزینه های کنار پیکربندی که می خواهید ذخیره کنید، Save Configuration را انتخاب کنید.
شکل 2 . پیکربندی را ذخیره کنید
توجه: اگر روی همان مورد کلیک راست کرده و اجرا یا اشکال زدایی کنید (اما نه یک فعالیت)، Android Studio یک پیکربندی جدید ایجاد می کند.
یک پیکربندی آزمایشی برای یک کلاس یا متد تعریف کنید
اندروید استودیو به شما امکان می دهد یک پیکربندی اجرای آزمایشی برای یک کلاس یا متد تعریف کنید و سپس آن را اجرا کنید. به عنوان مثال، اگر یک کلاس جدید ایجاد کنید، می توانید یک تست برای آن ایجاد و اجرا کنید. اگر آزمون قبول شد، می‌توانید آزمایش‌ها را برای بقیه پروژه اجرا کنید تا مطمئن شوید که کد جدید شما چیزی را در جای دیگری خراب نمی‌کند.
Android Studio بسته به مجموعه منبع شما از Android Instrumented Tests یا قالب Android JUnit استفاده می کند. برای آزمایش واحد محلی، می‌توانید به صورت اختیاری با پوشش کد اجرا کنید.
برای ایجاد یک پیکربندی run/debug برای یک کلاس یا متد در کد جاوا، مراحل زیر را دنبال کنید:
- یک پروژه را در Android یا Project view باز کنید.
- یک فایل جاوا را در ویرایشگر کد باز کنید.
- یک کلاس یا متد را در کد انتخاب کنید و سپس Control+Shift+T (Command+Shift+T) را فشار دهید.
- از منوی ظاهر شده گزینه Create New Test را انتخاب کنید.
- در گفتگوی Create Test ، به صورت اختیاری مقادیر را تغییر یا تنظیم کنید و روی OK کلیک کنید.
- در گفتگوی Choose Destination Directory ، جایی از پروژه را که می‌خواهید Android Studio تست را انجام دهد، انتخاب کنید. می توانید مکان را با ساختار دایرکتوری یا با انتخاب یک کلاس همسایه مشخص کنید.
- روی OK کلیک کنید.
آزمایش جدید در پنجره Project در مجموعه منبع آزمایش مربوطه ظاهر می شود.
- برای اجرای تست یکی از موارد زیر را انجام دهید:
- در پنجره Project ، روی تست کلیک راست کرده و Run یا Debug را انتخاب کنید.
- در ویرایشگر کد، روی تعریف کلاس یا نام متد در فایل آزمایشی کلیک راست کرده و گزینه Run یا Debug را انتخاب کنید تا همه متدهای کلاس را آزمایش کنید.
- لیست کشویی Select Run/Debug Configuration را در نوار ابزار باز کنید.
- از گزینه های کنار پیکربندی که می خواهید ذخیره کنید، Save Configuration را انتخاب کنید.
شکل 3 . پیکربندی را ذخیره کنید
یک برنامه را با استفاده از پیکربندی ذخیره شده اجرا یا اشکال زدایی کنید
اگر پیکربندی اجرا/اشکالزدایی را ذخیره کرده‌اید، می‌توانید قبل از اجرا یا اشکالزدایی برنامه، آن را انتخاب کنید.
برای استفاده از پیکربندی run/debug ذخیره شده، این مراحل را دنبال کنید:
- پیکربندی run/debug را از لیست کشویی Select Run/Debug Configuration در نوار ابزار انتخاب کنید.
- Run > Run یا Run > Debug را انتخاب کنید.
لیست کشویی در سمت چپ Run قرار دارد
و Debug
; برای مثال،
.
یا روی Run کلیک کنید یا Debug .
پیکربندی اجرا/اشکالزدایی را ویرایش کنید
برای ویرایش پیکربندی run/debug، مراحل زیر را دنبال کنید:
- گفتگوی Run/Debug Configurations را باز کنید .
- یک پیکربندی را در قسمت سمت چپ انتخاب کنید.
- در صورت نیاز پیکربندی را تغییر دهید.
- روی Apply یا OK کلیک کنید.
مطمئن شوید که خطاهای نمایش داده شده در پایین کادر گفتگو را تصحیح کنید.
یک الگوی پیکربندی run/debug را ویرایش کنید
می‌توانید قالب‌های پیکربندی ارائه‌شده توسط Android Studio را متناسب با فرآیند توسعه خود ویرایش کنید. هنگامی که یک الگو را ویرایش می کنید، بر پیکربندی های موجود که از الگو استفاده می کنند تأثیر نمی گذارد. بنابراین، برای مثال، اگر نیاز به ایجاد تعدادی پیکربندی از یک نوع خاص دارید، می‌توانید الگو را ویرایش کنید و پس از اتمام کار دوباره آن را تغییر دهید.
اگرچه نمی‌توانید قالب‌های جدیدی ایجاد کنید، اما می‌توانید تنظیماتی را برای استفاده مشابه یک الگو ایجاد کنید. می توانید یک پیکربندی را کپی کنید و کپی را برای ایجاد تنظیمات جدید ویرایش کنید.
برای ویرایش یک قالب، مراحل زیر را دنبال کنید:
- گفتگوی Run/Debug Configurations را باز کنید .
- روی Edit configuration templates... کلیک کنید.
- یک الگوی پیکربندی را انتخاب کنید.
- در صورت نیاز پیکربندی را تغییر دهید.
- روی Apply یا OK کلیک کنید.
مطمئن شوید که خطاهای نمایش داده شده در پایین کادر گفتگو را تصحیح کنید.
مرتب سازی و گروه بندی تنظیمات
در گفتگوی Run/Debug Configurations ، می‌توانید پیکربندی‌های خود را برای یافتن سریع آنها سفارش دهید. می توانید موارد موجود در پوشه را بر اساس حروف الفبا مرتب کنید و پوشه های جدیدی برای پیکربندی های گروه ایجاد کنید.
برای مرتب کردن تنظیمات بر اساس حروف الفبا، مراحل زیر را دنبال کنید:
- گفتگوی Run/Debug Configurations را باز کنید .
- پوشه ای را انتخاب کنید که دارای تنظیمات است.
- روی Sort Configurations کلیک کنید
. - روی OK کلیک کنید تا گفتگو بسته شود.
برای گروه بندی تنظیمات در پوشه ها، مراحل زیر را دنبال کنید:
- گفتگوی Run/Debug Configurations را باز کنید .
- پوشه ای را انتخاب کنید که دارای تنظیمات است.
- روی Create New Folder کلیک کنید
. - در قسمت Folder Name یک نام تایپ کنید.
- برای ذخیره نام روی Apply کلیک کنید.
تعریف عملیات قبل از راه اندازی
شما می توانید وظایفی را برای اجرا قبل از اعمال پیکربندی run/debug مشخص کنید. وظایف به ترتیبی که در لیست ظاهر می شوند انجام می شوند.
توجه: تعریف وظایف قبل از راه اندازی یک ویژگی پیشرفته است. به جای استفاده از این ویژگی، توصیه می کنیم هر منطق آماده سازی را به عنوان وظایف در فایل build.gradle خود قرار دهید تا هنگام ساخت از خط فرمان اجرا شوند.
برای ایجاد لیست وظایف، مراحل زیر را دنبال کنید:
- در پایین کادر گفتگوی Run/Debug Configurations در قسمت قبل از راه‌اندازی (شاید لازم باشد به پایین پیمایش کنید)، روی افزودن کلیک کنید. و یک نوع کار را انتخاب کنید. اگر یک گفتگو باز شد، فیلدها را پر کنید و روی OK کلیک کنید.
- در صورت نیاز کارهای بیشتری اضافه کنید.
- برای سفارش دادن کارها، آنها را بکشید یا یک کار را انتخاب کنید و روی Up کلیک کنید
و پایین
تا آن را در لیست به بالا یا پایین ببرید. - اگر می‌خواهید تنظیمات پیکربندی run/debug را قبل از اعمال آنها نمایش دهید ، Show this page را انتخاب کنید.
این گزینه به طور پیش فرض لغو انتخاب شده است.
- اگر می‌خواهید هنگام اجرا یا اشکالزدایی برنامه، پنجره ابزار Run یا Debug فعال شود ، پنجره ابزار فعال را انتخاب کنید.
این گزینه به صورت پیش فرض انتخاب شده است.
برای حذف یک کار از لیست، این مراحل را دنبال کنید:
- یک کار را انتخاب کنید.
- روی حذف کلیک کنید
.
برای ویرایش یک کار، این مراحل را دنبال کنید:
- یک کار را انتخاب کنید.
- روی Edit کلیک کنید
. - تنظیمات کار را در گفتگوی باز شده ویرایش کنید و سپس روی OK کلیک کنید.
جدول زیر وظایف موجود را که می توانید اضافه کنید فهرست می کند.
| وظیفه | توضیحات |
|---|---|
| ابزار خارجی را اجرا کنید | برنامه ای را اجرا کنید که خارج از Android Studio است. در گفتگوی ابزارهای خارجی ، یک یا چند برنامه را که می خواهید اجرا کنید انتخاب کنید و سپس روی OK کلیک کنید. اگر برنامه هنوز در Android Studio تعریف نشده است، تعریف آن را در گفتگوی Create Tools اضافه کنید. برای اطلاعات بیشتر، پیکربندی ابزارهای شخص ثالث و ابزارهای خارجی را ببینید. |
| یک پیکربندی دیگر را اجرا کنید | یکی از پیکربندی های run/debug موجود را اجرا کنید. در گفتگوی Choose Configuration to Execute ، یک پیکربندی را برای اجرا انتخاب کنید و سپس روی OK کلیک کنید. |
| بسازید | پروژه یا ماژول را کامپایل کنید. Android Studio دستور Make Module را اگر پیکربندی run/debug یک ماژول خاص را مشخص کرده باشد، یا اگر هیچ ماژولی مشخص نشده باشد ، دستور Make Project را اجرا می کند. |
| ساخت پروژه | پروژه را کامپایل کنید. Android Studio دستور Make Project را اجرا می کند. |
| بسازید، بدون بررسی خطا | این گزینه مانند Make است، با این تفاوت که Android Studio بدون در نظر گرفتن نتیجه کامپایل، پیکربندی run/debug را اجرا می کند. |
| ساخت مصنوعات | در Android Studio پشتیبانی نمی شود. |
| وظیفه Gradle را اجرا کنید | یک کار Gradle را اجرا کنید. در گفتگوی باز شده، جزئیات را مشخص کنید و سپس روی OK کلیک کنید. برای اطلاعات بیشتر، Gradle را ببینید. |
| Gradle-aware Make | پروژه را کامپایل کرده و Gradle را اجرا کنید. |
| سازنده App Engine Gradle | وظیفه سازنده App Engine Gradle پروژه را همگام‌سازی می‌کند و سپس ماژول را می‌سازد. |
قالب های پیکربندی
Android Studio قالب های پیکربندی را برای کمک به شما برای شروع سریع ارائه می دهد. بخش‌های زیر الگوهایی را که برای توسعه اندروید با Android Studio اعمال می‌شوند شرح می‌دهند:
توجه: اندروید استودیو 2.1. x و پایین‌تر دارای یک الگوی Native Application بودند که نسخه‌های جدید آن را ندارند. اگر در پروژه‌ای یک الگوی Native Application دارید، Android Studio هنگام بارگذاری پروژه آن را به برنامه Android تبدیل می‌کند. یک گفتگوی Convert Project شما را در این فرآیند راهنمایی می کند.
الگوهای پشتیبانی نشده
قالب‌های پشتیبانی‌نشده زیر از IntelliJ IDEA هستند و مختص توسعه Android با Android Studio نیستند. برای کسب اطلاعات در مورد استفاده از این الگوها، پیوندهای مستندات IntelliJ IDEA را دنبال کنید.
- برنامه
- مرکب
- گریدل
- شیار
- برنامه JAR
- جاوا اسکرچ
- JUnit
- کاتلین
- اسکریپت کاتلین
- اشکال زدایی از راه دور
- اسکریپت پوسته
- TestNG
گزینه های پیکربندی رایج
گزینه های نام ، اجازه اجرای موازی و ذخیره به عنوان فایل پروژه برای چندین الگوی پیکربندی مشترک هستند. برای کسب اطلاعات بیشتر در مورد آنها، تنظیمات رایج را ببینید.
Android Studio پیکربندی run/debug مشترک را در فایل‌های XML جداگانه در پوشه project_directory /.idea/runConfigurations/ ذخیره می‌کند. برای اطلاعات بیشتر، فرمت مبتنی بر دایرکتوری را در مستندات پروژه های IntelliJ ببینید.
برنامه اندروید
با استفاده از پیکربندی‌های مبتنی بر این الگو، می‌توانید برنامه‌ها و فعالیت‌های اندروید را روی دستگاه‌های مجازی یا سخت‌افزاری اجرا یا اشکالزدایی کنید.
برگه عمومی
در تب General می توانید گزینه های نصب، راه اندازی و استقرار را مشخص کنید. برگه متفرقه همچنین شامل گزینه های نصب است.
| میدان | توضیحات |
|---|---|
| ماژول | یک ماژول را برای اعمال این پیکربندی انتخاب کنید. |
| گزینه های نصب: استقرار | یک گزینه را انتخاب کنید:
|
| گزینه‌های نصب: به‌عنوان برنامه فوری راه‌اندازی کنید | اگر برنامه شما از تجربه‌های فوری پشتیبانی می‌کند - یعنی وقتی پروژه جدیدی ایجاد می‌کنید ، یا از برنامه‌های فوری پشتیبانی می‌کنید، یا یک یا چند ماژول ویژگی با قابلیت فوری ایجاد می‌کنید - می‌توانید با علامت زدن کادر آن ماژول‌های فعال فوری را اجرا کنید. کنار Deploy as instant app . |
| گزینه های نصب: ویژگی هایی برای استقرار | اگر برنامه شما دارای ماژول‌های ویژگی است، کادر کنار هر ویژگی را که می‌خواهید در هنگام استقرار برنامه خود اضافه کنید علامت بزنید. این گزینه را فقط در صورتی می بینید که برنامه شما دارای ماژول های ویژگی باشد. توجه: اگر می‌خواهید دانلود و نصب ماژول‌های ویژگی را به‌صورت درخواستی آزمایش کنید، باید این کار را پس از انتشار بسته برنامه خود انجام دهید و سپس از مسیر تست داخلی کنسول Play استفاده کنید. برای کسب اطلاعات بیشتر، آپلود بسته برنامه خود را در Play Console بخوانید. |
| گزینه های نصب: پرچم ها را نصب کنید | هر گزینه pm install adb را که می خواهید استفاده کنید تایپ کنید. گزینه ها را به همان روشی که در خط فرمان انجام می دهید، فرمت کنید، اما بدون مسیر. در اینجا چند نمونه آورده شده است: و پیش فرض: هیچ گزینه ای وجود ندارد. |
| گزینه های راه اندازی: راه اندازی | یک گزینه را انتخاب کنید:
|
| گزینه های راه اندازی: پرچم ها را راه اندازی کنید | هر گزینه adb am start را که می خواهید استفاده کنید تایپ کنید. گزینه ها را به همان روشی که در خط فرمان انجام می دهید، فرمت کنید، اما بدون هدف. به عنوان مثال: اگر مقدار Launch را از Nothing انتخاب کرده باشید، این گزینه ظاهر نمی شود. پیش فرض: هیچ گزینه ای وجود ندارد. |
| Deployment Target Options: Target | یک گزینه را انتخاب کنید:
|
گزینه های هدف استقرار: برای راه اندازی های آینده از همان دستگاه استفاده کنید | به‌طور پیش‌فرض، انتخاب این گزینه لغو می‌شود، به طوری که هر بار که یک برنامه را اجرا می‌کنید، کادر گفتگوی Select Deployment برای انتخاب دستگاه ظاهر می‌شود. هنگامی که این گزینه را انتخاب می کنید و سپس یک برنامه را اجرا می کنید، کادر گفتگوی Select Deployment برای انتخاب دستگاه ظاهر می شود. سپس، هر بار که برنامه را اجرا می کنید، بدون نمایش کادر گفتگوی Select Deployment ، بر روی دستگاهی که انتخاب کرده اید راه اندازی می شود. برای اجرای برنامه در دستگاه دیگری، گزینه Use same device برای راه‌اندازی‌های آینده را لغو انتخاب کنید یا برنامه را با اجرای > توقف app یا توقف متوقف کنید. ، و سپس آن را دوباره شروع کنید. کادر گفتگوی Select Deployment نمایش داده می شود تا بتوانید دستگاهی را انتخاب کنید. |
| قبل از راه اندازی | به تعریف عملیات قبل از راه اندازی مراجعه کنید. |
برگه متفرقه
در تب متفرقه ، می توانید گزینه های logcat، نصب، راه اندازی و استقرار را مشخص کنید. تب General نیز شامل گزینه های نصب است.
| میدان | توضیحات |
|---|---|
| Logcat: نمایش logcat به صورت خودکار | هنگامی که این گزینه انتخاب می شود، هر بار که با موفقیت یک برنامه را با استفاده از این پیکربندی اجرا و راه اندازی می کنید، پنجره Logcat باز می شود. پیش فرض: انتخاب شده است. |
| Logcat: قبل از راه اندازی، گزارش را پاک کنید | اگر می‌خواهید Android Studio قبل از شروع برنامه، داده‌های جلسات قبلی را از فایل گزارش حذف کند، این گزینه را انتخاب کنید. پیش فرض: از حالت انتخاب خارج شد. |
| گزینه های نصب: اگر APK تغییر نکرده است، از نصب صرفنظر کنید. | در صورت انتخاب، Android Studio اگر تشخیص دهد که APK شما تغییر نکرده است، آن را مجدداً مستقر نمی کند. اگر می خواهید Android Studio به اجبار APK را نصب کند، حتی اگر تغییری نکرده باشد، این گزینه را از حالت انتخاب خارج کنید. پیش فرض: انتخاب شده است |
| گزینه های نصب: قبل از راه اندازی فعالیت، اجرای برنامه را اجباری متوقف کنید | در صورت انتخاب، زمانی که Android Studio تشخیص دهد که نیازی به نصب مجدد APK ندارد زیرا تغییری نکرده است، برنامه را به اجبار متوقف می‌کند تا برنامه از فعالیت راه‌انداز پیش‌فرض شروع شود. اگر این گزینه لغو انتخاب شود، اندروید استودیو برنامه را به اجبار متوقف نمی کند. این گزینه با گزینه قبلی که نصب یا عدم نصب APK را کنترل می کند کار می کند. برای هر دو فیلد Installation Options ، آنها را در حالت پیش‌فرض بگذارید، مگر اینکه صراحتاً بخواهید هر بار نصب را اجباری کنید. در برخی موارد ممکن است بخواهید این گزینه را از حالت انتخاب خارج کنید. برای مثال، اگر در حال نوشتن یک موتور روش ورودی (IME) هستید، با توقف اجباری برنامه، آن را به‌عنوان صفحه‌کلید فعلی از حالت انتخاب خارج می‌کند، که ممکن است نخواهید. پیش فرض: انتخاب شده است |
| قبل از راه اندازی | به تعریف عملیات قبل از راه اندازی مراجعه کنید. |
تب دیباگر
گزینه های اشکال زدایی را در تب Debugger مشخص کنید.
برای کدهای C و C++، Android Studio از دیباگر LLDB استفاده می کند. علاوه بر رابط کاربری عادی اندروید استودیو، پنجره دیباگر دارای یک برگه LLDB است که به شما امکان می دهد دستورات LLDB را در حین اشکال زدایی وارد کنید. می توانید همان دستوراتی را که اندروید استودیو برای نمایش اطلاعات در رابط کاربری دیباگر استفاده می کند وارد کنید و می توانید عملیات اضافی را انجام دهید.
برای پروژه های C و C++، می توانید دایرکتوری های نماد، و همچنین راه اندازی LLDB و دستورات پیوست را در برگه Debugger اضافه کنید. برای انجام این کار، از دکمه های مشابه زیر استفاده می کنید:
- اضافه کنید - یک دایرکتوری یا دستور اضافه کنید.
- حذف کنید- یک دایرکتوری یا دستور را انتخاب کنید و سپس روی این دکمه کلیک کنید تا مورد حذف شود.
- بالا - یک دایرکتوری یا دستور را انتخاب کنید و سپس روی این دکمه کلیک کنید تا مورد در لیست به بالا منتقل شود.
- پایین - یک دایرکتوری یا دستور را انتخاب کنید و سپس روی این دکمه کلیک کنید تا مورد در لیست به پایین منتقل شود.
برای اطلاعات بیشتر در مورد اشکال زدایی در Android Studio به Debug Your App مراجعه کنید.
| میدان | توضیحات |
|---|---|
| نوع اشکال زدایی | یکی از گزینه های زیر را انتخاب کنید:
گزینه Detect Automatically توصیه می شود زیرا نوع اشکال زدایی مناسب را برای پروژه شما انتخاب می کند. |
| دایرکتوری های نماد | اگر می‌خواهید فایل‌های نماد را اضافه کنید تا اطلاعات C یا C++ تولید شده خارج از Android Studio را به اشکال‌زدا ارائه کنید، می‌توانید یک یا چند فهرست را در اینجا اضافه کنید. Android Studio ترجیحاً از فایل‌های موجود در این فهرست‌ها نسبت به فایل‌های تولید شده توسط افزونه Android برای Gradle استفاده می‌کند. دیباگر به ترتیب دایرکتوری ها را از بالا به پایین جستجو می کند تا آنچه را که نیاز دارد پیدا کند. به صورت بازگشتی در میان فایل های دایرکتوری جستجو می کند. برای بهینه سازی لیست و صرفه جویی در زمان، دایرکتوری هایی که اغلب استفاده می شوند را در بالای لیست قرار دهید. اگر یک دایرکتوری در بالای درخت مشخص کنید، جستجوی همه زیرشاخه ها ممکن است بیشتر طول بکشد. اگر یک دایرکتوری بسیار خاص اضافه کنید، زمان کمتری برای جستجو نیاز دارد. شما باید تعادل مناسبی بین سرعت و یافتن فایل های مورد نیاز برای اشکال زدایی پیدا کنید. به عنوان مثال، اگر فهرستی دارید که حاوی زیرشاخه‌هایی برای رابط‌های باینری مختلف اندروید (ABI) است، می‌توانید انتخاب کنید که یک فهرست برای یک ABI خاص یا برای همه ABI اضافه کنید. اگرچه جستجو در دایرکتوری سطح بالا ممکن است طولانی‌تر طول بکشد، اما اگر تصمیم به اشکالزدایی در دستگاه دیگری داشته باشید، بی‌خطرتر است. توجه داشته باشید که لازم نیست دایرکتوری های حاوی فایل های نماد Gradle را اضافه کنید زیرا دیباگر به طور خودکار از آنها استفاده می کند. |
| دستورات راه اندازی LLDB | دستورات LLDB را اضافه کنید که می‌خواهید قبل از اتصال دیباگر به فرآیند اجرا شوند. به عنوان مثال، می توانید تنظیماتی را برای محیط تعریف کنید، همانطور که در دستور زیر نشان داده شده است: LLDB دستورات را به ترتیب از بالا به پایین اجرا می کند. |
| LLDB Post Attach Commands | دستورات LLDB را اضافه کنید که می خواهید بلافاصله پس از اتصال دیباگر به فرآیند اجرا شوند. به عنوان مثال: LLDB دستورات را به ترتیب از بالا به پایین اجرا می کند. |
| فهرست کار میزبان | فهرست کار LLDB را مشخص کنید. |
| ورود به سیستم: کانال ها را هدف قرار دهید | گزینه های گزارش LLDB را مشخص کنید. Android Studio گزینه‌های پیش‌فرض را بر اساس تجربه تیم تنظیم می‌کند - بنابراین خیلی کند نیست اما حاوی اطلاعات مورد نیاز برای عیب‌یابی است. گزارش اغلب برای گزارش‌های باگ Android Studio درخواست می‌شود. این پیش فرض است برای جمع آوری اطلاعات بیشتر می توانید پیش فرض را تغییر دهید. به عنوان مثال، گزینه های گزارش زیر اطلاعاتی را در مورد یک lldb process platform :gdb-remote packets برای فهرست کامل دستورات log، دستور Android Studio گزارش‌های دستگاه را در مکان زیر قرار می‌دهد، جایی که یا اگر چندین کاربر به یک دستگاه دسترسی داشته باشند، گزارش‌ها را در مکان زیر قرار می‌دهد، جایی که برای اطلاعات در مورد استفاده از LLDB برای اشکال زدایی از راه دور، به اشکال زدایی از راه دور مراجعه کنید. |
| قبل از راه اندازی | به تعریف عملیات قبل از راه اندازی مراجعه کنید. |
برگه پروفایل
هنگامی که دستگاه شما دارای Android نسخه 7.1 یا پایین‌تر است، باید گزینه فعال کردن پروفایل پیشرفته را علامت بزنید تا ویژگی‌های خاصی در نمایه‌ساز اندروید فعال شود.
تست های اندروید
الگوی آزمایشی که باید استفاده کنید به مجموعه منبع شما بستگی دارد. الگوی Android Instrumented Tests برای تست ابزاری است. قالب Android JUnit برای تست واحد محلی است.
توجه: اگر از Firebase Test Lab برای آزمایش بر روی دستگاه‌های مختلف استفاده می‌کنید، می‌توانید از الگوی Android JUnit برای تعریف تست‌های ابزاردار خود استفاده کنید. برای اطلاعات بیشتر، به اجرای آزمایش‌های خود با آزمایشگاه آزمایشی Firebase مراجعه کنید.
توضیحات برگه زیر برگه ها و فیلدهای قالب تست Android Instrumented را پوشش می دهد. برای اطلاعات در مورد برگه ها و فیلدهای قالب تست Android JUnit، به صفحه JUnit Run/Debug Configuration IntelliJ مراجعه کنید.
برگه عمومی
در تب General ، می‌توانید مکان تست، ابزار دقیق، پوسته adb و گزینه‌های استقرار را مشخص کنید.
| میدان | توضیحات |
|---|---|
| ماژول | یک ماژول را برای اعمال این پیکربندی انتخاب کنید. |
| تست کنید | در این قسمت محل تست هایی را که می خواهید اجرا کنید مشخص کنید:
|
| دونده ابزار دقیق (اختیاری) | محل دونده ابزار دقیق را تایپ کنید. برای استفاده از یک گفتگو روی More کلیک کنید. فایل build.gradle مکان دونده ابزار دقیق را مشخص می کند. این مقدار بر آن غلبه می کند. پیش فرض معمولاً کلاس AndroidJUnitRunner از AndroidX Test است. |
| گزینه های اضافی | هر گزینه پیش فرض: هیچ گزینه ای وجود ندارد |
| Deployment Target Options: Target | یک گزینه را انتخاب کنید:
|
| گزینه های هدف استقرار: برای راه اندازی های آینده از همان دستگاه استفاده کنید | اگر می خواهید در آینده به طور خودکار از دستگاهی که از طریق گفتگوی Select Deployment Target انتخاب کرده اید استفاده کنید، این گزینه را انتخاب کنید. اگر دستگاه در دسترس نباشد، یک گفتگو دریافت خواهید کرد. پیش فرض: از حالت انتخاب خارج شد |
| قبل از راه اندازی | به تعریف عملیات قبل از راه اندازی مراجعه کنید. |
برگه متفرقه
برگه متفرقه شامل logcat و گزینه های نصب است.
| میدان | توضیحات |
|---|---|
| Logcat: قبل از راه اندازی، گزارش را پاک کنید | اگر می‌خواهید Android Studio قبل از شروع برنامه، داده‌های جلسات قبلی را از فایل گزارش حذف کند، این گزینه را انتخاب کنید. پیش‌فرض: لغو انتخاب شد. |
| گزینه های نصب: اگر APK تغییر نکرده است، از نصب صرفنظر کنید | در صورت انتخاب، Android Studio اگر تشخیص دهد که APK شما تغییر نکرده است، آن را مجدداً مستقر نمی کند. اگر می خواهید Android Studio به اجبار APK را نصب کند، حتی اگر تغییری نکرده باشد، این گزینه را از حالت انتخاب خارج کنید. پیش فرض: انتخاب شده است |
| گزینه های نصب: قبل از راه اندازی فعالیت، اجرای برنامه را اجباری متوقف کنید | در صورت انتخاب، زمانی که Android Studio تشخیص دهد که نیازی به نصب مجدد APK ندارد زیرا تغییری نکرده است، برنامه را به اجبار متوقف می‌کند تا برنامه از فعالیت راه‌انداز پیش‌فرض شروع شود. اگر این گزینه لغو انتخاب شود، اندروید استودیو برنامه را به اجبار متوقف نمی کند. این گزینه همراه با گزینه قبلی کار می کند که نصب یا عدم نصب APK را کنترل می کند. برای هر دو فیلد Installation Options ، آنها را در حالت پیش‌فرض بگذارید، مگر اینکه صراحتاً بخواهید هر بار نصب را اجباری کنید. در برخی موارد ممکن است بخواهید این گزینه را از حالت انتخاب خارج کنید. برای مثال، اگر در حال نوشتن یک موتور روش ورودی (IME) هستید، با توقف اجباری برنامه، آن را به‌عنوان صفحه‌کلید فعلی از حالت انتخاب خارج می‌کند، که ممکن است نخواهید. پیش فرض: انتخاب شده است |
| قبل از راه اندازی | به تعریف عملیات قبل از راه اندازی مراجعه کنید. |
تب دیباگر
گزینه های اشکال زدایی را در تب Debugger مشخص کنید.
برای کدهای C و C++، Android Studio از دیباگر LLDB استفاده می کند. علاوه بر رابط کاربری عادی اندروید استودیو، پنجره دیباگر دارای یک برگه LLDB است که به شما امکان می دهد دستورات LLDB را در حین اشکال زدایی وارد کنید. می توانید همان دستوراتی را که اندروید استودیو برای نمایش اطلاعات در رابط کاربری دیباگر استفاده می کند وارد کنید و می توانید عملیات اضافی را انجام دهید.
برای پروژه های C و C++، می توانید دایرکتوری های نماد، و همچنین راه اندازی LLDB و دستورات پیوست را در برگه Debugger اضافه کنید. برای انجام این کار، از دکمه های مشابه زیر استفاده می کنید:
- اضافه کنید - یک دایرکتوری یا دستور اضافه کنید.
- حذف کنید- یک دایرکتوری یا دستور را انتخاب کنید و سپس روی این دکمه کلیک کنید تا مورد حذف شود.
- بالا - یک دایرکتوری یا دستور را انتخاب کنید و سپس روی این دکمه کلیک کنید تا مورد در لیست به بالا منتقل شود.
- پایین - یک دایرکتوری یا دستور را انتخاب کنید و سپس روی این دکمه کلیک کنید تا مورد در لیست به پایین منتقل شود.
برای اطلاعات بیشتر در مورد اشکال زدایی در Android Studio به Debug Your App مراجعه کنید.
| میدان | توضیحات |
|---|---|
| نوع اشکال زدایی | یکی از گزینه های زیر را انتخاب کنید:
گزینه Detect Automatically توصیه می شود زیرا نوع اشکال زدایی مناسب را برای پروژه شما انتخاب می کند. |
| دایرکتوری های نماد | اگر می‌خواهید فایل‌های نماد را اضافه کنید تا اطلاعات C یا C++ تولید شده خارج از Android Studio را به اشکال‌زدا ارائه کنید، می‌توانید یک یا چند فهرست را در اینجا اضافه کنید. Android Studio ترجیحاً از فایل‌های موجود در این فهرست‌ها نسبت به فایل‌های تولید شده توسط افزونه Android برای Gradle استفاده می‌کند. دیباگر به ترتیب دایرکتوری ها را از بالا به پایین جستجو می کند تا آنچه را که نیاز دارد پیدا کند. به صورت بازگشتی در میان فایل های دایرکتوری جستجو می کند. برای بهینه سازی لیست و صرفه جویی در زمان، دایرکتوری هایی که اغلب استفاده می شوند را در بالای لیست قرار دهید. اگر یک دایرکتوری در بالای درخت مشخص کنید، جستجوی همه زیرشاخه ها ممکن است بیشتر طول بکشد. اگر یک دایرکتوری بسیار خاص اضافه کنید، زمان کمتری برای جستجو نیاز دارد. شما باید تعادل مناسبی بین سرعت و یافتن فایل های مورد نیاز برای اشکال زدایی پیدا کنید. به عنوان مثال، اگر فهرستی دارید که حاوی زیرشاخه‌هایی برای رابط‌های باینری مختلف اندروید (ABI) است، می‌توانید انتخاب کنید که یک فهرست برای یک ABI خاص یا برای همه ABI اضافه کنید. اگرچه جستجو در دایرکتوری سطح بالا ممکن است طولانی‌تر طول بکشد، اما اگر تصمیم به اشکالزدایی در دستگاه دیگری داشته باشید، بی‌خطرتر است. توجه داشته باشید که لازم نیست دایرکتوری های حاوی فایل های نماد Gradle را اضافه کنید زیرا دیباگر به طور خودکار از آنها استفاده می کند. |
| دستورات راه اندازی LLDB | دستورات LLDB را اضافه کنید که می‌خواهید قبل از اتصال دیباگر به فرآیند اجرا شوند. به عنوان مثال، می توانید تنظیماتی را برای محیط تعریف کنید، همانطور که در دستور زیر نشان داده شده است: LLDB دستورات را به ترتیب از بالا به پایین اجرا می کند. |
| LLDB Post Attach Commands | دستورات LLDB را اضافه کنید که می خواهید بلافاصله پس از اتصال دیباگر به فرآیند اجرا شوند. به عنوان مثال: LLDB دستورات را به ترتیب از بالا به پایین اجرا می کند. |
| فهرست کار میزبان | فهرست کار LLDB را مشخص کنید. |
| ورود به سیستم: کانال ها را هدف قرار دهید | گزینه های گزارش LLDB را مشخص کنید. Android Studio گزینه‌های پیش‌فرض را بر اساس تجربه تیم تنظیم می‌کند - بنابراین خیلی کند نیست اما حاوی اطلاعات مورد نیاز برای عیب‌یابی است. گزارش اغلب برای گزارش‌های باگ Android Studio درخواست می‌شود. این پیش فرض است برای جمع آوری اطلاعات بیشتر می توانید پیش فرض را تغییر دهید. به عنوان مثال، گزینه های گزارش زیر اطلاعاتی را در مورد یک lldb process platform :gdb-remote packets برای فهرست کامل دستورات log، دستور Android Studio گزارش‌های دستگاه را در مکان زیر قرار می‌دهد، جایی که یا اگر چندین کاربر به یک دستگاه دسترسی داشته باشند، گزارش‌ها را در مکان زیر قرار می‌دهد، جایی که برای اطلاعات در مورد استفاده از LLDB برای اشکال زدایی از راه دور ، به اشکال زدایی از راه دور مراجعه کنید. |
| قبل از راه اندازی | قبل از عملیات راه اندازی ، به تعریف مراجعه کنید. |
برنامه Devappserver موتور برنامه
این پیکربندی اجرا/اشکال زدایی مربوط به پلتفرم Google Cloud است. برای اطلاعات بیشتر ، به اجرای ، آزمایش و استقرار باطن مراجعه کنید. هنگامی که این مراحل را دنبال می کنید و پروژه خود را با پرونده build.gradle همگام سازی می کنید ، Android Studio یک پیکربندی Devappserver Engine App را برای شما ایجاد می کند.
توجه داشته باشید که الگوی سرور Enticle Idea App Engine Server یک الگوی متفاوت است که در Android Studio در دسترس نیست.
| میدان | شرح |
|---|---|
| فقط یک نمونه | اگر می خواهید اطمینان حاصل کنید که در حال حاضر فقط یک نمونه از پیکربندی Run/Debug اجرا شده است ، این گزینه را انتخاب کنید. این اجازه نمی دهد که چندین اجرای از همان پیکربندی به طور همزمان انجام شود. پیش فرض: انتخاب شده |
| ماژول | یک ماژول را برای اعمال این پیکربندی در انتخاب کنید. |
| هماهنگ با پیکربندی build.gradle | اگر یک ماژول موتور برنامه را اضافه کنید و به پرونده build.gradle همگام سازی کنید ، قسمت های پیکربندی Devappserver موتور برنامه برای شما پر می شوند (توصیه می شود). انتخاب پرونده> پروژه همگام سازی با پرونده های Gradle همچنین پروژه را همگام سازی می کند. پیش فرض: انتخاب شده |
| موتور برنامه SDK | مسیری را به یک Google App Engine SDK برای جاوا در دستگاه محلی تایپ کنید. روی ... کلیک کنید تا آن را از یک گفتگو انتخاب کنید. |
| مسیر جنگ | یک مسیر را به بایگانی برنامه وب (جنگ) از برنامه ای که در سرور توسعه محلی مستقر می کنید تایپ کنید. روی ... کلیک کنید تا آن را از یک گفتگو انتخاب کنید. |
| VM args | گزینه های خط فرمان را که می خواهید برای راه اندازی DevAppserver به VM منتقل کنید ، مشخص کنید. هنگام مشخص کردن گزینه ها:
برای کسب اطلاعات بیشتر در مورد گزینه های VM ، به اسناد مربوط به نسخه J2SE خود ، مانند پیش فرض: بدون گزینه |
| آدرس سرور | آدرس میزبان را برای استفاده برای سرور تایپ کنید. ممکن است شما نیاز به ارائه آدرس داشته باشید تا بتوانید از طریق رایانه دیگری در شبکه خود به سرور توسعه دسترسی پیدا کنید. آدرس 0.0.0.0 امکان دسترسی به محلی و دسترسی به نام میزبان را فراهم می کند. پیش فرض: localhost |
| درگاه سرور | شماره پورت را برای استفاده برای سرور تایپ کنید. پیش فرض: 8080 |
| بررسی به روزرسانی های SDK موتور برنامه را غیرفعال کنید | در صورت داده شده ، سرور توسعه برای بررسی در دسترس بودن نسخه جدید SDK با موتور App با App Engine تماس نخواهد گرفت . به طور پیش فرض ، سرور نسخه جدیدی را در هنگام راه اندازی بررسی می کند و در صورت موجود بودن نسخه جدید ، پیام را چاپ می کند. |
| قبل از راه اندازی | قبل از عملیات راه اندازی ، به تعریف مراجعه کنید. |
تنظیمات OS Run/اشکال زدایی را بپوشید
عارضه ، کاشی ، کاشی و الگوهای تماشای چهره به شما امکان می دهد برنامه های سیستم عامل را در دستگاه های مجازی یا سخت افزاری اجرا یا اشکال زدایی کنید. بیشتر گزینه های پیکربندی قالب همان گزینه های برنامه Android هستند. در اینجا گزینه هایی وجود دارد که خاص تر برای تنظیمات Run/Debug Wear OS است:
- برای کلیه تنظیمات Run/Debug Wear ، شما باید یک منبع داده عارضه خاص ، کاشی یا تماشای چهره (بسته به الگوی) را انتخاب کنید تا پیکربندی را اعمال کنید. به طور کلی هر یک از این نهادها با یک کلاس در کد شما مطابقت دارند.
- برای پیکربندی/تنظیم اشکال در عوارض سیستم عامل ، باید شکافی را که می خواهید داده های عوارض ارائه شده توسط منبع داده عوارض را قرار دهید ، انتخاب کنید. می توانید آن را در بالا ، راست ، پایین ، چپ یا پس زمینه صورت ساعت قرار دهید.
- برای تنظیم عارضه و تنظیم اشکال زدایی سیستم عامل ، شما همچنین باید نوع داده های عوارض ارائه شده توسط منبع داده عوارض را انتخاب کنید. انواع مختلفی که می توانید از آن انتخاب کنید محدود به مواردی است که توسط منبع داده عارضه انتخاب شده ارائه شده و توسط شکاف انتخاب شده پشتیبانی می شود. برای لیستی از انواع داده های عارضه ، به انواع و زمینه ها مراجعه کنید.
از طرف دیگر ، شما همچنین می توانید این سطوح را از نماد روده که در کنار اعلام سطح قرار دارد ، اجرا کنید ، همانطور که در تصویر زیر نشان داده شده است.
وقتی کد خود را اجرا، اشکال زدایی یا آزمایش می کنید، Android Studio از یک پیکربندی run/debug برای تعیین نحوه انجام عملیات استفاده می کند. به طور معمول ، پیکربندی در ابتدا ایجاد شده برای اجرای یا اشکال زدایی یک برنامه کافی است. با این حال ، می توانید تنظیمات جدید را تغییر داده و ایجاد کرده و الگوهای پیکربندی را متناسب با روند توسعه خود همانطور که در این صفحه توضیح داده شده است ، تغییر دهید.
برای اطلاعات بیشتر ، مستندات IntelliJ زیر را نیز مشاهده کنید:
در مورد تنظیمات اجرا/اشکال زدایی
تنظیمات اجرا/اشکال زدایی جزئیات مانند نصب برنامه ، راه اندازی و گزینه های تست را مشخص کنید. می توانید پیکربندی را برای استفاده یک بار تعریف کنید ، یا آن را برای استفاده در آینده ذخیره کنید. پس از ذخیره آن ، می توانید پیکربندی را از لیست کشویی Select Run/Debug Configuration در نوار ابزار انتخاب کنید. Android Studio به عنوان بخشی از پروژه تنظیمات را ذخیره می کند.
پیکربندی اجرا/اشکال زدایی در ابتدا ایجاد شده
هنگامی که برای اولین بار یک پروژه ایجاد می کنید ، Android Studio برای فعالیت اصلی بر اساس الگوی برنامه Android یک پیکربندی Run/Debug ایجاد می کند. برای اجرای یا اشکال زدایی پروژه خود ، همیشه باید حداقل یک پیکربندی اجرا/اشکال زدایی را تعریف کنید. به همین دلیل ، ما توصیه می کنیم که پیکربندی در ابتدا ایجاد شده را حذف نکنید.
دامنه پروژه و کنترل نسخه
تنظیمات اجرا/اشکال زدایی و تغییرات الگوی فقط برای پروژه فعلی اعمال می شود. شما می توانید از طریق سیستم کنترل نسخه خود یک پیکربندی اجرا/اشکال زدایی (اما نه یک الگوی) به اشتراک بگذارید. برای کسب اطلاعات بیشتر در مورد نحوه به اشتراک گذاری پیکربندی ، به نام و گزینه های پیکربندی به اشتراک مراجعه کنید.
گفتگوی تنظیمات Run/Debug را باز کنید
برای باز کردن گفتگوی تنظیمات Run/Debug ، Run > ویرایش پیکربندی ها را انتخاب کنید. گفتگوی تنظیمات Run/Debug ، همانطور که در شکل 1 نشان داده شده است ، ظاهر می شود.
شکل 1 . گفتگوی تنظیمات Run/اشکال زدایی
پانل سمت چپ گفتگو تنظیمات تعریف شده شما را بر اساس نوع الگو گروه بندی می کند و به شما امکان می دهد تا الگوهای پیکربندی را در پایین ویرایش کنید . می توانید پیکربندی انتخاب شده را در پنل سمت راست ویرایش کنید. برای دیدن هرگونه موارد پنهان ، گفتگو را تغییر دهید.
در این گفتگو می توانید:
- تنظیمات جدید RUN/اشکال زدایی را ایجاد کنید .
- تنظیمات اجرا/اشکال زدایی را ویرایش کنید.
- الگوهای پیکربندی را ویرایش کنید.
- تنظیم و تنظیمات گروهی.
پیکربندی اجرا/اشکال زدایی جدید ایجاد کنید
می‌توانید پیکربندی‌های run/debug جدید را از پنجره Run/Debug Configurations ، پنجره پروژه یا ویرایشگر کد تعریف کنید. پیکربندی جدید باید بر اساس یک الگوی پیکربندی باشد.
گفتگوی Run/Debug Configurations پیکربندی های RUN/اشکال زدایی شما و الگوهای پیکربندی موجود را نشان می دهد. می توانید یک پیکربندی جدید را مستقیماً از یک الگو یا از یک کپی از پیکربندی دیگر شروع کنید. سپس می توانید مقادیر فیلد را در صورت نیاز تغییر دهید.
از طرف دیگر، می‌توانید روی یک آیتم در پنجره Project کلیک راست کنید تا به طور خودکار یک پیکربندی خاص برای آن مورد ایجاد شود. به عنوان مثال ، اگر می خواهید یک فعالیت خاص را اجرا کنید ، می توانید روی پرونده Java Anice راست کلیک کرده و Run را انتخاب کنید. بسته به مورد مورد ، Android Studio از یک برنامه Android ، تست های Android Instrumented یا الگوی پیکربندی Junit برای ایجاد پیکربندی استفاده می کند.
در ویرایشگر کد، می توانید به راحتی یک پیکربندی تست و اجرا/اشکال زدایی برای یک کلاس یا متد ایجاد کنید و سپس آن را اجرا کنید.
وقتی پیکربندی را خارج از کادر گفتگوی Run/Debug Configurations ایجاد می‌کنید، پیکربندی موقتی است مگر اینکه آن را ذخیره کنید. به‌طور پیش‌فرض، می‌توانید تا پنج پیکربندی موقت در پروژه قبل از شروع حذف آنها توسط Android Studio داشته باشید. برای تغییر این پیش فرض ، تنظیمات Android Studio را باز کنید و تنظیمات پیشرفته> Run/Debug> محدودیت های موقت را تغییر دهید. برای کسب اطلاعات بیشتر در مورد تنظیمات موقت ، به ایجاد و ذخیره تنظیمات موقت اجرای/اشکال زدایی مراجعه کنید.
پیکربندی را بر اساس یک الگوی شروع کنید
برای تعریف پیکربندی اجرا/اشکال زدایی بر اساس یک الگوی ، این مراحل را دنبال کنید:
- گفتگوی تنظیمات Run/Debug را باز کنید .
- روی افزودن پیکربندی جدید کلیک کنید .
- یک الگوی پیکربندی را انتخاب کنید.
- یک نام را در قسمت نام تایپ کنید.
- در صورت لزوم پیکربندی را اصلاح کنید.
- روی Apply یا OK کلیک کنید.
حتماً هرگونه خطایی را که در پایین گفتگو نمایش داده می شود ، اصلاح کنید.
پیکربندی را از یک نسخه شروع کنید
برای تعریف پیکربندی اجرا/اشکال زدایی که از یک کپی از پیکربندی دیگر شروع می شود ، این مراحل را دنبال کنید:
- گفتگوی تنظیمات Run/Debug را باز کنید .
- پیکربندی Run/Debug موجود را در صفحه سمت چپ انتخاب کنید.
- روی کپی پیکربندی کلیک کنید .
- یک نام را در قسمت نام تایپ کنید.
- در صورت لزوم پیکربندی را اصلاح کنید.
- روی Apply یا OK کلیک کنید.
حتماً هرگونه خطایی را که در پایین گفتگو نمایش داده می شود ، اصلاح کنید.
پیکربندی را برای یک مورد در پروژه تعریف کنید
Android Studio می تواند برای برخی از موارد نمایش داده شده در پنجره Project یک پیکربندی اجرا/اشکال زدایی ایجاد کند. پیکربندی بر اساس یک الگوی پیکربندی است ، به شرح زیر است:
- پرونده جاوا فعالیت: الگوی برنامه Android .
- بسته: بسته به مجموعه منبع شما ، تست های سازنده Android یا الگوی Android Junit را آزمایش می کند . اگر یک تست Instrumented را انتخاب کنید ، از الگوی تست های Android Instrumented استفاده می کند. اگر یک تست واحد محلی را انتخاب کنید ، از الگوی Android Junit استفاده می کند. برای یک تست واحد محلی ، می توانید به صورت اختیاری با پوشش کد اجرا کنید. برای اطلاعات بیشتر ، به پوشش کد مراجعه کنید.
برای ایجاد پیکربندی Run/اشکال زدایی برای یک مورد در پروژه خود ، این مراحل را دنبال کنید:
- یک پروژه را در Android یا View Project باز کنید.
- در پنجره Project ، روی یک مورد قابل آزمایش راست کلیک کرده و filename اجرا کنید یا filename اشکال را انتخاب کنید. Android Studio یک پیکربندی موقت اجرا/اشکال زدایی ایجاد می کند و برنامه شما را راه اندازی می کند.
- لیست کشویی تنظیمات Run/Debug را در نوار ابزار باز کنید.
- Save Configuration را از گزینه های کنار پیکربندی که می خواهید ذخیره کنید انتخاب کنید.
شکل 2 . پیکربندی را ذخیره کنید
توجه: اگر راست کلیک کرده و همان مورد را اجرا کرده یا اشکال زدایی کنید (اما فعالیتی نیست) ، Android Studio پیکربندی جدیدی را ایجاد می کند.
پیکربندی تست را برای یک کلاس یا روش تعریف کنید
Android Studio به شما امکان می دهد پیکربندی آزمایش را برای یک کلاس یا روش تعریف کنید و سپس آن را اجرا کنید. به عنوان مثال ، اگر یک کلاس جدید ایجاد می کنید ، می توانید یک تست را برای آن ایجاد و اجرا کنید. اگر این تست گذشت ، می توانید تست های بقیه پروژه را اجرا کنید تا مطمئن شوید که کد جدید شما در جایی دیگر نمی شکند.
Android Studio بسته به مجموعه منبع شما ، از تست های Android Instrumented یا الگوی Android Junit استفاده می کند. برای یک تست واحد محلی ، می توانید به صورت اختیاری با پوشش کد اجرا کنید.
برای ایجاد پیکربندی اجرا/اشکال زدایی برای یک کلاس یا روش در کد جاوا ، این مراحل را دنبال کنید:
- یک پروژه را در Android یا View Project باز کنید.
- یک فایل جاوا را در ویرایشگر کد باز کنید.
- یک کلاس یا روش را در کد انتخاب کنید و سپس Control+Shift+T (فرمان+Shift+T) را فشار دهید.
- ایجاد تست جدید را از منو که ظاهر می شود انتخاب کنید.
- در گفتگوی ایجاد تست ، به صورت اختیاری تغییر یا تنظیم مقادیر و OK را کلیک کنید.
- در گفتگوی Select Directory Directory ، جایی را که در پروژه مورد نظر خود می خواهید استودیوی Android را انتخاب کنید ، انتخاب کنید. می توانید مکان را با ساختار دایرکتوری یا با انتخاب یک کلاس همسایه مشخص کنید.
- روی OK کلیک کنید.
آزمون جدید در پنجره پروژه در مجموعه منبع تست مربوطه ظاهر می شود.
- برای اجرای آزمون ، یکی از موارد زیر را انجام دهید:
- در پنجره Project ، روی تست کلیک راست کرده و Run یا Debug را انتخاب کنید.
- در ویرایشگر کد، روی تعریف کلاس یا نام متد در فایل آزمایشی کلیک راست کرده و گزینه Run یا Debug را انتخاب کنید تا همه متدهای کلاس را آزمایش کنید.
- لیست کشویی تنظیمات Run/Debug را در نوار ابزار باز کنید.
- Save Configuration را از گزینه های کنار پیکربندی که می خواهید ذخیره کنید انتخاب کنید.
شکل 3 . پیکربندی را ذخیره کنید
با استفاده از پیکربندی ذخیره شده ، یک برنامه را اجرا یا اشکال زدایی کنید
اگر پیکربندی Run/Debug را ذخیره کرده اید ، می توانید قبل از اجرای برنامه خود ، آن را انتخاب کنید.
برای استفاده از پیکربندی Run/Debug ذخیره شده ، این مراحل را دنبال کنید:
- پیکربندی Run/Debug را از لیست کشویی Select Run/Debug Configuration در نوار ابزار انتخاب کنید.
- Run > Run یا Run > Debug را انتخاب کنید.
لیست کشویی در سمت چپ اجرا است و اشکال زدایی ; برای مثال، .
از طرف دیگر ، روی Run کلیک کنید یا اشکال زدایی .
پیکربندی اجرا/اشکال زدایی را ویرایش کنید
برای ویرایش پیکربندی اجرا/اشکال زدایی ، این مراحل را دنبال کنید:
- گفتگوی تنظیمات Run/Debug را باز کنید .
- پیکربندی را در صفحه سمت چپ انتخاب کنید.
- در صورت لزوم پیکربندی را اصلاح کنید.
- روی Apply یا OK کلیک کنید.
حتماً هرگونه خطایی را که در پایین گفتگو نمایش داده می شود ، اصلاح کنید.
یک الگوی پیکربندی اجرا/اشکال زدایی را ویرایش کنید
می توانید الگوهای پیکربندی ارائه شده توسط Android Studio را متناسب با فرآیند توسعه خود ویرایش کنید. هنگامی که یک الگوی را ویرایش می کنید ، بر تنظیمات موجود که از الگوی استفاده می کنند ، تأثیر نمی گذارد. به عنوان مثال ، اگر نیاز به ایجاد تعدادی از تنظیمات از یک نوع خاص دارید ، می توانید الگوی را ویرایش کرده و پس از اتمام کار خود را تغییر دهید.
اگرچه شما نمی توانید الگوهای جدید ایجاد کنید ، می توانید تنظیماتی را برای استفاده مشابه با یک الگوی ایجاد کنید. برای ایجاد تنظیمات جدید می توانید یک پیکربندی را کپی کرده و کپی را ویرایش کنید.
برای ویرایش یک الگوی ، این مراحل را دنبال کنید:
- گفتگوی تنظیمات Run/Debug را باز کنید .
- روی ویرایش الگوهای پیکربندی کلیک کنید ...
- یک الگوی پیکربندی را انتخاب کنید.
- در صورت لزوم پیکربندی را اصلاح کنید.
- روی Apply یا OK کلیک کنید.
حتماً هرگونه خطایی را که در پایین گفتگو نمایش داده می شود ، اصلاح کنید.
تنظیمات و تنظیمات گروهی
در گفتگوی Run/Debug Configurations ، می توانید تنظیمات خود را سفارش دهید تا سریع آنها را پیدا کنید. می توانید موارد را در پوشه به صورت الفبایی مرتب کنید و پوشه های جدیدی را برای تنظیمات گروهی ایجاد کنید.
برای مرتب سازی تنظیمات به صورت الفبایی ، این مراحل را دنبال کنید:
- گفتگوی تنظیمات Run/Debug را باز کنید .
- پوشه ای را انتخاب کنید که حاوی تنظیمات باشد.
- روی مرتب سازی بر روی تنظیمات کلیک کنید .
- روی OK کلیک کنید تا گفتگو بسته شود.
برای گروه بندی پیکربندی ها در پوشه ها ، این مراحل را دنبال کنید:
- گفتگوی تنظیمات Run/Debug را باز کنید .
- پوشه ای را انتخاب کنید که حاوی تنظیمات باشد.
- روی ایجاد پوشه جدید کلیک کنید .
- یک نام را در قسمت نام پوشه تایپ کنید.
- برای ذخیره نام ، روی درخواست کلیک کنید.
عملیات قبل از راه اندازی را تعریف کنید
می توانید قبل از استفاده از پیکربندی Run/اشکال زدایی ، وظایف را برای اجرای آن مشخص کنید. کارها به ترتیب ظاهر شده در لیست انجام می شود.
توجه: تعریف قبل از راه اندازی یک ویژگی پیشرفته است. به جای استفاده از این ویژگی ، توصیه می کنیم منطق آمادگی را به عنوان وظایف در پرونده build.gradle خود قرار دهید تا هنگام ساخت از خط فرمان ، آنها را اجرا کنید.
برای ایجاد یک لیست کار ، این مراحل را دنبال کنید:
- در پایین گفتگوی تنظیمات Run/Debug Configurations قبل از راه اندازی (ممکن است نیاز به حرکت به پایین داشته باشید) ، روی Add کلیک کنید و یک نوع کار را انتخاب کنید. اگر یک گفتگو باز می شود ، فیلدها را پر کرده و روی OK کلیک کنید.
- در صورت لزوم کارهای بیشتری را اضافه کنید.
- برای سفارش کارها ، آنها را بکشید یا یک کار را انتخاب کنید و کلیک کنید و پایین برای حرکت به بالا یا پایین در لیست.
- اگر می خواهید تنظیمات پیکربندی Run/Debug را قبل از استفاده از آنها نمایش دهید ، نمایش این صفحه را انتخاب کنید.
این گزینه به طور پیش فرض انتخاب می شود.
- اگر می خواهید پنجره Run یا Debug Tool هنگام اجرای برنامه یا اشکال زدایی برنامه خود را فعال کنید ، پنجره Active Tool را انتخاب کنید.
این گزینه به طور پیش فرض انتخاب می شود.
برای حذف یک کار از لیست ، این مراحل را دنبال کنید:
- یک کار را انتخاب کنید.
- روی حذف کلیک کنید .
برای ویرایش یک کار ، این مراحل را دنبال کنید:
- یک کار را انتخاب کنید.
- روی Edit کلیک کنید .
- تنظیمات کار را در گفتگو که باز می شود ویرایش کنید و سپس بر روی OK کلیک کنید.
در جدول زیر وظایف موجود می توانید اضافه کنید.
| وظیفه | شرح |
|---|---|
| ابزار خارجی را اجرا کنید | برنامه ای را اجرا کنید که خارجی برای Android Studio باشد. در گفتگوی External Tools ، یک یا چند برنامه را که می خواهید اجرا کنید انتخاب کنید و سپس بر روی OK کلیک کنید. اگر برنامه هنوز در Android Studio تعریف نشده است ، تعریف خود را در گفتگوی ایجاد ابزارها اضافه کنید. برای اطلاعات بیشتر ، به پیکربندی ابزارهای شخص ثالث و ابزارهای خارجی مراجعه کنید. |
| پیکربندی دیگری را اجرا کنید | یکی از تنظیمات موجود/اشکال زدایی موجود را اجرا کنید. در انتخاب Configuration برای اجرای گفتگوی ، یک پیکربندی را برای اجرای انتخاب کنید و سپس بر روی OK کلیک کنید. |
| بسازید | پروژه یا ماژول را کامپایل کنید. Android Studio در صورتی که پیکربندی Run/Debug یک ماژول خاص را مشخص کند ، دستور Make Module را اجرا می کند ، یا در صورت عدم مشخص شدن ماژول ، دستور Make Project را اجرا می کند. |
| پروژه را بسازید | پروژه را کامپایل کنید. Android Studio دستور Make Project را اجرا می کند. |
| ایجاد ، بدون بررسی خطا | این گزینه همان ساخته شده است ، به جز اینکه Android Studio بدون در نظر گرفتن نتیجه تدوین ، پیکربندی Run/Debug را اجرا می کند. |
| ساخت مصنوعات | پشتیبانی نشده در استودیوی اندرویدی. |
| کار درجه یک را اجرا کنید | یک کار Gradle را اجرا کنید. در گفتگو که باز می شود ، جزئیات را مشخص کرده و سپس بر روی OK کلیک کنید. برای اطلاعات بیشتر ، به Gradle مراجعه کنید. |
| آگاهی از درجه یک | پروژه را کامپایل کنید و Gradle را اجرا کنید. |
| سازنده Gradle Engine | برنامه Gradle Builder App پروژه را همگام سازی می کند و سپس ماژول را می سازد. |
الگوهای پیکربندی
Android Studio الگوهای پیکربندی را برای کمک به شما در شروع سریع ارائه می دهد. بخش های زیر الگوهای مربوط به توسعه اندرویدی را با Android Studio شرح می دهد:
- برنامه اندروید
- تست های اندرویدی
- برنامه Devappserver موتور برنامه
- از عارضه سیستم عامل ، کاشی و چهره تماشا کنید
توجه: Android Studio 2.1. X و پایین یک الگوی برنامه بومی داشتند که نسخه های جدیدتر از آن برخوردار نیستند. اگر یک الگوی برنامه بومی در یک پروژه دارید ، Android Studio هنگام بارگیری پروژه ، آن را به برنامه Android تبدیل می کند. گفتگوی تبدیل پروژه شما را از طریق فرآیند راهنمایی می کند.
الگوهای پشتیبانی نشده
الگوهای پشتیبانی نشده زیر از IntelliJ Idea آمده و مختص توسعه اندرویدی با Android Studio نیست. برای کسب اطلاعات در مورد استفاده از این الگوها ، پیوندها به مستندات IDEANID IDEA را دنبال کنید.
- برنامه
- مرکب
- گریدل
- شیار
- کاربرد شیشه
- خراش جاوا
- JUnit
- کاتلین
- کلاتلین
- اشکال زدایی از دور
- اسکریپت پوسته
- TestNG
گزینه های پیکربندی مشترک
نام ، اجازه اجرای موازی و ذخیره به عنوان گزینه های فایل پروژه برای چندین الگوهای پیکربندی مشترک است. برای کسب اطلاعات بیشتر در مورد آنها ، به تنظیمات مشترک مراجعه کنید.
Android Studio پیکربندی مشترک/اشکال زدایی مشترک را در پرونده های XML شخصی تحت پوشش project_directory /.idea/runConfigurations/ ذخیره می کند. برای اطلاعات بیشتر ، به فرمت مبتنی بر فهرست در مستندات پروژه های IntelliJ مراجعه کنید.
برنامه اندروید
شما می توانید با استفاده از تنظیمات بر اساس این الگوی ، برنامه ها و فعالیت های Android را در دستگاه های مجازی یا سخت افزاری اجرا یا اشکالزدایی کنید.
برگه عمومی
در برگه عمومی می توانید گزینه های نصب ، راه اندازی و استقرار را مشخص کنید. برگه متفرقه همچنین شامل گزینه های نصب است.
| میدان | شرح |
|---|---|
| ماژول | یک ماژول را برای اعمال این پیکربندی در انتخاب کنید. |
| گزینه های نصب: استقرار | گزینه ای را انتخاب کنید:
|
| گزینه های نصب: به عنوان برنامه فوری مستقر شوید | اگر برنامه شما از تجربیات فوری پشتیبانی می کند-یعنی ، شما هنگام ایجاد یک پروژه جدید ، پشتیبانی از برنامه های فوری را اضافه می کنید ، یا یک یا چند ماژول ویژگی با قابلیت فوری ایجاد می کنید-می توانید با بررسی کادر ، آن ماژول های فعال شده را مستقر کنید در کنار استقرار به عنوان برنامه فوری . |
| گزینه های نصب: ویژگی هایی برای استقرار | اگر برنامه شما شامل ماژول های ویژگی است ، کادر کنار هر ویژگی مورد نظر خود را هنگام استقرار برنامه خود بررسی کنید. این گزینه را فقط در صورتی مشاهده می کنید که برنامه شما شامل ماژول های ویژگی باشد. توجه: اگر می خواهید بارگیری و نصب ماژول های ویژگی را به صورت تقاضا آزمایش کنید ، باید بعد از انتشار بسته برنامه خود این کار را انجام دهید و سپس از آهنگ تست داخلی کنسول Play استفاده کنید. برای کسب اطلاعات بیشتر ، بسته نرم افزاری برنامه خود را در کنسول Play بارگذاری کنید . |
| گزینه های نصب: پرچم ها را نصب کنید | گزینه های pm install را که می خواهید استفاده کنید تایپ کنید. گزینه ها را به همان روشی که در خط فرمان می خواهید ، اما بدون مسیری قالب بندی کنید. در اینجا چند نمونه آورده شده است: و پیش فرض: بدون گزینه. |
| گزینه های راه اندازی: راه اندازی | گزینه ای را انتخاب کنید:
|
| گزینه های پرتاب: پرچم ها را راه اندازی کنید | گزینه های ADB am start را که می خواهید استفاده کنید تایپ کنید. گزینه ها را به همان روشی که در خط فرمان می خواهید ، اما بدون قصد قالب بندی کنید. به عنوان مثال: اگر مقدار پرتاب هیچ چیز را انتخاب کنید ، این گزینه ظاهر نمی شود. پیش فرض: بدون گزینه. |
| گزینه های هدف استقرار: هدف | گزینه ای را انتخاب کنید:
|
گزینه های هدف استقرار: از همان دستگاه برای پرتاب های آینده استفاده کنید | به طور پیش فرض این گزینه انتخاب می شود به طوری که هر بار که یک برنامه را اجرا می کنید ، گفتگوی Select Deployment برای انتخاب یک دستگاه برای شما ظاهر می شود. وقتی این گزینه را انتخاب می کنید و سپس یک برنامه را اجرا می کنید ، گفتگوی Select Deployment برای انتخاب یک دستگاه برای شما ظاهر می شود. سپس ، هر بار که برنامه را اجرا می کنید ، بدون نمایش گفتگوی Select Deployment ، روی دستگاهی که انتخاب کرده اید راه اندازی می شود. برای اجرای برنامه در دستگاه دیگری ، یا انتخابی از دستگاه مشابه برای پرتاب های آینده استفاده کنید ، یا برنامه را با Run> Stop app یا Stop متوقف کنید ، و سپس دوباره آن را شروع کنید. گفتگوی Select Deployment نمایش داده می شود تا بتوانید یک دستگاه را انتخاب کنید. |
| قبل از راه اندازی | قبل از عملیات راه اندازی ، به تعریف مراجعه کنید. |
برگه متفرقه
در برگه متفرقه می توانید گزینه های LogCat ، نصب ، راه اندازی و استقرار را مشخص کنید. برگه عمومی همچنین شامل گزینه های نصب است.
| میدان | شرح |
|---|---|
| logcat: logcat را به طور خودکار نمایش دهید | هنگامی که این گزینه انتخاب شد ، پنجره LogCat هر بار که با موفقیت مستقر می کنید و با استفاده از این پیکربندی یک برنامه را راه اندازی می کنید و راه اندازی می کنید. پیش فرض: انتخاب شده. |
| logcat: قبل از راه اندازی ، ورود به سیستم را پاک کنید | اگر می خواهید Android Studio قبل از شروع برنامه ، داده ها را از جلسات قبلی از پرونده ورود به سیستم حذف کند ، این گزینه را انتخاب کنید. پیش فرض: انتخاب نشده است. |
| گزینه های نصب: اگر APK تغییر نکرده است ، نصب را پرش کنید. | در صورت انتخاب ، Android Studio در صورت تشخیص عدم تغییر ، APK شما را مجدداً مجدداً مجدداً مجدداً مورد استفاده قرار نمی دهد. اگر می خواهید Android Studio نصب APK را مجبور کند ، حتی اگر تغییر نکرده باشد ، این گزینه را انتخاب کنید. پیش فرض: انتخاب شده |
| گزینه های نصب: قبل از راه اندازی فعالیت ، برنامه را متوقف کنید | در صورت انتخاب ، هنگامی که Android Studio تشخیص داد که مجبور به نصب مجدد APK نیست زیرا تغییر نکرده است ، برنامه را مجبور می کند تا برنامه از فعالیت پرتاب پیش فرض شروع شود. اگر این گزینه انتخاب نشده باشد ، Android Studio برنامه را مجبور نمی کند. این گزینه با گزینه قبلی کار می کند که کنترل می کند که آیا APK نصب شده است یا خیر. برای هر دو قسمت گزینه های نصب ، آنها را به طور پیش فرض بگذارید مگر اینکه صریحاً بخواهید هر بار نصب را مجبور کنید. در بعضی موارد ممکن است بخواهید این گزینه را انتخاب کنید. به عنوان مثال ، اگر در حال نوشتن یک موتور روش ورودی (IME) هستید ، متوقف کردن برنامه آن را به عنوان صفحه کلید فعلی انتخاب می کند ، که شاید شما نمی خواهید. پیش فرض: انتخاب شده |
| قبل از راه اندازی | قبل از عملیات راه اندازی ، به تعریف مراجعه کنید. |
برگه
گزینه های اشکال زدایی را در برگه Debugger مشخص کنید.
برای کد C و C ++ ، Android Studio از Debugger LLDB استفاده می کند. علاوه بر UI استودیوی Android معمولی ، پنجره Debugger دارای یک برگه LLDB است که به شما امکان می دهد در هنگام اشکال زدایی دستورات LLDB را وارد کنید. می توانید همان دستوراتی را که Android Studio برای نمایش اطلاعات در Debugger UI از آن استفاده می کند ، وارد کنید و می توانید عملیات اضافی را انجام دهید.
برای پروژه های C و C ++ ، می توانید دایرکتوری های نماد ، و همچنین LLDB Startup و Post Attach را در برگه Debugger اضافه کنید. برای انجام این کار ، از دکمه های مشابه موارد زیر استفاده می کنید:
- اضافه کنید - یک دایرکتوری یا دستور اضافه کنید.
- حذف کنید- یک دایرکتوری یا دستور را انتخاب کنید و سپس برای حذف مورد بر روی این دکمه کلیک کنید.
- بالا - یک دایرکتوری یا دستور را انتخاب کنید ، و سپس بر روی این دکمه کلیک کنید تا مورد در لیست حرکت کند.
- پایین - یک دایرکتوری یا دستور را انتخاب کنید ، و سپس بر روی این دکمه کلیک کنید تا مورد در لیست پایین بیاید.
برای کسب اطلاعات بیشتر در مورد اشکال زدایی در استودیوی اندرویدی ، به برنامه خود مراجعه کنید.
| میدان | شرح |
|---|---|
| نوع اشکال زدایی | یکی از گزینه های زیر را انتخاب کنید:
گزینه Detect به طور خودکار توصیه می شود زیرا نوع اشکال زدایی مناسب را برای پروژه شما انتخاب می کند. |
| دایرکه | اگر می خواهید پرونده های نماد را اضافه کنید تا اطلاعات C یا C ++ تولید شده در خارج از Android Studio را به اشکال زدایی ارائه دهید ، می توانید یک یا چند دایرکتوری را در اینجا اضافه کنید. Android Studio ترجیحاً از هر پرونده موجود در این دایرکتوری ها بیش از پرونده های تولید شده توسط افزونه Android برای Gradle استفاده می کند. اشکال زدایی به ترتیب ، دایرکتوری ها را از بالا به پایین جستجو می کند ، تا زمانی که آنچه را که لازم دارد پیدا کند. آن را به صورت بازگشتی از طریق پرونده های موجود در فهرست جستجو می کند. برای بهینه سازی لیست و صرفه جویی در وقت ، دایرکتوری ها را که اغلب در بالای لیست استفاده می شود قرار دهید. اگر یک دایرکتوری را در درخت مشخص کنید ، می تواند بیشتر طول بکشد تا همه زیر مجموعه ها را جستجو کنید. اگر یک دایرکتوری بسیار خاص اضافه کنید ، برای جستجوی زمان کمتری طول می کشد. شما باید تعادل مناسب بین سرعت و یافتن پرونده های مورد نیاز برای اشکال زدایی را پیدا کنید. به عنوان مثال ، اگر دایرکتوری دارید که حاوی زیر مجموعه هایی برای رابط های باینری مختلف اندرویدی (ABI) باشد ، می توانید دایرکتوری را برای یک ABI خاص یا برای همه ABI ها اضافه کنید. اگرچه جستجوی دایرکتوری سطح بالا می تواند طولانی تر شود ، اما اگر تصمیم به اشکال زدایی در یک دستگاه دیگر دارید ، بسیار ناخوشایند تر است. توجه داشته باشید که لازم نیست دایرکتوری های حاوی پرونده های نماد Gradle را اضافه کنید زیرا اشکال زدایی به طور خودکار از آنها استفاده می کند. |
| دستورات راه اندازی LLDB | دستورات LLDB را که می خواهید قبل از اتصال اشکال زدایی به فرآیند انجام دهید ، اضافه کنید. به عنوان مثال ، می توانید تنظیمات محیط را تعریف کنید ، همانطور که در دستور زیر نشان داده شده است: LLDB دستورات را به ترتیب از بالا به پایین اجرا می کند. |
| LLDB ارسال دستورات پیوست | دستورات LLDB را که می خواهید درست پس از اتصال اشکال زدایی به فرآیند ، اضافه کنید. به عنوان مثال: LLDB دستورات را به ترتیب از بالا به پایین اجرا می کند. |
| فهرست کار میزبان | فهرست کار LLDB را مشخص کنید. |
| ورود به سیستم: کانال های هدف | گزینه های ورود به سیستم LLDB را مشخص کنید. Android Studio گزینه های پیش فرض را بر اساس تجربه تیم تنظیم می کند - بنابراین خیلی کند نیست اما حاوی اطلاعات لازم برای مشکلات عیب یابی است. این گزارش اغلب برای گزارش اشکالات استودیوی Android درخواست می شود. این پیش فرض است برای جمع آوری اطلاعات بیشتر می توانید پیش فرض را تغییر دهید. به عنوان مثال ، گزینه های ورود به سیستم زیر اطلاعات مربوط به یک lldb process platform :gdb-remote packets برای لیست کاملی از دستورات ورود به سیستم ، دستور Android Studio سیاهههای مربوط به مکان زیر را قرار می دهد ، جایی که یا اگر چندین کاربر به یک دستگاه دسترسی پیدا کنند ، سیاهههای مربوط را در مکان زیر قرار می دهند ، جایی که برای اطلاعات در مورد استفاده از LLDB برای اشکال زدایی از راه دور ، به اشکال زدایی از راه دور مراجعه کنید. |
| قبل از راه اندازی | قبل از عملیات راه اندازی ، به تعریف مراجعه کنید. |
برگه پروفایل
گزینه Enable Advanced Profiling باید بررسی شود تا ویژگی های خاصی در Android Profiler در هنگام کار دستگاه Android 7.1 یا پایین تر فعال شود.
تست های اندرویدی
الگوی آزمایشی که باید استفاده کنید بستگی به مجموعه منبع شما دارد. الگوی تست های Android Instrumented برای یک تست ابزار دقیق است. الگوی Android Junit برای تست واحد محلی است.
توجه: اگر از آزمایشگاه تست Firebase برای آزمایش انواع دستگاه ها استفاده می کنید ، می توانید از الگوی Android Junit برای تعریف تست های ساز خود استفاده کنید. برای اطلاعات بیشتر ، آزمایشات خود را با آزمایشگاه تست Firebase انجام دهید .
توضیحات برگه زیر زبانه ها و فیلدهای مربوط به الگوی تست Android را پوشش می دهد. برای کسب اطلاعات در مورد زبانه ها و زمینه های الگوی تست Android Junit ، به پیکربندی Run/اشکال زدایی IntelliJ: صفحه Junit مراجعه کنید.
برگه عمومی
به طور کلی برگه ، می توانید مکان تست ، دونده ابزار دقیق ، ADB Shell و گزینه های استقرار را مشخص کنید.
| میدان | شرح |
|---|---|
| ماژول | یک ماژول را برای اعمال این پیکربندی در انتخاب کنید. |
| تست کنید | در این زمینه مکان تست هایی را که می خواهید اجرا کنید مشخص کنید:
|
| دونده ابزار خاص (اختیاری) | مکان دونده ابزار دقیق را تایپ کنید. برای استفاده از گفتگو بیشتر کلیک کنید. پرونده build.gradle مکان دونده ابزار دقیق را مشخص می کند. این مقدار آن را نادیده می گیرد. پیش فرض به طور معمول کلاس AndroidJUnitRunner از تست Androidx است. |
| گزینه های اضافی | گزینه های پیش فرض: بدون گزینه |
| گزینه های هدف استقرار: هدف | گزینه ای را انتخاب کنید:
|
| گزینه های هدف استقرار: از همان دستگاه برای پرتاب های آینده استفاده کنید | اگر می خواهید به طور خودکار از دستگاهی که از طریق گفتگوی Select Deployment Target در آینده انتخاب کرده اید استفاده کنید ، این گزینه را انتخاب کنید. اگر دستگاه در دسترس نباشد ، گفتگو دریافت خواهید کرد. پیش فرض: انتخاب نشده |
| قبل از راه اندازی | قبل از عملیات راه اندازی ، به تعریف مراجعه کنید. |
برگه متفرقه
برگه متفرقه شامل گزینه های LogCat و نصب است.
| میدان | شرح |
|---|---|
| logcat: قبل از راه اندازی ، ورود به سیستم را پاک کنید | اگر می خواهید Android Studio قبل از شروع برنامه ، داده ها را از جلسات قبلی از پرونده ورود به سیستم حذف کند ، این گزینه را انتخاب کنید. پیش فرض: انتخاب نشده است. |
| گزینه های نصب: اگر APK تغییر نکرده است ، نصب را پرش کنید | در صورت انتخاب ، Android Studio در صورت تشخیص عدم تغییر ، APK شما را مجدداً مجدداً مجدداً مجدداً مورد استفاده قرار نمی دهد. اگر می خواهید Android Studio نصب APK را مجبور کند ، حتی اگر تغییر نکرده باشد ، این گزینه را انتخاب کنید. پیش فرض: انتخاب شده |
| گزینه های نصب: قبل از راه اندازی فعالیت ، برنامه را متوقف کنید | در صورت انتخاب ، هنگامی که Android Studio تشخیص داد که مجبور به نصب مجدد APK نیست زیرا تغییر نکرده است ، برنامه را مجبور می کند تا برنامه از فعالیت پرتاب پیش فرض شروع شود. اگر این گزینه انتخاب نشده باشد ، Android Studio برنامه را مجبور نمی کند. این گزینه در رابطه با گزینه قبلی کار می کند که کنترل می کند که آیا APK نصب شده است یا خیر. برای هر دو قسمت گزینه های نصب ، آنها را به طور پیش فرض بگذارید مگر اینکه صریحاً بخواهید هر بار نصب را مجبور کنید. در بعضی موارد ممکن است بخواهید این گزینه را انتخاب کنید. به عنوان مثال ، اگر در حال نوشتن یک موتور روش ورودی (IME) هستید ، متوقف کردن برنامه آن را به عنوان صفحه کلید فعلی انتخاب می کند ، که شاید شما نمی خواهید. پیش فرض: انتخاب شده |
| قبل از راه اندازی | قبل از عملیات راه اندازی ، به تعریف مراجعه کنید. |
Debugger tab
Specify debug options in the Debugger tab.
For C and C++ code, Android Studio uses the LLDB debugger. In addition to the normal Android Studio UI, the debugger window has an LLDB tab that lets you enter LLDB commands during debugging. You can enter the same commands that Android Studio uses to display information in the debugger UI, and you can perform additional operations.
For C and C++ projects, you can add symbol directories, as well as LLDB startup and post attach commands, in the Debugger tab. To do so, you use buttons similar to the following:
- اضافه کنید - Add a directory or command.
- حذف کنید- Select a directory or command, and then click this button to remove the item.
- بالا - Select a directory or command, and then click this button to move the item up in the list.
- پایین - Select a directory or command, and then click this button to move the item down in the list.
See Debug Your App for more information about debugging in Android Studio.
| میدان | Description |
|---|---|
| Debug type | یکی از گزینه های زیر را انتخاب کنید:
The Detect Automatically option is recommended because it chooses the right debug type for your project. |
| Symbol Directories | If you want to add symbol files to provide the debugger with C or C++ information generated outside of Android Studio, you can add one or more directories here. Android Studio preferentially uses any files within these directories over files generated by the Android Plugin for Gradle . The debugger searches the directories from top to bottom, in order, until it finds what it needs. It searches recursively through the files in the directory. To optimize the list and save time, put the directories used most often toward the top of the list. If you specify a directory high in the tree, it can take longer to search all of the subdirectories. If you add a very specific directory, it takes less time to search. You need to find the right balance between speed and finding the files you need for debugging. For example, if you have a directory that contains subdirectories for different Android Binary Interfaces (ABIs), you can choose to add a directory for a specific ABI or for all ABIs. Although it can take longer to search through the upper-level directory, it's also more foolproof if you decide to debug on a different device. Note that you don't have to add directories containing Gradle symbol files because the debugger uses them automatically. |
| LLDB Startup Commands | Add LLDB commands that you want to execute before the debugger attaches to the process. For example, you can define settings for the environment, as shown in the following command: LLDB executes the commands in order from top to bottom. |
| LLDB Post Attach Commands | Add LLDB commands that you want to execute right after the debugger attaches to the process. به عنوان مثال: LLDB executes the commands in order from top to bottom. |
| Host working directory | Specify the LLDB working directory. |
| Logging: Target channels | Specify LLDB log options. Android Studio sets the default options based on the team's experience — so it's not too slow but contains needed information for troubleshooting issues. The log is often requested for Android Studio bug reports. This default is You can change the default to gather more information. For example, the following log options gather information about a specific lldb process platform :gdb-remote packets For a complete list of log commands, enter the Android Studio places device logs in the following location, where Or, if multiple users access a device, it places the logs in the following location, where For information about using LLDB for remote debugging, see Remote Debugging . |
| قبل از راه اندازی | See Defining Before Launch Operations . |
App Engine DevAppServer
This run/debug configuration applies to the Google Cloud Platform. For more information, see Running, Testing, and Deploying the Backend . When you follow these steps and sync your project to the build.gradle file, Android Studio creates an App Engine DevAppServer configuration for you.
Note that the IntellJ IDEA App Engine Server template is a different template that's not available in Android Studio.
| میدان | Description |
|---|---|
| Single instance only | If you want to make sure that only one instance of the run/debug configuration is currently executed, select this option. It doesn't allow multiple runs of the same configuration at the same time. Default: selected |
| ماژول | Select a module to apply this configuration to. |
| Synchronize with build.gradle configuration | If you add an App Engine module and sync to the build.gradle file, the App Engine DevAppServer configuration fields are filled in for you (recommended). Selecting File > Sync Project with Gradle Files also syncs the project. Default: selected |
| App Engine SDK | Type a path to a Google App Engine SDK for Java on the local machine. Click ... to select it from a dialog. |
| War Path | Type a path to the Web Application Archive (WAR) directory of the app you're deploying on the local development server. Click ... to select it from a dialog. |
| VM Args | Specify the command-line options you want to pass to the VM for launching the DevAppServer. When specifying the options:
For more information about VM options, see the documentation for your J2SE version, such as Default: no options |
| آدرس سرور | Type the host address to use for the server. You might need to provide the address to be able to access the development server from another computer on your network. An address of 0.0.0.0 allows both localhost access and hostname access. Default: localhost |
| Server Port | Type the port number to use for the server. Default: 8080 |
| Disable Check for App Engine SDK Updates | If given, the development server will not contact App Engine to check for the availability of a new release of the SDK. By default, the server checks for a new version on startup, and prints a message if a new version is available. |
| قبل از راه اندازی | See Defining Before Launch Operations . |
Wear OS run/debug configurations
The Wear OS Complication, Tile, and Watch Face templates let you run or debug Wear OS apps on virtual or hardware devices. Most of the template configuration options are the same as the Android App options . Here are the options that are more specific to the Wear OS run/debug configurations:
- For all Wear run/debug configurations, you have to select a specific complication data source, tile, or watch face (depending on the template) to apply the configuration to. Generally each of these entities corresponds to a class in your code.
- For the Wear OS Complication run/debug configuration, you must choose the Slot where you want to put the complication data provided by the complication data source. You can choose to put it at the top, right, bottom, left, or background of the watch face.
- For the Wear OS Complication run/debug configuration, you must also select the Type of the complication data provided by the complication data source. The types you can choose from are limited to those that are provided by the chosen complication data source and supported by the chosen slot. For a list of complication data types, see Types and fields .
Alternatively, you can also run these surfaces from the gutter icon that is located next to the declaration of the surface, as shown in the following image.
وقتی کد خود را اجرا، اشکال زدایی یا آزمایش می کنید، Android Studio از یک پیکربندی run/debug برای تعیین نحوه انجام عملیات استفاده می کند. Typically, the initially-created configuration is sufficient to run or debug an app. However, you can modify and create new configurations, and modify the configuration templates to suit your development process as described on this page.
For more information, also see the following IntelliJ documentation:
About run/debug configurations
Run/debug configurations specify details such as app installation, launch, and test options. You can define a configuration for one-time use, or save it for future use. After you save it, you can select the configuration from the Select Run/Debug Configuration drop-down list within the toolbar . Android Studio saves configurations as part of the project.
Initially-created run/debug configuration
When you first create a project, Android Studio creates a run/debug configuration for the main activity based on the Android App template . To run or debug your project, you must always have at least one run/debug configuration defined. For this reason, we recommend that you don't delete the initially-created configuration.
Project scope and version control
Run/debug configurations and template changes apply to the current project only. You can share a run/debug configuration (but not a template) through your version control system. For more information about how to share a configuration, see Name and Share Configuration Options .
Open the Run/Debug Configurations dialog
To open the Run/Debug Configurations dialog, select Run > Edit Configurations . The Run/Debug Configurations dialog appears, as shown in figure 1.
شکل 1 . The Run/Debug Configurations dialog
The left panel of the dialog groups your defined configurations by template type, and allows you to edit configuration templates at the bottom. You can edit the selected configuration in the right panel. Resize the dialog to see any hidden items.
In this dialog, you can:
- Create new run/debug configurations .
- Edit run/debug configurations.
- Edit configuration templates.
- Sort and group configurations.
Create a new run/debug configuration
می‌توانید پیکربندی‌های run/debug جدید را از پنجره Run/Debug Configurations ، پنجره پروژه یا ویرایشگر کد تعریف کنید. The new configuration must be based on a configuration template .
The Run/Debug Configurations dialog displays your run/debug configurations and the available configuration templates. می توانید یک پیکربندی جدید را مستقیماً از یک الگو یا از یک کپی از پیکربندی دیگر شروع کنید. سپس می توانید مقادیر فیلد را در صورت نیاز تغییر دهید.
از طرف دیگر، می‌توانید روی یک آیتم در پنجره Project کلیک راست کنید تا به طور خودکار یک پیکربندی خاص برای آن مورد ایجاد شود. For example, if you want to run a particular activity, you can right-click the activity Java file and select Run . Depending on the item, Android Studio uses an Android App , Android Instrumented Tests , or JUnit configuration template to create the configuration.
در ویرایشگر کد، می توانید به راحتی یک پیکربندی تست و اجرا/اشکال زدایی برای یک کلاس یا متد ایجاد کنید و سپس آن را اجرا کنید.
وقتی پیکربندی را خارج از کادر گفتگوی Run/Debug Configurations ایجاد می‌کنید، پیکربندی موقتی است مگر اینکه آن را ذخیره کنید. به‌طور پیش‌فرض، می‌توانید تا پنج پیکربندی موقت در پروژه قبل از شروع حذف آنها توسط Android Studio داشته باشید. To change this default, open Android Studio settings, and change Advanced Settings > Run/Debug > Temporary configurations limit . For more information about temporary configurations, see Creating and Saving Temporary Run/Debug Configurations .
Start a configuration based on a template
To define a run/debug configuration based on a template, follow these steps:
- Open the Run/Debug Configurations dialog .
- Click Add New Configuration .
- Select a configuration template .
- Type a name in the Name field.
- Modify the configuration, as needed.
- Click Apply or OK .
Be sure to correct any errors displayed at the bottom of the dialog.
Start a configuration from a copy
To define a run/debug configuration starting from a copy of another configuration, follow these steps:
- Open the Run/Debug Configurations dialog .
- Select an existing run/debug configuration in the left pane.
- Click Copy Configuration .
- Type a name in the Name field.
- Modify the configuration, as needed.
- Click Apply or OK .
Be sure to correct any errors displayed at the bottom of the dialog.
Define a configuration for an item in the project
Android Studio can create a run/debug configuration for some items displayed in the Project window. The configuration is based on a configuration template, as follows:
- Activity Java file: The Android App template.
- Package: Android Instrumented Tests or Android JUnit template, depending on your source set . If you select an instrumented test , then it uses the Android Instrumented Tests template. If you select a local unit test , then it uses the Android JUnit template. For a local unit test, you can optionally run with code coverage. For more information, see Code Coverage .
To create a run/debug configuration for an item in your project, follow these steps:
- Open a project in Android or Project view .
- In the Project window, right-click a testable item and select either Run filename or Debug filename . Android Studio creates a temporary run/debug configuration and launches your app.
- Open the Select Run/Debug Configuration drop-down list in the toolbar.
- Select Save Configuration from the options next to the configuration that you want to save.
Figure 2 . Save the configuration
Note: If you right-click and run or debug the same item (but not an activity), Android Studio creates a new configuration.
Define a test configuration for a class or method
Android Studio lets you define a test run configuration for a class or method, and then execute it. For example, if you create a new class, you can create and run a test for it. If the test passes, you can then run the tests for the rest of the project to make sure that your new code doesn't break anything somewhere else.
Android Studio uses the Android Instrumented Tests or Android JUnit template, depending on your source set . For a local unit test, you can optionally run with code coverage .
To create a run/debug configuration for a class or method in your Java code, follow these steps:
- Open a project in Android or Project view .
- Open a Java file in the Code Editor.
- Select a class or method in the code, and then press Control+Shift+T (Command+Shift+T).
- Select Create New Test from the menu that appears.
- In the Create Test dialog, optionally change or set the values and click OK .
- In the Choose Destination Directory dialog, select where in the project you want Android Studio to place the test. You can specify the location by directory structure or by selecting a neighboring class.
- روی OK کلیک کنید.
The new test appears in the Project window in the corresponding test source set.
- To run the test, do one of the following:
- در پنجره Project ، روی تست کلیک راست کرده و Run یا Debug را انتخاب کنید.
- در ویرایشگر کد، روی تعریف کلاس یا نام متد در فایل آزمایشی کلیک راست کرده و گزینه Run یا Debug را انتخاب کنید تا همه متدهای کلاس را آزمایش کنید.
- Open the Select Run/Debug Configuration drop-down list in the toolbar.
- Select Save Configuration from the options next to the configuration that you want to save.
Figure 3 . Save the configuration
Run or debug an app using a saved configuration
If you've saved a run/debug configuration, you can select it before you run or debug your app.
To use a saved run/debug configuration, follow these steps:
- Select the run/debug configuration from the Select Run/Debug Configuration drop-down list within the toolbar .
- Select Run > Run or Run > Debug .
The drop-down list is to the left of Run and Debug ; برای مثال، .
Alternatively, click Run or Debug .
Edit a run/debug configuration
To edit a run/debug configuration, follow these steps:
- Open the Run/Debug Configurations dialog .
- Select a configuration in the left pane.
- Modify the configuration, as needed.
- Click Apply or OK .
Be sure to correct any errors displayed at the bottom of the dialog.
Edit a run/debug configuration template
You can edit the configuration templates provided by Android Studio to suit your development process. When you edit a template, it doesn't affect existing configurations that use the template. So, for example, if you need to create a number of configurations of a certain type, you can edit the template and then change it back when you're done.
Although you can't create new templates, you can create configurations to use similar to a template. You can copy a configuration and edit the copy to create new configurations.
To edit a template, follow these steps:
- Open the Run/Debug Configurations dialog .
- Click Edit configuration templates... .
- Select a configuration template.
- Modify the configuration, as needed.
- Click Apply or OK .
Be sure to correct any errors displayed at the bottom of the dialog.
Sort and group configurations
In the Run/Debug Configurations dialog, you can order your configurations to find them quickly. You can sort the items in the folder alphabetically, and create new folders to group configurations.
To sort configurations alphabetically, follow these steps:
- Open the Run/Debug Configurations dialog .
- Select a folder that contains configurations.
- Click Sort Configurations .
- روی OK کلیک کنید تا گفتگو بسته شود.
To group configurations in folders, follow these steps:
- Open the Run/Debug Configurations dialog .
- Select a folder that contains configurations.
- Click Create New Folder .
- Type a name in the Folder Name field.
- Click Apply to save the name.
Define before-launch operations
You can specify tasks to execute before applying the run/debug configuration. The tasks are performed in the order they appear in the list.
Note: Defining before launch tasks is an advanced feature. Instead of using this feature, we recommend that you put any preparation logic as tasks in your build.gradle file so they'll be executed when you build from the command line.
To create a task list, follow these steps:
- At the bottom of the Run/Debug Configurations dialog under Before launch (you may need to scroll down), click Addand select a task type. If a dialog opens, fill in the fields and click OK .
- Add more tasks as needed.
- To order the tasks, drag them or select a task and click Up and Down to move it up or down in the list.
- Select Show this page if you want to display the run/debug configuration settings before applying them.
This option is deselected by default.
- Select Active tool window if you want the Run or Debug tool window to be activated when you run or debug your app.
This option is selected by default.
To remove a task from the list, follow these steps:
- یک کار را انتخاب کنید.
- Click Remove .
To edit a task, follow these steps:
- یک کار را انتخاب کنید.
- روی Edit کلیک کنید .
- Edit the task settings in the dialog that opens, and then click OK .
The following table lists the available tasks you can add.
| وظیفه | Description |
|---|---|
| Run External tool | Run an application that's external to Android Studio. In the External Tools dialog, select one or more applications that you want to run and then click OK . If the application isn't defined in Android Studio yet, add its definition in the Create Tools dialog. For more information, see Configuring Third-Party Tools and External Tools . |
| Run Another Configuration | Execute one of the existing run/debug configurations. In the Choose Configuration to Execute dialog, select a configuration to execute and then click OK . |
| بسازید | Compile the project or the module. Android Studio executes the Make Module command if the run/debug configuration specifies a particular module, or it executes the Make Project command if no modules are specified. |
| Make Project | Compile the project. Android Studio executes the Make Project command . |
| Make, no error check | This option is the same as Make , except that Android Studio executes the run/debug configuration irrespective of the compilation result. |
| Build Artifacts | Unsupported in Android Studio. |
| Run Gradle task | Run a Gradle task. In the dialog that opens, specify the details and then click OK . For more information, see Gradle . |
| Gradle-aware Make | Compile the project and run Gradle. |
| App Engine Gradle builder | The App Engine Gradle builder task syncs the project and then builds the module. |
Configuration templates
Android Studio provides configuration templates to help you get started quickly. The following sections describe the templates that apply to Android development with Android Studio:
Note: Android Studio 2.1. x and lower had a Native Application template, which newer versions don't have. If you have a Native Application template in a project, Android Studio converts it to Android App when you load the project. A Convert Project dialog guides you through the process.
Unsupported templates
The following unsupported templates come from IntelliJ IDEA and aren't specific to Android development with Android Studio. For information about using these templates, follow the links to the IntelliJ IDEA documentation.
- برنامه
- مرکب
- گریدل
- شیار
- JAR Application
- Java Scratch
- JUnit
- کاتلین
- Kotlin Script
- Remote Debug
- اسکریپت پوسته
- TestNG
Common configuration options
The Name , Allow parallel run , and Store as project file options are common to multiple configuration templates. To learn more about them, see Common settings .
Android Studio stores the shared run/debug configuration in individual XML files under the project_directory /.idea/runConfigurations/ folder. For more information, see Directory-based format in the IntelliJ projects documentation.
برنامه اندروید
You can run or debug Android apps and activities on virtual or hardware devices by using configurations based on this template.
General tab
In the General tab, you can specify installation, launch, and deployment options. The Miscellaneous tab also contains installation options.
| میدان | Description |
|---|---|
| ماژول | Select a module to apply this configuration to. |
| Installation Options: Deploy | Select an option:
|
| Installation Options: Deploy as instant app | If your app supports instant experiences—that is, you either add support for instant apps when you create a new project , or you create one or more instant-enabled feature modules —you can choose to deploy those instant-enabled modules by checking the box next to Deploy as instant app . |
| Installation Options: Features to deploy | If your app includes feature modules , check the box next to each feature you want to include when deploying your app. You see this option only if your app includes feature modules. Note: If you want to test downloading and installing feature modules on demand, you must do so after you publish your app bundle and then use the Play Console internal test track. To learn more, read Upload your app bundle to the Play Console . |
| Installation Options: Install Flags | Type any adb pm install options you want to use. Format the options the same way that you would on the command line, but without a path. در اینجا چند نمونه آورده شده است: و Default: no options. |
| Launch Options: Launch | Select an option:
|
| Launch Options: Launch Flags | Type any adb am start options you want to use. Format the options the same way that you would on the command line, but without an intent. به عنوان مثال: This option doesn't appear if you chose a Launch value of Nothing . Default: no options. |
| Deployment Target Options: Target | Select an option:
|
Deployment Target Options: Use same device for future launches | By default this option is deselected so that every time you run an app, the Select Deployment dialog appears for you to select a device. When you select this option and then run an app, the Select Deployment dialog appears for you to select a device. Then, every time you run the app, it launches on the device you selected without displaying the Select Deployment dialog. To run the app on a different device, either deselect Use same device for future launches , or stop the app with Run > Stop app or Stop , and then start it again. The Select Deployment dialog will display so you can select a device. |
| قبل از راه اندازی | See Defining Before Launch Operations . |
Miscellaneous tab
In the Miscellaneous tab, you can specify logcat, installation, launch, and deployment options. The General tab also contains installation options.
| میدان | Description |
|---|---|
| Logcat: Show logcat automatically | When this option is selected, the Logcat window opens every time you successfully deploy and launch an app using this configuration. Default: selected. |
| Logcat: Clear log before launch | Select this option if you want Android Studio to remove data from previous sessions from the log file before starting the app. Default: deselected. |
| Installation Options: Skip installation if APK has not changed. | When selected, Android Studio doesn't redeploy your APK if it detects that it's unchanged. If you want Android Studio to force an install of the APK, even if it hasn't changed, then deselect this option. Default: selected |
| Installation Options: Force stop running application before launching activity | If selected, when Android Studio detects that it doesn't have to reinstall an APK because it hasn't changed, it will force-stop the app so that the app starts from the default launcher activity. If this option is deselected, Android Studio doesn't force-stop the app. This option works with the previous option that controls whether an APK is installed or not. For both Installation Options fields, leave them at the default unless you explicitly want to force an install every time. In some cases you might want to deselect this option. For example, if you're writing an input method engine (IME), force-stopping the app deselects it as the current keyboard, which you might not want. Default: selected |
| قبل از راه اندازی | See Defining Before Launch Operations . |
Debugger tab
Specify debug options in the Debugger tab.
For C and C++ code, Android Studio uses the LLDB debugger. In addition to the normal Android Studio UI, the debugger window has an LLDB tab that lets you enter LLDB commands during debugging. You can enter the same commands that Android Studio uses to display information in the debugger UI, and you can perform additional operations.
For C and C++ projects, you can add symbol directories, as well as LLDB startup and post attach commands, in the Debugger tab. To do so, you use buttons similar to the following:
- اضافه کنید - Add a directory or command.
- حذف کنید- Select a directory or command, and then click this button to remove the item.
- بالا - Select a directory or command, and then click this button to move the item up in the list.
- پایین - Select a directory or command, and then click this button to move the item down in the list.
See Debug Your App for more information about debugging in Android Studio.
| میدان | Description |
|---|---|
| Debug type | یکی از گزینه های زیر را انتخاب کنید:
The Detect Automatically option is recommended because it chooses the right debug type for your project. |
| Symbol Directories | If you want to add symbol files to provide the debugger with C or C++ information generated outside of Android Studio, you can add one or more directories here. Android Studio preferentially uses any files within these directories over files generated by the Android Plugin for Gradle . The debugger searches the directories from top to bottom, in order, until it finds what it needs. It searches recursively through the files in the directory. To optimize the list and save time, put the directories used most often toward the top of the list. If you specify a directory high in the tree, it can take longer to search all of the subdirectories. If you add a very specific directory, it takes less time to search. You need to find the right balance between speed and finding the files you need for debugging. For example, if you have a directory that contains subdirectories for different Android Binary Interfaces (ABIs), you can choose to add a directory for a specific ABI or for all ABIs. Although it can take longer to search through the upper-level directory, it's also more foolproof if you decide to debug on a different device. Note that you don't have to add directories containing Gradle symbol files because the debugger uses them automatically. |
| LLDB Startup Commands | Add LLDB commands that you want to execute before the debugger attaches to the process. For example, you can define settings for the environment, as shown in the following command: LLDB executes the commands in order from top to bottom. |
| LLDB Post Attach Commands | Add LLDB commands that you want to execute right after the debugger attaches to the process. به عنوان مثال: LLDB executes the commands in order from top to bottom. |
| Host working directory | Specify the LLDB working directory. |
| Logging: Target channels | Specify LLDB log options. Android Studio sets the default options based on the team's experience — so it's not too slow but contains needed information for troubleshooting issues. The log is often requested for Android Studio bug reports. This default is You can change the default to gather more information. For example, the following log options gather information about a specific lldb process platform :gdb-remote packets For a complete list of log commands, enter the Android Studio places device logs in the following location, where Or, if multiple users access a device, it places the logs in the following location, where For information about using LLDB for remote debugging, see Remote Debugging . |
| قبل از راه اندازی | See Defining Before Launch Operations . |
Profiling tab
The Enable advanced profiling option must be checked to enable certain features in the Android Profiler when your device is running Android 7.1 or lower.
Android Tests
The test template that you should use depends on your source set . The Android Instrumented Tests template is for an instrumented test . The Android JUnit template is for a local unit test.
Note: If you're using Firebase Test Lab to test on a variety of devices, you can use the Android JUnit template to define your instrumented tests. For more information, see Run Your Tests with Firebase Test Lab .
The following tab descriptions cover the tabs and fields for the Android Instrumented test template. For information about the tabs and fields for the Android JUnit test template, see the IntelliJ Run/Debug Configuration: JUnit page.
General tab
In General tab, you can specify test location, instrumentation runner, adb shell, and deployment options.
| میدان | Description |
|---|---|
| ماژول | Select a module to apply this configuration to. |
| تست کنید | In this area, specify the location of tests that you want to run:
|
| Specific instrumentation runner (optional) | Type the location of the instrumentation runner ; click More to use a dialog. The build.gradle file specifies the location of the instrumentation runner; this value overrides it. The default is typically the AndroidJUnitRunner class from AndroidX Test . |
| Extra options | Type any adb Default: no options |
| Deployment Target Options: Target | Select an option:
|
| Deployment Target Options: Use same device for future launches | If you want to automatically use the device you chose through the Select Deployment Target dialog in the future, select this option. If the device isn't available, you'll receive a dialog. Default: deselected |
| قبل از راه اندازی | See Defining Before Launch Operations . |
Miscellaneous tab
The Miscellaneous tab contains logcat and installation options.
| میدان | Description |
|---|---|
| Logcat: Clear log before launch | Select this option if you want Android Studio to remove data from previous sessions from the log file before starting the app. Default: deselected. |
| Installation Options: Skip installation if APK has not changed | When selected, Android Studio doesn't redeploy your APK if it detects that it's unchanged. If you want Android Studio to force an install of the APK, even if it hasn't changed, then deselect this option. Default: selected |
| Installation Options: Force stop running application before launching activity | If selected, when Android Studio detects that it doesn't have to reinstall an APK because it hasn't changed, it will force-stop the app so that the app starts from the default launcher activity. If this option is deselected, Android Studio doesn't force-stop the app. This option works in conjunction with the previous option that controls whether an APK is installed or not. For both Installation Options fields, leave them at the default unless you explicitly want to force an install every time. In some cases you might want to deselect this option. For example, if you're writing an input method engine (IME), force-stopping the app deselects it as the current keyboard, which you might not want. Default: selected |
| قبل از راه اندازی | See Defining Before Launch Operations . |
Debugger tab
Specify debug options in the Debugger tab.
For C and C++ code, Android Studio uses the LLDB debugger. In addition to the normal Android Studio UI, the debugger window has an LLDB tab that lets you enter LLDB commands during debugging. You can enter the same commands that Android Studio uses to display information in the debugger UI, and you can perform additional operations.
For C and C++ projects, you can add symbol directories, as well as LLDB startup and post attach commands, in the Debugger tab. To do so, you use buttons similar to the following:
- اضافه کنید - Add a directory or command.
- حذف کنید- Select a directory or command, and then click this button to remove the item.
- بالا - Select a directory or command, and then click this button to move the item up in the list.
- پایین - Select a directory or command, and then click this button to move the item down in the list.
See Debug Your App for more information about debugging in Android Studio.
| میدان | Description |
|---|---|
| Debug type | یکی از گزینه های زیر را انتخاب کنید:
The Detect Automatically option is recommended because it chooses the right debug type for your project. |
| Symbol Directories | If you want to add symbol files to provide the debugger with C or C++ information generated outside of Android Studio, you can add one or more directories here. Android Studio preferentially uses any files within these directories over files generated by the Android Plugin for Gradle . The debugger searches the directories from top to bottom, in order, until it finds what it needs. It searches recursively through the files in the directory. To optimize the list and save time, put the directories used most often toward the top of the list. If you specify a directory high in the tree, it can take longer to search all of the subdirectories. If you add a very specific directory, it takes less time to search. You need to find the right balance between speed and finding the files you need for debugging. For example, if you have a directory that contains subdirectories for different Android Binary Interfaces (ABIs), you can choose to add a directory for a specific ABI or for all ABIs. Although it can take longer to search through the upper-level directory, it's also more foolproof if you decide to debug on a different device. Note that you don't have to add directories containing Gradle symbol files because the debugger uses them automatically. |
| LLDB Startup Commands | Add LLDB commands that you want to execute before the debugger attaches to the process. For example, you can define settings for the environment, as shown in the following command: LLDB executes the commands in order from top to bottom. |
| LLDB Post Attach Commands | Add LLDB commands that you want to execute right after the debugger attaches to the process. به عنوان مثال: LLDB executes the commands in order from top to bottom. |
| Host working directory | Specify the LLDB working directory. |
| Logging: Target channels | Specify LLDB log options. Android Studio sets the default options based on the team's experience — so it's not too slow but contains needed information for troubleshooting issues. The log is often requested for Android Studio bug reports. This default is You can change the default to gather more information. For example, the following log options gather information about a specific lldb process platform :gdb-remote packets For a complete list of log commands, enter the Android Studio places device logs in the following location, where Or, if multiple users access a device, it places the logs in the following location, where For information about using LLDB for remote debugging, see Remote Debugging . |
| قبل از راه اندازی | See Defining Before Launch Operations . |
App Engine DevAppServer
This run/debug configuration applies to the Google Cloud Platform. For more information, see Running, Testing, and Deploying the Backend . When you follow these steps and sync your project to the build.gradle file, Android Studio creates an App Engine DevAppServer configuration for you.
Note that the IntellJ IDEA App Engine Server template is a different template that's not available in Android Studio.
| میدان | Description |
|---|---|
| Single instance only | If you want to make sure that only one instance of the run/debug configuration is currently executed, select this option. It doesn't allow multiple runs of the same configuration at the same time. Default: selected |
| ماژول | Select a module to apply this configuration to. |
| Synchronize with build.gradle configuration | If you add an App Engine module and sync to the build.gradle file, the App Engine DevAppServer configuration fields are filled in for you (recommended). Selecting File > Sync Project with Gradle Files also syncs the project. Default: selected |
| App Engine SDK | Type a path to a Google App Engine SDK for Java on the local machine. Click ... to select it from a dialog. |
| War Path | Type a path to the Web Application Archive (WAR) directory of the app you're deploying on the local development server. Click ... to select it from a dialog. |
| VM Args | Specify the command-line options you want to pass to the VM for launching the DevAppServer. When specifying the options:
For more information about VM options, see the documentation for your J2SE version, such as Default: no options |
| آدرس سرور | Type the host address to use for the server. You might need to provide the address to be able to access the development server from another computer on your network. An address of 0.0.0.0 allows both localhost access and hostname access. Default: localhost |
| Server Port | Type the port number to use for the server. Default: 8080 |
| Disable Check for App Engine SDK Updates | If given, the development server will not contact App Engine to check for the availability of a new release of the SDK. By default, the server checks for a new version on startup, and prints a message if a new version is available. |
| قبل از راه اندازی | See Defining Before Launch Operations . |
Wear OS run/debug configurations
The Wear OS Complication, Tile, and Watch Face templates let you run or debug Wear OS apps on virtual or hardware devices. Most of the template configuration options are the same as the Android App options . Here are the options that are more specific to the Wear OS run/debug configurations:
- For all Wear run/debug configurations, you have to select a specific complication data source, tile, or watch face (depending on the template) to apply the configuration to. Generally each of these entities corresponds to a class in your code.
- For the Wear OS Complication run/debug configuration, you must choose the Slot where you want to put the complication data provided by the complication data source. You can choose to put it at the top, right, bottom, left, or background of the watch face.
- For the Wear OS Complication run/debug configuration, you must also select the Type of the complication data provided by the complication data source. The types you can choose from are limited to those that are provided by the chosen complication data source and supported by the chosen slot. For a list of complication data types, see Types and fields .
Alternatively, you can also run these surfaces from the gutter icon that is located next to the declaration of the surface, as shown in the following image.