סקירה כללית של העברת פיצ'רים ב-Play

מודל הצגת האפליקציות של Google Play משתמש באפליקציה ל-Android חבילות ליצירה ולהצגה של חבילות APK שעברו אופטימיזציה לכל משתמש הגדרת המכשיר, כך שהמשתמשים יורידו רק את הקוד והמשאבים שהם צריכים להריץ את האפליקציה.

העברת תכונות ב-Play מתבססת על יכולות מתקדמות של חבילות App Bundle, תכונות מסוימות של האפליקציה שיוצגו באופן מותנה או בהורדה לפי דרישה. לשם כך, צריך קודם להפריד את התכונות האלה מאפליקציית הבסיס של הפיצ'רים האלה.

הגדרת build של מודול תכונה

כשיוצרים מודול חדש של תכונות באמצעות Android Studio, סביבת הפיתוח המשולבת (IDE) מחילה את הפלאגין הבא של Gradle על קובץ build.gradle של המודול.

// The following applies the dynamic-feature plugin to your feature module.
// The plugin includes the Gradle tasks and properties required to configure and build
// an app bundle that includes your feature module.

plugins {
  id 'com.android.dynamic-feature'
}

רבים מהנכסים זמינים עבור הפלאגין הסטנדרטי של האפליקציה זמינים גם במודול התכונות. הקטעים הבאים לתאר את המאפיינים שכדאי ולא כדאי לכלול תצורת ה-build של מודול התכונה.

מה לא לכלול בתצורת ה-build של מודול התכונה

מכיוון שכל מודול של תכונה תלוי במודול הבסיסי, הוא גם יורשת הגדרות מסוימות. לכן, יש להשמיט את הדברים הבאים קובץ build.gradle של מודול התכונות:

• הגדרות חתימה: קובצי App Bundle נחתמים באמצעות חתימה שתציינו במודול הבסיסי.
• הנכס minifyEnabled: אפשר הפעלה של כיווץ קוד לכל פרויקט האפליקציה מה-build של המודול הבסיסי בלבד הגדרה אישית. לכן, יש להשמיט את המאפיין הזה של הפיצ'רים האלה. אבל אפשר ציון כללים נוספים של ProGuard לכל מודול של תכונה.
• versionCode ו-versionName: כשיוצרים את ה-App Bundle, Gradle משתמשת בפרטי גרסת האפליקציה שהמודול הבסיסי מספק. יש להשמיט את המאפיינים האלה ממודול התכונות קובץ build.gradle.

צרו קשר למודול הבסיס

כש-Android Studio יוצר את המודול של התכונות, הוא הופך לגלוי למודול הבסיסי על ידי הוספת המאפיין android.dynamicFeatures build.gradle של המודול הבסיסי, כפי שמוצג בהמשך:

// In the base module’s build.gradle file.
android {
    ...
    // Specifies feature modules that have a dependency on
    // this base module.
    dynamicFeatures = [":dynamic_feature", ":dynamic_feature2"]
}

בנוסף, Android Studio כולל את המודול הבסיסי כתלות במודול התכונה, כפי שמוצג בהמשך:

// In the feature module’s build.gradle file:
...
dependencies {
    ...
    // Declares a dependency on the base module, ':app'.
    implementation project(':app')
}

ציון כללים נוספים של ProGuard

למרות שרק תצורת ה-build של המודול הבסיסי יכולה לאפשר כיווץ קוד. אפשר להגדיר כללי ProGuard בהתאמה אישית לכל פרויקט של התכונה באמצעות proguardFiles לנכס, כפי שמוצג בהמשך.

android.buildTypes {
     release {
         // You must use the following property to specify additional ProGuard
         // rules for feature modules.
         proguardFiles 'proguard-rules-dynamic-features.pro'
     }
}

שימו לב שכללי ProGuard הזה ממוזגים עם אלה ממודולים אחרים (כולל המודול הבסיסי) בזמן ה-build. כך שלמרות שכל תכונה לציין קבוצה חדשה של כללים, הכללים האלה יחולו על כל המודולים פרויקט של אפליקציה.

פורסים את האפליקציה

בזמן פיתוח האפליקציה עם תמיכה במודולים של תכונות, אפשר לפרוס את האפליקציה במכשיר מחובר כמו בדרך כלל על ידי בחירה של הפעלה > מפעילים מסרגל התפריטים (או לוחצים על הפעלה בשדה סרגל הכלים).

אם פרויקט האפליקציה כולל מודול של תכונה אחד או יותר, אפשר לבחור אילו תכונות לכלול בעת פריסת האפליקציה, על ידי שינוי את הגדרות ההרצה/ניפוי הבאגים הקיימות, ככה:

1. בוחרים באפשרות הפעלה > עורכים את ההגדרות האישיות בסרגל התפריטים.
2. בחלונית השמאלית של תיבת הדו-שיח Run/Debug Configuration, בוחרים באפשרות את ההגדרה הרצויה של אפליקציית Android.
3. בקטע תכונות דינמיות לפריסה בכרטיסייה כללי, בודקים את לצד כל מודול של תכונה שתרצו לכלול בפריסה של האפליקציה.
4. לוחצים על אישור.

כברירת מחדל, ב-Android Studio לא מתבצעת פריסה של האפליקציה באמצעות קובצי App Bundle לפריסה באפליקציה שלך. במקום זאת, סביבת הפיתוח המשולבת (IDE) יוצר ומתקין במכשיר חבילות APK שעברו אופטימיזציה למהירות פריסה, ולא את גודל ה-APK. כדי להגדיר את Android Studio ליצור ולפרוס במקום זאת חבילות APK וחוויות ללא התקנה מ-App Bundle, צריך לשנות את ההרצה או ניפוי הבאגים הגדרה אישית.

שימוש במודולים של תכונות להעברה מותאמת אישית

יתרון ייחודי של מודולים של תכונות הוא היכולת להתאים אישית איך ומתי תכונות שונות של האפליקציה יורדות למכשירים שבהם פועלת Android 5.0 (רמת API 21) ומעלה. לדוגמה, כדי להקטין את גודל ההורדה הראשוני של את האפליקציה שלך, אפשר להגדיר תכונות מסוימות להורדה לפי הצורך על פי דרישה או רק באמצעות מכשירים שתומכים ביכולות מסוימות, כמו יכולת לצלם תמונות או לתמוך בתכונות של מציאות רבודה.

אמנם, כברירת מחדל, כשמעלים את האפליקציה נהנים מהורדות שעברו אופטימיזציה במיוחד בתור App Bundle, אפשרויות ההעברה של תכונות מתקדמות יותר וניתנות להתאמה אישית לדרוש הגדרות נוספות ומודולריזציה של תכונות האפליקציה באמצעות מודולים של תכונות. כלומר, מודולים של תכונות מספקים את בלוקים ליצירה של תכונות מודולריות שאפשר להגדיר תתבצע הורדה לפי הצורך.

כדאי לחשוב על אפליקציה שמאפשרת למשתמשים לקנות ולמכור מוצרים באינטרנט זירת מסחר. אפשר לשנות באופן סביר כל אחת מהפונקציות הבאות של האפליקציה למודולים נפרדים של תכונות:

• התחברות לחשבון ויצירה שלו
• גלישה בזירת המסחר
• הצבת פריט למכירה
• עיבוד תשלומים

הטבלה הבאה מתארת את אפשרויות השליחה השונות שכוללות תמיכה במודולים, והאופן שבו ניתן להשתמש בהם כדי לבצע אופטימיזציה של ההורדה הראשונית הגודל של אפליקציית Marketplace לדוגמה.

פיתוח URI של משאב

אם רוצים לגשת למשאב שמאוחסן במודול של תכונות באמצעות URI, כך יוצרים URI של משאב של מודול תכונה באמצעות Uri.Builder():

val uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build()

String uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build().toString();

כל חלק בנתיב אל המשאב נוצר בזמן הריצה, באופן שמבטיח שמרחב השמות הנכון ייווצר אחרי שחבילות ה-APK המפוצלות נטענות.

דוגמה לאופן שבו ה-URI נוצר, נניח שיש לך אפליקציה מודולים של תכונות עם השמות הבאים:

• השם של חבילת האפליקציה: com.example.my_app_package
• שם החבילה של משאבי התכונה: com.example.my_app_package.my_dynamic_feature

אם ה-resId בקטע הקוד שלמעלה מפנה למשאב של קובץ גולמי בשם "my_video" במודול התכונה, ואז הקוד Uri.Builder() שלמעלה פלט את הדברים הבאים:

android.resource://com.example.my_app_package/raw/com.example.my_app_package.my_dynamic_feature:my_video

לאחר מכן האפליקציה תוכל להשתמש ב-URI הזה כדי לגשת למשאב של מודול התכונה.

כדי לאמת את הנתיבים ב-URI, אפשר להשתמש בכלי לניתוח APK כדי לבדוק את ה-APK של מודול התכונות ולקבוע את שם החבילה:

איור 2. אפשר להשתמש בכלי הניתוח של APK כדי לבדוק את שם החבילה בקובץ משאבים שעבר הידור.

שיקולים במודולים של תכונות

באמצעות מודולים של תכונות אפשר לשפר את מהירות ה-build ואת המהירות ההנדסית, ולבצע התאמה אישית נרחבת של תכונות האפליקציה כדי להקטין את גודל האפליקציה. עם זאת, יש מספר מגבלות ותרחישי קצה שכדאי לזכור כשמשתמשים במודולים של תכונות:

• התקנה של 50 מודולים של תכונות או יותר במכשיר אחד, באמצעות תנאי או על פי דרישה, עלולה להוביל לבעיות בביצועים. מודולים בזמן ההתקנה, לא מוגדרות כניתנות להסרה, הן נכללות באופן אוטומטי בבסיס והם נחשבים למודול אחד של תכונות בכל מכשיר.
• צריך להגביל את מספר המודולים שהוגדרו כמודולים נשלפים לפי זמן ההתקנה משלוח עד 10 פריטים או פחות. אחרת, הפרמטר זמן ההורדה וההתקנה של האפליקציה עשוי להתארך.
• רק מכשירים שבהם פועלת גרסת Android 5.0 (רמת API 21) ותמיכה מתקדמת יותר הורדה והתקנה של תכונות לפי דרישה. כדי להפוך את התכונה לזמינה לגרסאות קודמות של Android, מפעילים שילוב כשיוצרים מודול של תכונות.
• מפעילים את SplitCompat, כך שלאפליקציה תהיה גישה למודולים של תכונות שהורדתם ביקוש.
• אין לציין במודולים של תכונות פעילויות במניפסט שלהם android:exported הוגדר לערך true הסיבה היא שאין ערובה לכך שהמכשיר הוריד את מודול התכונה כשאפליקציה אחרת מנסה להפעיל פעילות. בנוסף, האפליקציה צריכה לאשר שתכונה מסוימת שהורד לפני שניסית לגשת לקוד ולמשאבים שלו. מידע נוסף זמין במאמר הבא: ניהול המודולים המותקנים.
• בהתאם לדרישות של Play Feature Delivery, צריך לפרסם את האפליקציה באמצעות App Bundle, לוודא שידוע לך על App Bundle בעיות ידועות.

מאמרי עזרה על מניפסט של מודול תכונות

כשיוצרים מודול של תכונות חדשות באמצעות Android Studio, סביבת הפיתוח המשולבת (IDE) כוללת את רוב מאפייני המניפסט שהמודול דורש כדי להתנהג כמו מודול של פיצ'רים. בנוסף, חלק מהמאפיינים מוחדרים על ידי בזמן הידור (compile), כך שאין צורך לציין או לשנות אותם בעצמכם. בטבלה הבאה מתוארים מאפייני המניפסט שחשובים להם של הפיצ'רים האלה.

מקורות מידע נוספים

למידע נוסף על השימוש במודולים של תכונות, אפשר לנסות את המשאבים הבאים.

פוסטים בבלוגים

• תכונות חדשות שיעזרו לכם לפתח, לפרסם ולהרחיב את העסק שלכם ב-Google Play
• העדכונים האחרונים בקובץ Android App Bundle, כולל ממשק ה-API של שפות נוספות
• Patchwork Plaid – סיפור על מודולריזציה

סרטונים

• פיתוח ניתן להתאמה אישית באמצעות ה-App Bundle ושיתוף קל של גרסאות build לבדיקה
• כלים חדשים לאופטימיזציה לגודל האפליקציה ולהגדלת מספר ההתקנות ב-Google Play

התנאים וההגבלות ואבטחת הנתונים

גישה לספרייה להעברת תכונות של Play או שימוש בה מבטאים את הסכמתך ל התנאים וההגבלות של Play Core Software Development Kit. חשוב לקרוא ומבינים את כל התנאים וכללי המדיניות הרלוונטיים לפני הגישה לספרייה.

אבטחת נתונים

ספריות הליבה של Play הן ממשק זמן הריצה של האפליקציה בחנות Google Play. לכן, כשמשתמשים ב-Play Core באפליקציה, חנות Play מפעילה תהליכים, כולל טיפול בנתונים בהתאם התנאים וההגבלות של Google Play. בהמשך מוסבר איך ספריות Play Core מטפלות בנתונים כדי לעבד בקשות ספציפיות מהאפליקציה שלכם.

ממשק API לשפות נוספות

הפצת פיצ'רים ב-Play

אנחנו שואפים לשמור על שקיפות רבה ככל האפשר, אבל אתם האחראים הבלעדיים על ההחלטה איך להגיב לטופס של סעיף אבטחת הנתונים של Google Play בנוגע לנוהלי האיסוף, השיתוף והאבטחה של נתוני המשתמשים באפליקציה.