מדריך להגדרת תאימות אפליקציות למסכים גדולים

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

מסך

בקטע הזה מפורטות כל הגדרות התצורה שמשפיעות על התצורה ברמת התצוגה.

שם מיקום סוג ברירת מחדל
ignoreOrientationRequest display_settings.xml config false
true למסכים גדולים (‎>= 600dp)
תיאור
מאפשר למשתמשים להחליף בחינם בין פעילויות עם כיוון קבוע במסך שצוין.
דוגמה: 
          <display-settings>
              <config identifier="0" />
              <display
                  name="<display's uniqueId>"
                  ignoreOrientationRequest="true"/>
          </display-settings>

תרחיש שימוש או הקשר
התצוגה מתעלמת מהכיוון המבוקש של כל האפליקציות, והאפליקציה מוצגת בפורמט letterbox.
משמש בכל המכשירים עם מסך גדול וב-Android Automotive OS. זוהי הגדרת ברירת המחדל בכל המכשירים עם מסך גדול עם smallestScreenWidthDp >= 600dp ב-Android מגרסה 16 ואילך.
config_letterboxIsDisplayRotationImmersiveAppCompatPolicyEnabled frameworks/base/core/res/res/values/config.xml Bool false
תיאור
מדיניות התאימות לסיבוב מופעלת באפליקציות סוחפות כדי למנוע סיבוב אוטומטי לכיוון מסך לא אופטימלי בזמן שהאפליקציה פועלת במסך מלא. הדבר נחוץ כי אפליקציות סוחפות, כמו משחקים, לרוב לא מותאמות לכל הכיוונים ויכולות לספק חוויית משתמש לא טובה כשמסובבים אותן. בנוסף, חלק מהמשחקים מסתמכים על חיישנים במהלך המשחק, ולכן משתמשים יכולים להפעיל בטעות סיבובים כאלה כשהסיבוב האוטומטי מופעל.
ההגדרה הזו רלוונטית רק אם ignoreOrientationRequest מופעלת.

תרחיש לדוגמה או הקשר
ההגדרה הזו נועלת את הסיבוב באפליקציות immersive.

יחס גובה-רוחב

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

שם מיקום סוג ברירת מחדל
config_fixedOrientationLetterboxAspectRatio frameworks/base/core/res/res/values/config.xml Float 0.0
תיאור
הגדרה של יחס הגובה-רוחב של הוספת פסים שחורים (letterboxing) לצורך התאמה של כיוון קבוע. המערכת מתעלמת מערכים שקטנים מ-1.0 או שווים לו.

תרחיש לדוגמה או הקשר
הגדרה של יחס הגובה-רוחב שמוגדר כברירת מחדל במכשיר, שמתאים לרוב האפליקציות עם תיבת מכתבים. בדרך כלל קרוב יותר ליחס גובה-רוחב של ריבוע.
config_letterboxIsSplitScreenAspectRatioForUnresizableAppsEnabled frameworks/base/core/res/res/values/config.xml Bool false
תיאור
הגדרה של יחס הגובה-רוחב שיוגדר כברירת מחדל באפליקציות שלא ניתן לשנות את גודלן.

תרחיש שימוש או הקשר
רוב האפליקציות שלא ניתן לשנות את גודלן מצפות לפריסה של טלפון בצורת ממתק לאורך.
config_letterboxIsDisplayAspectRatioForFixedOrientationLetterboxEnabled frameworks/base/core/res/res/values/config.xml Bool false
תיאור
הגדרה שקובעת אם להשתמש ביחס הגובה-רוחב של המסך כברירת מחדל לכל האפליקציות עם פורמט letterbox.

תרחיש לדוגמה או הקשר
הגדרה שמאפשרת להשתמש באופן פרוגרמטי ביחס הגובה-רוחב של המסך במקום להגדיר ערך מספרי.

מצלמה

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

שם מיקום סוג ברירת מחדל
config_isWindowManagerCameraCompatTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool false
תיאור
הגדרה שמאפשרת לטפל בבעיות תאימות של מצלמות שנגרמות בגלל חוסר התאמה בין המאגרים של המצלמה לבין חלון האפליקציה.
השינוי כולל סיבוב בכוח של פעילויות עם אוריינטציה קבועה שמחוברות למצלמה במסך מלא, והצגת תיאור קצר כשמסך מפוצל.
אפשר להשבית את הטיפול בסיבוב בכפייה באמצעות החלפת ברירת המחדל לכל אפליקציה: OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION.

תרחיש לדוגמה או הקשר
תיקון תצוגות מקדימות של מצלמה מסובבת על ידי סיבוב בכפייה של התצוגה כך שתתאים לכיוון שהאפליקציה מבקשת.
config_isWindowManagerCameraCompatSplitScreenAspectRatioEnabled frameworks/base/core/res/res/values/config.xml Bool false
תיאור
ההגדרה קובעת אם פעילות מסוימת משתמשת ביחס רוחב-גובה של מסך מפוצל כשמופעלת התאמה של המצלמה וכשהפעילות מחוברת למצלמה במסך מלא.

תרחיש שימוש או הקשר
ההגדרה מתקנת תצוגות מקדימות של מצלמה שנמתחו על ידי הוספת מסגרת שחורה לפעילות כדי ליצור יחס רוחב-גובה כמו של חטיף.
בדרך כלל משתמשים יחד עם טיפול בסיבוב מאולץ שמופעל (config_isWindowManagerCameraCompatTreatmentEnabled ו-camera.enable_landscape_to_portrait) במכשירים לרוחב כדי לתקן בעיות תאימות של מצלמה מתוחה על ידי סימולציה של יחס גובה-רוחב אנכי דמוי ממתק לפעילות.
camera.enable_landscape_to_portrait מאפיין מערכת Bool false
תיאור
הגבלת הגישה לטיפול OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT.
ההגדרה הזו מאלצת את הפלט של המצלמה להיחתך ולעבור סיבוב של 90 מעלות במצלמות עם כיוון טבעי לרוחב, כדי לדמות כיוון טבעי לאורך. הכיוון של חיישן המצלמה שדווח הוא לאורך לכל המצלמות לרוחב במכשיר. אפליקציות רבות לא מטפלות במצב הזה ומציגות תמונות מתוחות.

תרחיש שימוש או הקשר
הפעלה של טיפול בחיתוך וסיבוב של רכיב HAL של המצלמה. מידע נוסף על הטיפול הזה זמין במאמר סיבוב, חיתוך ושינוי גודל.
מוסיפים את השורה הבאה לקובץ ה-mk בזמן הבנייה: PRODUCT_PROPERTY_OVERRIDES += camera.enable_landscape_to_portrait=true
כדי להשתמש בשיטה הזו, המכשיר צריך לתמוך ב-SCALER_ROTATE_AND_CROP ב-HAL. מידע נוסף מפורט בCameraCharacteristics#SCALER_AVAILABLE_ROTATE_AND_CROP_MODES.
לקבלת הנחיות להטמעה ספציפית של HAL עבור SCALER_ROTATE_AND_CROP, אפשר לעיין במאמר metadata_definitions.xml.

רקע וממשק משתמש

בקטע הזה מפורטות כל הגדרות התצורה שחלות על השטח של שכבת ה-Letterbox להתאמה אישית של ממשק המשתמש, או ברמת הפעילות.

שם מיקום סוג ברירת מחדל
config_letterboxActivityCornersRadius frameworks/base/core/res/res/values/config.xml Integer 0
תיאור
הגדרה של רדיוס הפינות של פעילות שמוצגת במצב Letterbox. ערכים שקטנים מ-0 מאפשרים פינות מעוגלות ברדיוס ששווה למינימום בין רדיוסים של פינות תחתונות במכשיר. ערך ברירת המחדל 0 משבית את הלוגיקה של פינות מעוגלות ב-AppCompatLetterboxPolicy.

תרחיש שימוש או הקשר
בדרך כלל מגדירים את הערך הזה כך שיתאים לפינות המעוגלות של המכשיר הפיזי.
config_letterboxIsEnabledForTranslucentActivities frameworks/base/core/res/res/values/config.xml Bool false
תיאור
ההגדרה הזו קובעת אם התנהגות ספציפית של פעילויות שקופות למחצה, כמו הוספת פסים שחורים בצדדים, מופעלת.

תרחיש שימוש או הקשר
ההגדרה הזו מאפשרת להוסיף פסים שחורים בצדדים של פעילויות שקופות למחצה או של חלונות קופצים, ולצמצם אותם בהתאם להגדרות של הפעילות. המדיניות חלה ב-TransparentPolicy.
config_isCompatFakeFocusEnabled frameworks/base/core/res/res/values/config.xml Bool false
תיאור
הגדרה של הפעלה או השבתה של שליחת תאימות של מיקוד מזויף לפעילויות שהופסקו במסך מפוצל.
הדבר נחוץ כי מנועי משחקים מסוימים מחכים לקבל פוקוס לפני שהם מציירים את התוכן של האפליקציה, שלא מסופק כברירת מחדל במצבי ריבוי חלונות.

תרחיש לדוגמה או הקשר
דגל מדור קודם להחלת טיפול תאימות במנועי משחקים של Unity עבור אפליקציות שהופכות לשחורות אחרי הכניסה למצב מסך מפוצל, ומצוירות רק אחרי שהמשתמש מקיש על האפליקציה ומעביר אליה את הפוקוס.
config_letterboxBackgroundType frameworks/base/core/res/res/values/config.xml Integer 0
תיאור
הגדרה של מראה הפינות של הרקע של תיבת המכתבים:
  • ‫0 – רקע אחיד בצבע שצוין ב-R.color.config_letterboxBackgroundColor.
  • ‫1 – הצבע שצוין ב-R.attr.colorBackground עבור האפליקציה עם הפסים השחורים בצדדים.
  • ‫2 – הצבע שצוין ב-R.attr.colorBackgroundFloating עבור האפליקציה עם הפסים השחורים.
  • ‫3 – טפט עם טשטוש מעומעם או מסך כהה. לפחות אחד מהפרמטרים הבאים צריך להיות גדול מ-0: config_letterboxBackgroundWallpaperBlurRadius או config_letterboxBackgroundWallpaperDarkScrimAlpha. אם זה לא המצב, או אם מצוין רדיוס טשטוש אבל המכשיר לא תומך בטשטוש והאפשרות הזו נבחרה, ברירת המחדל של ההטמעה היא אפשרות 0. אם הערך שצוין לא נמצא בטווח הזה, המערכת מניחה שנבחרה אפשרות 0.


תרחיש שימוש או הקשר
התכונה הזו לא הושקה בגלל בעיות ביצועים קיימות. יצרני ציוד מקורי יכולים ליצור הטמעה משלהם של התכונה הזו, אבל AOSP לא יטפל בבאגים.
config_letterboxBackgroundColor frameworks/base/core/res/res/values/config.xml Color @color/system_neutral1_1000
תיאור
הגדרה של צבע הרקע של תיבת המכתבים אם אחד מהתנאים הבאים מתקיים: true:
  • האפשרות 0 נבחרה עבור R.integer.config_letterboxBackgroundType.
  • האפשרות 1 נבחרה עבור R.integer.config_letterboxBackgroundType ולא צוינה אפשרות R.attr.colorBackground לאפליקציה.
  • האפשרות 2 נבחרה עבור R.integer.config_letterboxBackgroundType ולא צוינה אפשרות R.attr.colorBackgroundFloating לאפליקציה.
  • האפשרות 3 נבחרה עבור R.integer.config_letterboxBackgroundType והטשטוש נדרש אבל לא נתמך במכשיר, או שלא צוינו גם ערך אלפא של מסך כהה וגם רדיוס טשטוש.


תרחיש שימוש או הקשר
התכונה הזו לא הושקה בגלל בעיות ביצועים קיימות. יצרני ציוד מקורי יכולים ליצור הטמעה משלהם של התכונה הזו, אבל AOSP לא יטפל בבאגים.
config_letterboxBackgroundWallpaperBlurRadius frameworks/base/core/res/res/values/config.xml Dimen 38dp
‫Description
הגדרת רדיוס הטשטוש לאפשרות 3 ב-R.integer.config_letterboxBackgroundType. המערכת מתעלמת מערכים שקטנים מ-0 ומשתמשת ב-0.
תרחיש לדוגמה או הקשר
התכונה הזו לא הושקה בגלל בעיות ביצועים קיימות.
יצרני ציוד מקורי יכולים ליצור הטמעה משלהם של התכונה הזו, אבל AOSP לא יטפל בבאגים.
config_letterboxBackgroundWallpaperDarkScrimAlpha frameworks/base/core/res/res/values/config.xml Float 0.54
תיאור
הגדרה של שקיפות האלפא של מסך שחור שקוף שמוצג מעל רקע תיבת הדואר של הטפט, כשבוחרים באפשרות 3 עבור R.integer.config_letterboxBackgroundType. המערכת מתעלמת מערכים שקטנים מ-0 או גדולים מ-1 או שווים להם, ומשתמשת במקומם בערך 0.0 (שקוף).

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

טווח הגעה ומיקום

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

שם מיקום סוג ברירת מחדל
config_letterboxIsHorizontalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
תיאור
ההגדרה הזו קובעת אם מיקום האפליקציות שמוצגות בפורמט Letterbox במצב חלונות במסך מלא ישתנה כדי שיהיה קל יותר להגיע אליהן.

תרחיש שימוש או הקשר
המיקום של אפליקציה שמוצגת לאורך ישתנה לשמאל או לימין כדי שיהיה קל יותר להגיע אליה.
config_letterboxHorizontalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.5
תיאור
הגדרה של המיקום האופקי של מרכז חלון האפליקציה עם הפסים השחורים.‫
0 מתאים לצד הימני של המסך, ו-1 מתאים לצד השמאלי.
אם הערך שצוין קטן מ-0 או גדול מ-1, המערכת מתעלמת ממנו. במצב שאינו מצב ספר, המיקום המרכזי (0.5) משמש כברירת מחדל. במצב ספר, נעשה שימוש במיקום השמאלי (0.0).

תרחיש שימוש או הקשר
ברירת המחדל היא מרכז לאפליקציה עם תיבת מכתבים לאורך.
config_letterboxIsVerticalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
תיאור
ההגדרה הזו קובעת אם האפשרות לשינוי מיקום אנכי של אפליקציות שמוצגות בפורמט Letterbox מופעלת במצב חלונות מסך מלא.

תרחיש שימוש או הקשר
שינוי המיקום של אפליקציה שמוצגת לרוחב לחלק העליון או התחתון של המסך כדי להקל על הגישה אליה.
config_letterboxVerticalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
תיאור
הגדרה של המיקום האנכי של מרכז חלון האפליקציה עם פסי שחורים.
הערך 0 מתאים לצד העליון של המסך, והערך 1 מתאים לצד התחתון.
אם הערך שצוין קטן מ-0 או גדול מ-1, המערכת מתעלמת ממנו. במצב שאינו 'על משטח, מסך למעלה', נעשה שימוש במיקום המרכזי (0.5). במצב שולחן, נעשה שימוש במיקום העליון (0.0).

תרחיש שימוש או הקשר
ההגדרה היא מרכז במכשירים עם מסך גדול, לאפליקציה עם תיבת מכתבים לרוחב.
config_letterboxIsAutomaticReachabilityInBookModeEnabled frameworks/base/core/res/res/values/config.xml Bool false
תיאור
ההגדרה הזו קובעת אם מיקום אוטומטי של אפליקציות עם פסי שוליים במצב אופקי יהיה זמין באפליקציות עם פסי שוליים במצב חלונות במסך מלא.

תרחיש שימוש או הקשר
ההגדרה הזו מאפשרת לאפליקציה עם פסי שוליים במצב אנכי לעבור בין צד ימין לצד שמאל כשמכשיר מתקפל נמצא במצב ספר.
config_letterboxBookModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
תיאור
הגדרה של המיקום האופקי של מרכז חלון האפליקציה עם תיבת הדואר כשהמכשיר במצב ספר.‫
0 מתאים לצד הימני של המסך, ו-1 מתאים לצד השמאלי. אם הערך שצוין קטן מ-0 או גדול מ-1, המערכת מתעלמת ממנו ומשתמשת במיקום השמאלי (0.0).

תרחיש לדוגמה או הקשר
ערך מכפיל שקובע בכמה יחידות המיקום של האפליקציה ישתנה כשהיא תמוקם מחדש במצב של ספר.
config_letterboxDefaultPositionForBookModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
תיאור
ההגדרה הזו קובעת את המיקום האופקי שמוגדר כברירת מחדל לחלון האפליקציה בפורמט letterbox, כשהאפשרות 'הגעה לאזורים קשים' מופעלת ואפליקציה מוצגת במסך מלא במצב אופקי של המכשיר ובמצב של ספר. כשהתכונה 'יכולת הגעה' מופעלת, המיקום יכול להשתנות בין שמאל, מרכז וימין:
  • Option 0 - Left
  • אפשרות 1 – מרכז
  • אפשרות 2 – ימינה
אם הערך שניתן הוא מחוץ לטווח הזה, המערכת מניחה שצריך להשתמש באפשרות 0 (מימין).

תרחיש שימוש או הקשר
המיקום שמוגדר כברירת מחדל שבו האפליקציה מוצבת במצב ספר.
config_letterboxTabletopModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
תיאור
הגדרה של המיקום האנכי של מרכז חלון האפליקציה בפורמט letterbox במצב שולחן.
הערך 0 מתאים לצד העליון של המסך, והערך 1 מתאים לצד התחתון. אם הערך שצוין קטן מ-0 או גדול מ-1, המערכת מתעלמת ממנו ומשתמשת בערך של המיקום העליון 0.0.

תרחיש לדוגמה או הקשר
מכפיל שקובע בכמה מיקומים האפליקציה תזוז במכשיר מתקפל כשהוא במצב שולחן.
config_letterboxDefaultPositionForTabletopModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
תיאור
ההגדרה הזו קובעת את המיקום האנכי שמוגדר כברירת מחדל לחלון האפליקציה בפורמט letterbox, כשהתכונה 'הגעה לאזורים' מופעלת והאפליקציה במסך מלא במצב אנכי של המכשיר ובמצב שולחני. כשהנגישות מופעלת, המיקום יכול להשתנות בין למעלה, באמצע ולמטה. ההגדרה הזו מגדירה את ברירת המחדל:
  • אפשרות 0 – למעלה
  • אפשרות 1 – מרכז
  • אפשרות 2 – למטה
אם הערך שצוין לא נמצא בטווח הזה, המערכת מניחה שהאפשרות 0 (למעלה) נבחרה.

תרחיש לדוגמה או הקשר
המיקום שמוגדר כברירת מחדל שבו האפליקציה מוצבת במצב שולחן.

הגדרות

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

שם מיקום סוג ברירת מחדל
config_appCompatUserAppAspectRatioSettingsIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
תיאור
הגדרה שקובעת אם ההגדרות של יחסי הגובה-רוחב של המשתמשים לכל אפליקציה מושבתות או מופעלות.

תרחיש שימוש או הקשר
ההגדרה הזו מפעילה את התכונה הגדרות של יחסי גובה-רוחב בהגדרות > אפליקציות > יחסי גובה-רוחב.
config_appCompatUserAppAspectRatioFullscreenIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
תיאור
ההגדרה קובעת אם האפשרות לביטול הגדרות המסך המלא לכל אפליקציה מופעלת בהגדרות יחס הגובה-רוחב של המשתמש.

תרחיש שימוש או הקשר
ההגדרה מפעילה את האפשרות מסך מלא בתכונה הגדרות יחס הגובה-רוחב של המשתמש.
ההגדרה הזו מתעלמת מההגבלות של האפליקציה על שינוי גודל, יחס גובה-רוחב וכיוון.
config_userAspectRatioOverrideEntries packages/apps/Settings/res/values/config.xml string-array כל האפשרויות מופעלות כברירת מחדל.
תיאור
המדיניות הזו מגדירה את מסך ההגדרות של יחס הגובה-רוחב של האפליקציה ואת האפשרויות של המשתמש לשינוי יחס הגובה-רוחב. האורך והסדר של הערכים צריכים להיות זהים לאלה של config_userAspectRatioOverrideValues.
אם משנים את הערך, צריך לעדכן גם את הלוגיקה של הגיבוי והשחזור לבחירת הערך הקרוב ביותר ב-UserAspectRatioBackupManager.java.

תרחיש לדוגמה או הקשר
מיפויים של המחרוזות שמוצגות בהגדרות.
config_userAspectRatioOverrideValues packages/apps/Settings/res/values/config.xml integer-array כברירת מחדל, נעשה שימוש בכל המחרוזות של AOSP.
תיאור
המדיניות הזו מגדירה את מסך ההגדרות של יחס הגובה-רוחב של האפליקציה ואת האפשרויות של המשתמש לשינוי יחס הגובה-רוחב. האורך והסדר של הערכים צריכים להיות זהים לאלה של config_userAspectRatioOverrideEntries. הערכים צריכים להתאים לערך PackageManager.UserMinAspectRatio.
אם הערך השתנה, צריך לעדכן גם את הלוגיקה של הגיבוי והשחזור כדי לבחור את הערך הכי קרוב ב-UserAspectRatioBackupManager.java.

תרחיש לדוגמה או הקשר
מיפויים של האפשרויות לקצה העורפי PackageManager.UserMinAspectRatio:
  • ברירת מחדל של האפליקציה – 0
  • מסך מפוצל – 1
  • יחס גובה-רוחב של המסך – 2
  • ‫4:3 – 3
  • ‫16:9 – 4
  • ‫3:2 - 5
  • מסך מלא – 6
נכסי drawable סטטיים עם עיצוב בהיר packages/apps/Settings/res/drawable/ic_app_aspect_ratio_<option>.xml vector נכסים לרוחב בגודל של מכשיר מתקפל
Description
הגדרה של רכיבי drawable זמינים:


תרחיש שימוש או הקשר
תמונות סטטיות עם עיצוב בהיר מתחת לכל אפשרות בהגדרות > פרטי האפליקציה > יחס גובה-רוחב.
תמונות סטטיות לעיצוב כהה packages/apps/Settings/res/drawable-night/ic_app_aspect_ratio_<option>.xml vector נכסים לרוחב בגודל של מכשיר מתקפל
Description
הגדרה של רכיבי drawable זמינים:


תרחיש לדוגמה או הקשר
תמונות סטטיות עם עיצוב כהה מתחת לכל אפשרות בהגדרות > פרטי האפליקציה > יחס גובה-רוחב.
רכיב drawable דינמי
user_aspect_ratio_education.json		 packages/apps/Settings/res/raw/user_aspect_ratio_education.json JSON נכס דינמי בגודל של מסך מתקפל, לרוחב
תיאור
הגדרה של איור Lottie ב-UserAspectRatioAppsPageProvider.

תרחיש לדוגמה או הקשר
אנימציה מתחת לרשימת האפליקציות: הגדרות > אפליקציות > יחס רוחב-גובה.

חינוך

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

שם מיקום סוג ברירת מחדל
config_letterboxIsEducationEnabled frameworks/base/core/res/res/values/config.xml Bool false
תיאור
ההגדרה הזו קובעת אם ההסבר על תצוגת Letterbox מופעל באפליקציות במסך מלא שמוצגות בתצוגת Letterbox.

תרחיש שימוש או הקשר
איור 1 מציג תרחיש שימוש בהסבר על תצוגת Letterbox באפליקציות במסך מלא.
config_letterboxIsRestartDialogEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
תיאור
הגדרה של הפעלת תיבת הדו-שיח המורחבת להפעלה מחדש.

תרחיש שימוש או הקשר
תרחיש שימוש של תיבת הדו-שיח המורחבת להפעלה מחדש מופיע באיור 2.
config_letterboxIsReachabilityEducationEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
תיאור
הגדרה של הפעלת הדרכה נוספת בנושא זמינות.

תרחיש שימוש או הקשר
איור 3 מציג תרחיש שימוש של הדרכה בנושא זמינות.
config_isSizeCompatRestartButtonEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool true
תיאור
הגדרה שקובעת אם לחצן ההפעלה מחדש של התאמת הגודל מופעל.

תרחיש שימוש או הקשר
לחצן הפעלה מחדש להפעלה מחדש של ההגדרה עבור אפליקציות שלא ניתן לשנות את הגודל שלהן אחרי שינויים בגודל החלון, למשל כשנכנסים למצב מסך מפוצל או מסובבים את התצוגה.
איור 4 מציג תרחיש לדוגמה של כפתור הפעלה מחדש של תאימות גודל.
config_letterboxRestartButtonHideTolerance frameworks/base/libs/WindowManager/Shell/res/values/config.xml Integer 100
תיאור
מגדיר את הסף המינימלי של אחוז גבולות הפעילות בתוך המשימה שלה, כדי להסתיר את לחצן ההפעלה מחדש של התאימות לגודל. המערכת מתעלמת מערכים שקטנים מ-0 או גדולים מ-100.
‫100 הוא ערך ברירת המחדל שבו הפעילות צריכה להתאים בדיוק למשימה כדי לאפשר את ההסתרה של לחצן ההפעלה מחדש של התאמת הגודל. הערך 0 אומר שכפתור ההפעלה מחדש של התאימות לגודל תמיד מוסתר.

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

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

הדרכה בנושא Letterbox לאפליקציות במסך מלא

איור 1. הדרכה בנושא Letterbox לאפליקציות במסך מלא

דוגמה לתיבת דו-שיח מורחבת להפעלה מחדש.

איור 2. תיבת דו-שיח מורחבת להפעלה מחדש

דוגמה להסבר על נגישות.

איור 3. הדרכה בנושא יכולת הגעה.

דוגמה לכפתור ההפעלה מחדש של התאימות לגודל.

איור 4. כפתור הפעלה מחדש של תאימות הגודל.