אם אתם כותבים קוד 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.