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

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

Play Feature Delivery משתמש ביכולות מתקדמות של קובצי 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: כשמפתחים את חבילת האפליקציה, 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. לכן, למרות שכל מודול של מאפיין עשוי לציין קבוצה חדשה של כללים, הכללים האלה חלים על כל המודולים בפרויקט האפליקציה.

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

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

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

1. בסרגל התפריטים, בוחרים באפשרות הפעלה > עריכת הגדרות.
2. בחלונית הימנית של תיבת הדו-שיח Run/Debug Configurations, בוחרים את ההגדרה הרצויה של Android App.
3. בקטע Dynamic features to deploy (תכונות דינמיות לפריסה) בכרטיסייה General (כללי), מסמנים את התיבה לצד כל מודול תכונות שרוצים לכלול בפריסה של האפליקציה.
4. לוחצים על אישור.

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

שימוש במודולים של פיצ'רים להפצה מותאמת אישית

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

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

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

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

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

יצירת 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 Analyzer כדי לבדוק את קובץ ה-APK של מודול התכונה ולקבוע את שם החבילה:

איור 2. שימוש ב-APK Analyzer כדי לבדוק את שם החבילה בקובץ משאבים שנאסף.

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

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

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

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

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

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

מידע נוסף על השימוש במודולים של תכונות זמין במקורות המידע הבאים.

פוסטים בבלוג

• תכונות חדשות שיעזרו לכם לפתח, לפרסם ולקדם את העסק ב-Google Play
• העדכונים האחרונים של Android App Bundle, כולל ה-API של שפות נוספות
• Patchwork Plaid — A modularization story

סרטונים

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

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

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

אבטחת נתונים

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

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

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

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