קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
כדי ליהנות מחוויית הפיתוח הטובה ביותר באמצעות Compose, מומלץ להוריד ולהתקין את Android Studio. היא כוללת הרבה תכונות של עורך חכם, כמו תבניות חדשות לפרויקטים ואפשרות להציג בתצוגה מקדימה באופן מיידי את ממשק המשתמש והאנימציות של Compose.
כדי ליצור פרויקט חדש של אפליקציית Compose, להגדיר את Compose לפרויקט קיים של אפליקציה או לייבא אפליקציה לדוגמה שנכתבה ב-Compose, צריך לפעול לפי ההוראות הבאות.
יצירת אפליקציה חדשה עם תמיכה ב-Compose
אם רוצים להתחיל פרויקט חדש שכולל תמיכה ב-Compose כברירת מחדל, אפשר להשתמש בתבניות הפרויקט השונות שזמינות ב-Android Studio. כדי ליצור פרויקט חדש שבו Compose מוגדר בצורה נכונה, פועלים לפי השלבים הבאים:
אם אתם נמצאים בחלון Welcome to Android Studio (ברוכים הבאים ל-Android Studio), לוחצים על Start a new Android Studio project (התחלת פרויקט חדש ב-Android Studio). אם כבר פתוח פרויקט ב-Android Studio, בוחרים באפשרות File > New > New Project (קובץ > חדש > פרויקט חדש) מסרגל התפריטים.
בחלון Select a Project Template, בוחרים באפשרות Empty
Activity ולוחצים על Next.
בחלון Configure your project (הגדרת הפרויקט), מבצעים את הפעולות הבאות:
מגדירים את השם, שם החבילה ומיקום השמירה כמו בדרך כלל. שימו לב שבתפריט הנפתח שפה, האפשרות Kotlin היא האפשרות היחידה שזמינה כי Jetpack Compose פועל רק עם מחלקות שנכתבו ב-Kotlin.
בתפריט הנפתח רמת ה-API המינימלית, בוחרים ברמת API 21 ומעלה.
לוחצים על סיום.
עכשיו אפשר להתחיל לפתח אפליקציה באמצעות Jetpack Compose. כדי לעזור לכם להתחיל ולהבין מה אפשר לעשות עם ערכת הכלים, כדאי לנסות את המדריך ל-Jetpack Compose.
לבסוף, מוסיפים את ה-BOM של Compose ואת קבוצת המשנה של יחסי התלות של ספריית Compose שדרושים לכם ליחסי התלות מהבלוק הבא:
גרוב
dependencies{defcomposeBom=platform('androidx.compose:compose-bom:2025.08.00')implementationcomposeBomandroidTestImplementationcomposeBom// Choose one of the following:// Material Design 3implementation'androidx.compose.material3:material3'// or Material Design 2implementation'androidx.compose.material:material'// or skip Material Design and build directly on top of foundational componentsimplementation'androidx.compose.foundation:foundation'// or only import the main APIs for the underlying toolkit systems,// such as input and measurement/layoutimplementation'androidx.compose.ui:ui'// Android Studio Preview supportimplementation'androidx.compose.ui:ui-tooling-preview'debugImplementation'androidx.compose.ui:ui-tooling'// UI TestsandroidTestImplementation'androidx.compose.ui:ui-test-junit4'debugImplementation'androidx.compose.ui:ui-test-manifest'// Optional - Included automatically by material, only add when you need// the icons but not the material library (e.g. when using Material3 or a// custom design system based on Foundation)implementation'androidx.compose.material:material-icons-core'// Optional - Add full set of material iconsimplementation'androidx.compose.material:material-icons-extended'// Optional - Add window size utilsimplementation'androidx.compose.material3.adaptive:adaptive'// Optional - Integration with activitiesimplementation'androidx.activity:activity-compose:1.10.1'// Optional - Integration with ViewModelsimplementation'androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5'// Optional - Integration with LiveDataimplementation'androidx.compose.runtime:runtime-livedata'// Optional - Integration with RxJavaimplementation'androidx.compose.runtime:runtime-rxjava2'}
Kotlin
dependencies{valcomposeBom=platform("androidx.compose:compose-bom:2025.08.00")implementation(composeBom)androidTestImplementation(composeBom)// Choose one of the following:// Material Design 3implementation("androidx.compose.material3:material3")// or Material Design 2implementation("androidx.compose.material:material")// or skip Material Design and build directly on top of foundational componentsimplementation("androidx.compose.foundation:foundation")// or only import the main APIs for the underlying toolkit systems,// such as input and measurement/layoutimplementation("androidx.compose.ui:ui")// Android Studio Preview supportimplementation("androidx.compose.ui:ui-tooling-preview")debugImplementation("androidx.compose.ui:ui-tooling")// UI TestsandroidTestImplementation("androidx.compose.ui:ui-test-junit4")debugImplementation("androidx.compose.ui:ui-test-manifest")// Optional - Included automatically by material, only add when you need// the icons but not the material library (e.g. when using Material3 or a// custom design system based on Foundation)implementation("androidx.compose.material:material-icons-core")// Optional - Add full set of material iconsimplementation("androidx.compose.material:material-icons-extended")// Optional - Add window size utilsimplementation("androidx.compose.material3.adaptive:adaptive")// Optional - Integration with activitiesimplementation("androidx.activity:activity-compose:1.10.1")// Optional - Integration with ViewModelsimplementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5")// Optional - Integration with LiveDataimplementation("androidx.compose.runtime:runtime-livedata")// Optional - Integration with RxJavaimplementation("androidx.compose.runtime:runtime-rxjava2")}
ניסיון של אפליקציות לדוגמה ב-Jetpack פיתוח נייטיב
הדרך הכי מהירה להתנסות ביכולות של Jetpack Compose היא לנסות אפליקציות לדוגמה של Jetpack Compose שמתארחות ב-GitHub. כדי לייבא פרויקט של אפליקציה לדוגמה מ-Android Studio, פועלים לפי השלבים הבאים:
אם אתם נמצאים בחלון Welcome to Android Studio (ברוכים הבאים ל-Android Studio), בוחרים באפשרות Import an
Android code sample (ייבוא של דוגמת קוד ל-Android). אם כבר פתוח פרויקט ב-Android Studio, בוחרים באפשרות File > New > Import Sample (קובץ > חדש > ייבוא דוגמה) מסרגל התפריטים.
בסרגל החיפוש שקרוב לחלק העליון של האשף Browse Samples, מקלידים compose.
בוחרים אחת מהאפליקציות לדוגמה של Jetpack Compose מתוצאות החיפוש ולוחצים על הבא.
אפשר לשנות את שם האפליקציה ומיקום הפרויקט או להשאיר את ערכי ברירת המחדל.
לוחצים על סיום.
Android Studio מוריד את האפליקציה לדוגמה לנתיב שציינתם ופותח את הפרויקט. אחר כך אפשר לבדוק את MainActivity.kt בכל אחת מהדוגמאות כדי לראות ממשקי API של Jetpack Compose, כמו אנימציית מעבר הדרגתי, רכיבים בהתאמה אישית, שימוש בטיפוגרפיה והצגת צבעים בהירים וכהים בתצוגה המקדימה ב-IDE.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-21 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-21 (שעון UTC)."],[],[],null,["# Quick start\n\nFor the best experience developing with Compose, download and install [Android\nStudio](/studio). It includes many [smart editor features](/develop/ui/compose/tooling), such as new project\ntemplates and the ability to immediately preview your Compose UI and animations.\n\n[Get Android Studio](/studio)\n\nFollow these instructions to create a new Compose app project, set up\nCompose for an existing app project, or import a sample app written in Compose.\n\nCreate a new app with support for Compose\n-----------------------------------------\n\nIf you want to start a new project that includes support for Compose by default,\nAndroid Studio includes various project templates to help you get started. To\ncreate a new project that has Compose setup correctly, proceed as follows:\n\n1. If you're in the **Welcome to Android Studio** window, click **Start a new\n Android Studio project** . If you already have an Android Studio project open , select **File \\\u003e New \\\u003e New Project** from the menu bar.\n2. In the **Select a Project Template** window, select **Empty\n Activity** and click **Next**.\n3. In the **Configure your project** window, do the following:\n 1. Set the **Name, Package name** , and **Save location** as you normally would. Note that, in the **Language** dropdown menu, **Kotlin** is the only available option because Jetpack Compose works only with classes written in Kotlin.\n 2. In the **Minimum API level dropdown** menu, select API level 21 or higher.\n4. Click **Finish**.\n\nNow you're ready to start developing an app using Jetpack Compose. To help you\nget started and learn about what you can do with the toolkit, try the [Jetpack\nCompose tutorial](/develop/ui/compose/tutorial).\n\nSet up Compose for an existing app\n----------------------------------\n\nFirst, configure the Compose compiler using the [Compose\nCompiler Gradle plugin](/develop/ui/compose/compiler).\n\nThen, add the following definition to your app's `build.gradle` file: \n\n### Groovy\n\n android {\n buildFeatures {\n compose true\n }\n }\n\n### Kotlin\n\n android {\n buildFeatures {\n compose = true\n }\n }\n\nSetting the `compose` flag to `true` inside the Android [`BuildFeatures`](/reference/tools/gradle-api/7.0/com/android/build/api/dsl/BuildFeatures)\nblock enables [Compose functionality](/develop/ui/compose/tooling) in Android Studio.\n\nFinally, add the Compose BOM and the subset of Compose library dependencies\nyou need to your dependencies from the following block: \n\n### Groovy\n\n dependencies {\n\n def composeBom = platform('androidx.compose:compose-bom:2025.08.00')\n implementation composeBom\n androidTestImplementation composeBom\n\n // Choose one of the following:\n // Material Design 3\n implementation 'androidx.compose.material3:material3'\n // or Material Design 2\n implementation 'androidx.compose.material:material'\n // or skip Material Design and build directly on top of foundational components\n implementation 'androidx.compose.foundation:foundation'\n // or only import the main APIs for the underlying toolkit systems,\n // such as input and measurement/layout\n implementation 'androidx.compose.ui:ui'\n\n // Android Studio Preview support\n implementation 'androidx.compose.ui:ui-tooling-preview'\n debugImplementation 'androidx.compose.ui:ui-tooling'\n\n // UI Tests\n androidTestImplementation 'androidx.compose.ui:ui-test-junit4'\n debugImplementation 'androidx.compose.ui:ui-test-manifest'\n\n // Optional - Included automatically by material, only add when you need\n // the icons but not the material library (e.g. when using Material3 or a\n // custom design system based on Foundation)\n implementation 'androidx.compose.material:material-icons-core'\n // Optional - Add full set of material icons\n implementation 'androidx.compose.material:material-icons-extended'\n // Optional - Add window size utils\n implementation 'androidx.compose.material3.adaptive:adaptive'\n\n // Optional - Integration with activities\n implementation 'androidx.activity:activity-compose:1.10.1'\n // Optional - Integration with ViewModels\n implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5'\n // Optional - Integration with LiveData\n implementation 'androidx.compose.runtime:runtime-livedata'\n // Optional - Integration with RxJava\n implementation 'androidx.compose.runtime:runtime-rxjava2'\n\n }\n\n### Kotlin\n\n dependencies {\n\n val composeBom = platform(\"androidx.compose:compose-bom:2025.08.00\")\n implementation(composeBom)\n androidTestImplementation(composeBom)\n\n // Choose one of the following:\n // Material Design 3\n implementation(\"androidx.compose.material3:material3\")\n // or Material Design 2\n implementation(\"androidx.compose.material:material\")\n // or skip Material Design and build directly on top of foundational components\n implementation(\"androidx.compose.foundation:foundation\")\n // or only import the main APIs for the underlying toolkit systems,\n // such as input and measurement/layout\n implementation(\"androidx.compose.ui:ui\")\n\n // Android Studio Preview support\n implementation(\"androidx.compose.ui:ui-tooling-preview\")\n debugImplementation(\"androidx.compose.ui:ui-tooling\")\n\n // UI Tests\n androidTestImplementation(\"androidx.compose.ui:ui-test-junit4\")\n debugImplementation(\"androidx.compose.ui:ui-test-manifest\")\n\n // Optional - Included automatically by material, only add when you need\n // the icons but not the material library (e.g. when using Material3 or a\n // custom design system based on Foundation)\n implementation(\"androidx.compose.material:material-icons-core\")\n // Optional - Add full set of material icons\n implementation(\"androidx.compose.material:material-icons-extended\")\n // Optional - Add window size utils\n implementation(\"androidx.compose.material3.adaptive:adaptive\")\n\n // Optional - Integration with activities\n implementation(\"androidx.activity:activity-compose:1.10.1\")\n // Optional - Integration with ViewModels\n implementation(\"androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5\")\n // Optional - Integration with LiveData\n implementation(\"androidx.compose.runtime:runtime-livedata\")\n // Optional - Integration with RxJava\n implementation(\"androidx.compose.runtime:runtime-rxjava2\")\n\n }\n\n| **Note:** Jetpack Compose is shipped using a Bill of Materials (BOM), to keep the versions of all library groups in sync. Read more about it in the [Bill of\n| Materials page](/develop/ui/compose/bom/bom).\n\nTry Jetpack Compose sample apps\n-------------------------------\n\nThe fastest way to experiment with the capabilities of Jetpack Compose is by\ntrying [Jetpack Compose sample apps](https://github.com/android/compose-samples) hosted on GitHub. To import\na sample app project from Android Studio, proceed as follows:\n\n1. If you're in the **Welcome to Android Studio** window, select **Import an\n Android code sample** . If you already have an Android Studio project open, select **File \\\u003e New \\\u003e Import Sample** from the menu bar.\n2. In the search bar near the top of the **Browse Samples** wizard, type \"compose\".\n3. Select one of the Jetpack Compose sample apps from the search results and click **Next**.\n4. Either change the **Application name** and **Project location** or keep the default values.\n5. Click **Finish**.\n\nAndroid Studio downloads the sample app to the path you specified and opens the\nproject. You can then inspect `MainActivity.kt` in each of the examples to see\nJetpack Compose APIs such as crossfade animation, custom components, using\ntypography, and displaying light and dark colors in the in-IDE preview.\n\nTo use Jetpack Compose for Wear OS, see [Set up Jetpack Compose on Wear OS](/training/wearables/compose-setup).\n\nRecommended for you\n-------------------\n\n- Note: link text is displayed when JavaScript is off\n- [Navigating with Compose](/develop/ui/compose/navigation)\n- [Testing your Compose layout](/develop/ui/compose/testing)\n- [React to focus](/develop/ui/compose/touch-input/focus/react-to-focus)"]]
