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