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

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

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

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

כשיוצרים מודול תכונות חדש באמצעות Android Studio, סביבת הפיתוח המשולבת מחילה את פלאגין 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. לכן, כל מודול תכונות יכול לציין קבוצה חדשה של כללים, אבל הכללים האלה חלים על כל המודולים בפרויקט האפליקציה.

פריסה של האפליקציה

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

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

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, כברירת מחדל אתם מקבלים הורדות שעברו אופטימיזציה גבוהה. עם זאת, כדי להשתמש באפשרויות מתקדמות יותר של העברת תכונות שניתנות להתאמה אישית, אתם צריכים להגדיר את התכונות של האפליקציה ולבצע מודולריזציה שלהן באמצעות מודולים של תכונות. כלומר, מודולים של תכונות מספקים את אבני הבניין ליצירת תכונות מודולריות שאפשר להגדיר כל אחת מהן להורדה לפי הצורך.

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

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

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

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

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

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

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

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

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

פוסטים בבלוג

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

סרטונים

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

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

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

אבטחת נתונים

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

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

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

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