راه‌اندازی سریع

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

دریافت «استودیو Android»

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

ایجاد برنامه جدید با پشتیبانی از Compose

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

  1. اگر در پنجره به «استودیو Android» خوش آمدید هستید، روی شروع پروژه جدید «استودیو Android» کلیک کنید. اگر ازقبل پروژه «استودیو Android» را باز کرده‌اید، فایل > جدید > پروژه جدید را از نوار منو انتخاب کنید.
  2. در پنجره انتخاب الگوی پروژه، فعالیت خالی را انتخاب کنید و روی بعدی کلیک کنید.
  3. در پنجره پیکربندی پروژه، کارهای زیر را انجام دهید:
    1. نام، نام بسته، و مکان ذخیره را مثل همیشه تنظیم کنید. توجه داشته باشید که در منوِ کرکره‌ای Language (زبان)، Kotlin تنها گزینه دردسترس است زیرا Jetpack Compose فقط با کلاس‌های نوشته‌شده در Kotlin کار می‌کند.
    2. در منوِ کرکره‌ای حداقل سطح API، سطح API‏ ۲۱ یا بالاتر را انتخاب کنید.
  4. روی پایان کلیک کنید.

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

راه‌اندازی وابستگی‌های Compose و Compiler

راه‌اندازی وابستگی‌های Compose و Compiler را ببینید.

امتحان کردن برنامه‌های نمونه Jetpack Compose

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

  1. اگر در پنجره به «استودیو Android» خوش آمدید هستید، وارد کردن نمونه کد Android را انتخاب کنید. اگر ازقبل پروژه «استودیو Android» را باز کرده‌اید، فایل > جدید > وارد کردن نمونه را از نوار منو انتخاب کنید.
  2. در نوار جستجو نزدیک بالای جادوی مرور نمونه‌ها، «compose» را تایپ کنید.
  3. یکی از برنامه‌های نمونه Jetpack Compose را از نتایج جستجو انتخاب کنید و روی بعدی کلیک کنید.
  4. نام برنامه و مکان پروژه را تغییر دهید یا مقادیر پیش‌فرض را حفظ کنید.
  5. روی پایان کلیک کنید.

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

برای استفاده از Jetpack Compose برای Wear OS، به راه‌اندازی Jetpack Compose در Wear OS مراجعه کنید.