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

מודל הצגת האפליקציות של Google Play משתמש בקובצי Android App Bundle כדי ליצור ולהציג חבילות 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 של מודול התכונות:

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

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

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

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

1. בסרגל התפריטים, בוחרים באפשרות Run > Edit Configurations.
2. בחלונית השמאלית של תיבת הדו-שיח Run/Debug Configurations, בוחרים את ההגדרה הרצויה של Android App.
3. בקטע Dynamic features to deploy בכרטיסייה General, מסמנים את התיבה לצד כל מודול של תכונות שרוצים לכלול בפריסת האפליקציה.
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 נוצר, נניח שיש לכם אפליקציה ומודולים של תכונות עם השמות הבאים:

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

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

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

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

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

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

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

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

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

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

סרטונים

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

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

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

אבטחת נתונים

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

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

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

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