Jetpack Compose API'leri için stil kuralları
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Uygulamanız için Compose kodu yazıyorsanız veya Compose kitaplıkları ve API'leri oluşturuyorsanız kodunuzun ölçeklenebilir, daha iyi performanslı ve ekosistemin geri kalanıyla tutarlı olması için en iyi uygulamaları izleyin.
Aşağıdaki belgelerde, Compose kullanan kod yazan herkes için yönergeler verilmektedir:
- Jetpack Compose için API Kuralları: Jetpack Compose derleyici eklentisini ve çalışma zamanını kullanan tüm sistemler için kalıpları, en iyi uygulamaları ve kuralcı stil kurallarını özetler. Aşağıdaki konuları içerir:
- Kotlin Kodlama Kuralları'na dayalı olarak Compose için Kotlin stil yönergeleri
- Compose çalışma zamanı özelliklerini temel alan
@Composable
işlevleri ve API'leri için rehberlik
- Compose kullanıcı arayüzü araç setini kullanan ve genişleten API'lerle ilgili yönergeler
- Compose API tasarlarken kullanım alanlarını ele alma kalıpları
- Jetpack Compose'daki
@Composable
bileşenleri için API yönergeleri:
Aşağıdaki konular da dahil olmak üzere @Composable
kullanıcı arayüzü bileşenleri oluşturma ve kullanmayla ilgili bir dizi yönerge ve öneri sunar:
- Bileşen oluşturma ve katmanlama
- Yeni bir bileşeni adlandırma
- Bileşen bağımlılıklarını ifade etme
@Composable
bileşenlerindeki parametreler
- Bileşenle ilgili sınıflar ve işlevler oluşturmak için doğru kalıpları kullanma
@Composable
bileşenlerini belgeleme
- Bileşenlerin erişilebilirliğini iyileştirme
- Geriye dönük uyumluluğu korurken bileşen API'lerini güncelleme
Kitle
Bu yönergeler aşağıdaki üç kitle için yazılmıştır:
- Jetpack Compose'a dayalı uygulamalar geliştiren geliştiriciler. Uygulamanızın bir bölümünde Jetpack Compose kullanıyorsanız bu gruptasınızdır.
- Jetpack Compose çerçeve geliştirme üzerinde çalışan geliştiriciler.
androidx.compose
kitaplıklarına katkıda bulunuyorsanız bu gruptasınızdır.
- Jetpack Compose'a dayalı kitaplıklar oluşturan geliştiriciler. Compose API'leri veya Compose kullanıcı arayüzü öğeleri kitaplıkları oluşturuyorsanız bu gruptasınızdır. Bu Compose bileşenleri kitaplıkları herkese açık olabilir veya şirketiniz ya da ekibiniz için yerel olabilir.
Bulunduğunuz gruba bağlı olarak, her stil kılavuzu için farklı katılık düzeyleri vardır. Örneğin, Jetpack Compose çerçeve geliştirme genellikle bu yönergelere en sıkı şekilde uyar.
Her geliştirici kitlesiyle ilgili şartlar hakkında daha fazla bilgi için RFC2119'a bakın.
Çerçeveye ve yönergelere katkıda bulunma
androidx
kod tabanındaki belirli kitaplıklara ve stil kurallarına (Compose API kuralları ve @Composable
bileşen kuralları) katkıda bulunabilirsiniz.
Katkıda bulunmak için androidx
katkı kılavuzundaki talimatları uygulayın.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-27 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-08-27 UTC."],[],[],null,["If you're writing Compose code for your app or building Compose libraries and\nAPIs, follow best practices to make your code scalable, more performant, and\nconsistent with the rest of the ecosystem.\n\nThe following documents provide guidelines for anyone writing code that uses\nCompose:\n\n- [API Guidelines for Jetpack Compose](https://android.googlesource.com/platform/frameworks/support/+/androidx-main/compose/docs/compose-api-guidelines.md): Outlines patterns, best practices, and prescriptive style guidelines for any system using the Jetpack Compose compiler plugin and runtime. It includes the following topics:\n - Kotlin style guidelines for Compose, based on the [Kotlin Coding\n Conventions](https://kotlinlang.org/docs/coding-conventions.html)\n - Guidance for `@Composable` functions and APIs that build on the Compose runtime capabilities\n - Guidelines for APIs that use and extend the Compose UI toolkit\n - Patterns for addressing use cases when designing a Compose API\n- [API Guidelines for `@Composable` components in Jetpack Compose](https://android.googlesource.com/platform/frameworks/support/+/androidx-main/compose/docs/compose-component-api-guidelines.md): Provides a set of guidelines and recommendations for creating and using `@Composable` UI components, including the following topics:\n - Creating and layering components\n - Naming a new component\n - Expressing component dependencies\n - Parameters in `@Composable` components\n - Following correct patterns for creating component-related classes and functions\n - Documenting `@Composable` components\n - Improving accessibility for components\n - Updating component APIs while retaining backwards compatibility\n\nAudience\n\nThese guidelines are written for the following three audiences:\n\n- **Developers building apps based on Jetpack Compose**. You are in this group if you use Jetpack Compose in some part of your app.\n- **Developers working on Jetpack Compose framework development** . You are in this group if you make contributions to the [`androidx.compose` libraries](/jetpack/androidx/releases/compose).\n- **Developers creating libraries based on Jetpack Compose**. You are in this group if you create Compose APIs or libraries of Compose UI elements. These libraries of Compose components may be publicly available or local to your company or team.\n\nDepending on the group you're in, you have different strictness levels for each\nstyle guideline. For example, Jetpack Compose framework development generally\nadheres most strictly to these guidelines.\n\nFor more information about the requirements for each developer audience, see\n[RFC2119](https://www.ietf.org/rfc/rfc2119.txt).\n\nContribute to framework and guidelines\n\nWe welcome contributions to select libraries in the `androidx` codebase and the\nstyle guidelines ([Compose API guidelines](https://android.googlesource.com/platform/frameworks/support/+/androidx-main/compose/docs/compose-api-guidelines.md) and\n[`@Composable` components guidelines](https://android.googlesource.com/platform/frameworks/support/+/androidx-main/compose/docs/compose-component-api-guidelines.md)) themselves.\n\nTo contribute, follow the instructions in the `androidx` [contribution\nguide](https://android.googlesource.com/platform/frameworks/support/+/androidx-main/CONTRIBUTING.md)."]]