אם אתם כותבים קוד Compose לאפליקציה או יוצרים ספריות וממשקי API של Compose, כדאי לפעול לפי השיטות המומלצות כדי שהקוד יהיה ניתן להרחבה, יפעל בצורה יעילה יותר ויהיה עקבי עם שאר המערכת האקולוגית.
במסמכים הבאים מפורטות הנחיות לכל מי שכותב קוד שמשתמש ב-Compose:
- הנחיות לשימוש בממשקי API ב-Jetpack Compose: מתוארים דפוסים, שיטות מומלצות והנחיות סגנון מחייבות לכל מערכת שמשתמשת בתוסף של מהדר Jetpack Compose ובזמן ריצה. הנושאים שמופיעים בו:
- הנחיות לסגנון ב-Kotlin ל-Compose, שמבוססות על מוסכמות התכנות ב-Kotlin
- הנחיות לגבי פונקציות ו-API של
@Composableשמבוססים על היכולות של זמן הריצה של Compose - הנחיות לשימוש בממשקי API שמרחיבים את ערכת הכלים לבניית ממשק משתמש ב-Compose
- דפוסים לטיפול בתרחישי שימוש כשמתכננים Compose API
- הנחיות לשימוש ב-API עבור רכיבי
@Composableב-Jetpack פיתוח נייטיב: המאמר מספק קבוצה של הנחיות והמלצות ליצירה ולשימוש ברכיבי ממשק משתמש של@Composable, כולל הנושאים הבאים:- יצירה של רכיבים והוספה שלהם לשכבות
- איך נותנים שם לרכיב חדש
- הגדרת יחסי תלות בין רכיבים
- פרמטרים ברכיבי
@Composable - שימוש בדפוסים נכונים ליצירת מחלקות ופונקציות שקשורות לרכיבים
- תיעוד של רכיבי
@Composable - שיפור הנגישות של רכיבים
- עדכון של ממשקי API של רכיבים תוך שמירה על תאימות לאחור
קהל
ההנחיות האלה מיועדות לשלושה סוגי קהלים:
- מפתחים שיוצרים אפליקציות שמבוססות על Jetpack Compose. אתם נכללים בקבוצה הזו אם אתם משתמשים ב-Jetpack Compose בחלק כלשהו של האפליקציה.
- מפתחים שעובדים על פיתוח מסגרת Jetpack Compose. אתם בקבוצה הזו אם אתם תורמים לספריות
androidx.compose. - מפתחים שיוצרים ספריות שמבוססות על Jetpack Compose. אתם נכללים בקבוצה הזו אם אתם יוצרים ממשקי API של Compose או ספריות של רכיבי ממשק משתמש של Compose. ספריות הרכיבים של Compose יכולות להיות זמינות לציבור או מקומיות לחברה או לצוות שלכם.
בהתאם לקבוצה שבה אתם נמצאים, יש רמות שונות של הקפדה על כל הנחיות הסגנון. לדוגמה, פיתוח של מסגרת Jetpack Compose בדרך כלל מקפיד על ההנחיות האלה בצורה הכי מחמירה.
מידע נוסף על הדרישות לכל קהל מפתחים זמין ב-RFC2119.
תרומה למסגרת ולהנחיות
נשמח לקבל תרומות לספריות נבחרות בבסיס הקוד של androidx ולספריות של הנחיות הסגנון (הנחיות ל-Compose API והנחיות לרכיבי @Composable).
כדי לתרום, פועלים לפי ההוראות במדריך לתורמים של androidx.