شروع سریع

برای داشتن بهترین تجربه در توسعه با Compose، Android Studio را دانلود و نصب کنید. Android Studio شامل بسیاری از قابلیت‌های هوشمند ویرایشگر است؛ مانند قالب‌های جدید پروژه و امکان پیش‌نمایش فوری رابط کاربری و انیمیشن‌های Compose.

برای ایجاد یک پروژه جدید اپلیکیشن با Compose، راه‌اندازی Compose برای یک پروژه اپلیکیشن موجود، یا وارد کردن یک نمونه اپلیکیشن نوشته‌شده با Compose، دستورالعمل‌های زیر را دنبال کنید.

ایجاد یک اپلیکیشن جدید با پشتیبانی از Compose

اگر می‌خواهید یک پروژه جدید را شروع کنید که به‌صورت پیش‌فرض از Compose پشتیبانی کند، Android Studio قالب‌های مختلفی برای شروع کار در اختیار شما قرار می‌دهد. برای ایجاد یک پروژه جدید که Compose در آن به‌درستی تنظیم شده باشد، مراحل زیر را انجام دهید:

اگر در پنجره Welcome to Android Studio هستید، روی Start a new Android Studio project کلیک کنید. اگر از قبل یک پروژه Android Studio باز دارید، از نوار منو گزینه File > New > New Project را انتخاب کنید.

در پنجره Select a Project Template، گزینه Empty Activity را انتخاب کرده و روی Next کلیک کنید.

در پنجره Configure your project، کارهای زیر را انجام دهید:

نام پروژه، نام پکیج و محل ذخیره‌سازی را مانند حالت معمول تنظیم کنید. توجه داشته باشید که در منوی کشویی Language، تنها گزینه موجود Kotlin است؛ زیرا Jetpack Compose فقط با کلاس‌هایی کار می‌کند که با Kotlin نوشته شده‌اند.

در منوی کشویی Minimum API level، سطح API شماره ۲۱ یا بالاتر را انتخاب کنید.

روی Finish کلیک کنید.

اکنون آماده هستید تا توسعه اپلیکیشن با استفاده از Jetpack Compose را شروع کنید. برای شروع بهتر و یادگیری قابلیت‌های این ابزار، آموزش Jetpack Compose را امتحان کنید.

تنظیم وابستگی‌های Compose و کامپایلر

بخش Setup Compose dependencies and Compiler را ببینید.

امتحان کردن نمونه اپلیکیشن‌های Jetpack Compose

سریع‌ترین راه برای آزمایش قابلیت‌های Jetpack Compose، امتحان کردن نمونه اپلیکیشن‌های Jetpack Compose است که در GitHub قرار دارند. برای وارد کردن یک پروژه نمونه از داخل Android Studio، مراحل زیر را انجام دهید:

اگر در پنجره Welcome to Android Studio هستید، گزینه Import an Android code sample را انتخاب کنید. اگر از قبل یک پروژه Android Studio باز دارید، از نوار منو گزینه File > New > Import Sample را انتخاب کنید.

در نوار جست‌وجوی بالای پنجره Browse Samples، عبارت compose را تایپ کنید.

یکی از نمونه اپلیکیشن‌های Jetpack Compose را از نتایج جست‌وجو انتخاب کرده و روی Next کلیک کنید.

می‌توانید نام اپلیکیشن و محل پروژه را تغییر دهید یا مقادیر پیش‌فرض را نگه دارید.

روی Finish کلیک کنید.

Android Studio نمونه اپلیکیشن را در مسیری که مشخص کرده‌اید دانلود می‌کند و پروژه را باز می‌کند. سپس می‌توانید فایل MainActivity.kt را در هر یک از نمونه‌ها بررسی کنید تا APIهای Jetpack Compose را ببینید؛ مانند انیمیشن crossfade، کامپوننت‌های سفارشی، استفاده از تایپوگرافی، و نمایش رنگ‌های روشن و تیره در پیش‌نمایش داخل IDE.