החל משנת 2026, כדי להתאים את התהליך למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור תוספים ל-AOSP ולתרום לו, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main. ענף המניפסט android-latest-release תמיד יפנה לגרסה העדכנית ביותר שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

בדף יש מדריך הגדרה מקיף ואינדקס של שכבות-על להגדרת תאימות של אפליקציות למסכים גדולים ב-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` או שווים לו. הערה: עדיין חלות מגבלות על יחס הגובה-רוחב המינימלי והמקסימלי של הפעילות. לכן, החלפת ברירת המחדל הזו שולטת באזור המסך המקסימלי שהאפליקציה יכולה לתפוס במצב Letterbox. תרחיש שימוש או הקשר ההגדרה הזו קובעת את יחס הגובה-רוחב שמוגדר כברירת מחדל במכשיר, שמתאים לרוב האפליקציות בפורמט letterbox. בדרך כלל קרוב יותר ליחס גובה-רוחב של ריבוע.
`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`.
`config_isCameraCompatSimulateRequestedOrientationTreatmentEnabled`	`frameworks/base/core/res/res/values/config.xml`	`Bool`	`true`
תיאור הגדרה שקובעת אם הטיפול בתאימות למצלמה, שמדמה את הכיוון המבוקש של האפליקציה, מופעל. מטרת הטיפול היא לצמצם בעיות שנגרמות בגלל חוסר התאמה בין כיוון המאגר של המצלמה לבין חלון האפליקציה. זה כולל הוספת פסים שחורים בצדדים לפעילויות עם אוריינטציה קבועה שמחוברות למצלמה, חיתוך של מאגר המצלמה (סיבוב וחיתוך) וארגז חול לסיבוב התצוגה כדי להתאים לאוריינטציה הצפויה של האפליקציה. תרחיש לדוגמה או הקשר סימולציה של האוריינטציה המבוקשת לפעילויות של המצלמה ב: מצב חלונות צפים בקשה לכיוון קבוע, שאינו במצב `locked` או `nosensor` ב-Android 17 ואילך, ההגדרה הזו משביתה את הטיפול בסיבוב מאולץ מ-`config_isWindowManagerCameraCompatTreatmentEnabled` ומאחדת את המדיניות לגבי ארגז חול לסיבוב התצוגה, הצגת פסים שחורים בצדדים וסיבוב וחיתוך של המצלמה באפליקציות מצלמה עם כיוון קבוע.
`config_isCameraCompatSimReqOrientationLandscapeTreatmentEnabled`	`frameworks/base/core/res/res/values/config.xml`	`Bool`	`false`
תיאור מציין אם הטיפול בתאימות למצלמה שמדמה את הכיוון המבוקש של האפליקציה מופעל למצלמות לרוחב. מטרת המנגנון היא לצמצם את הבעיות שנגרמות כתוצאה מהטמעה של חיישני מצלמה לפורטרט באפליקציות. הטיפול כולל הוספת פסי שחור בצדדים לפעילויות עם כיוון קבוע שמחוברות למצלמה, חיתוך של מאגר המצלמה (סיבוב וחיתוך), כיוון החיישן לאורך ובידוד של סיבוב המסך כדי להתאים לכיוון הצפוי של האפליקציה. תרחיש לדוגמה או הקשר ב-Android 17 ואילך, הטיפול הזה זהה לטיפול בסימולציה של הכיוון המבוקש עבור `config_isCameraCompatSimulateRequestedOrientationTreatmentEnabled` אבל למכשירים עם מצלמות בכיוון לרוחב.

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

בקטע הזה מפורטות כל הגדרות התצורה שחלות על השטח של שכבת ה-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`
תיאור הגדרה שקובעת אם התכונה 'הוספת פסים שחורים' מופעלת עבור פעילויות שקופות למחצה. תרחיש שימוש או הקשר הגדרה שמאפשרת להוסיף פסים שחורים לפעילויות או לתיבות דו-שיח שקופות למחצה, ולהגביל אותן בהתאם להגדרות של הפעילות בפורמט letterbox. המדיניות חלה ב-`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` עבור האפליקציה בפורמט letterbox. ‫`2` – הצבע שצוין ב-`R.attr.colorBackgroundFloating` עבור האפליקציה בפורמט letterbox. ‫`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`
‫Description מגדיר את השקיפות של מסך שחור שקוף שמוצג מעל רקע תיבת הדואר של הטפט כשבוחרים באפשרות `3` עבור `R.integer.config_letterboxBackgroundType`. המערכת מתעלמת מערכים שקטנים מ-`0` או גדולים מ-`1` או שווים להם, ומשתמשת במקומם בערך `0.0` (שקוף). תרחיש לדוגמה או הקשר התכונה הזו לא הושקה בגלל בעיות ביצועים קיימות. יצרני ציוד מקורי יכולים ליצור הטמעה משלהם של התכונה הזו, אבל AOSP לא יטפל בבאגים.
`config_enableSelfKillRecoveryBetweenInternalDisplays`	`frameworks/base/core/res/res/values/config.xml`	`Bool`	`false`
תיאור כש`true`, התצוגה עוברת בין צגים פנימיים, היא לא פטורה מהלוגיקה של שחזור ההשבתה העצמית. תרחיש שימוש או הקשר ב-Android 17 ואילך, תהליך שחזור ההשבתה העצמית מופעל רק כשמזיזים את התצוגה לצגים חיצוניים. עם זאת, התהליך יעיל גם בטלפונים מתקפלים עם צפיפויות שונות במסכים הפנימיים והחיצוניים. ההגדרה הזו מאפשרת את התהליך במכשירים האלה.

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

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

שם	מיקום	סוג	ברירת מחדל
`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`
תיאור הגדרה של המיקום האופקי של מרכז חלון האפליקציה בפורמט letterbox. `0` מתאים לצד הימני של המסך, ו-`1` מתאים לצד השמאלי. אם הערך שצוין קטן מ-`0` או גדול מ-`1`, המערכת מתעלמת ממנו. במצב שאינו מצב ספר, המיקום המרכזי (`0.5`) משמש כברירת מחדל. במצב ספר, נעשה שימוש במיקום השמאלי (`0.0`). תרחיש שימוש או הקשר ברירת המחדל היא מרכז לאפליקציה עם תיבת מכתבים לאורך.
`config_letterboxIsVerticalReachabilityEnabled`	`frameworks/base/core/res/res/values/config.xml`	`Bool`	`false`
תיאור ההגדרה הזו קובעת אם אפשר לשנות את המיקום של אפליקציות במצב חלון במסך מלא, כדי להגיע אליהן בקלות יותר. תרחיש שימוש או הקשר ההגדרה הזו מאפשרת לשנות את המיקום של אפליקציה לרוחב לחלק העליון או התחתון של המסך, כדי להגיע אליה בקלות יותר.
`config_letterboxVerticalPositionMultiplier`	`frameworks/base/core/res/res/values/config.xml`	`Float`	`0.0`
תיאור הגדרה של המיקום האנכי של מרכז חלון האפליקציה בפורמט letterbox. הערך `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`
תיאור הגדרה של המיקום האופקי של מרכז חלון האפליקציה בפורמט letterbox כשהמכשיר במצב ספר. `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`
נכסי ציור סטטיים עם עיצוב בהיר	`packages/apps/Settings/res/drawable/ic_app_aspect_ratio_<option>.xml`	`vector`	נכסים לרוחב בגודל של מכשיר מתקפל
תיאור הגדרה של הנכסים הגרפיים הזמינים: `ic_app_aspect_ratio_16_9.xml` `ic_app_aspect_ratio_3_2.xml` `ic_app_aspect_ratio_4_3.xml` `ic_app_aspect_ratio_fullscreen.xml` `ic_app_aspect_ratio_half_screen.xml` תרחיש לדוגמה או הקשר תמונות סטטיות עם עיצוב בהיר מתחת לכל אפשרות בהגדרות > פרטי האפליקציה > יחס גובה-רוחב.
תמונות סטטיות לעיצוב כהה	`packages/apps/Settings/res/drawable-night/ic_app_aspect_ratio_<option>.xml`	`vector`	נכסים לרוחב בגודל של מכשיר מתקפל
תיאור הגדרה של הנכסים הגרפיים הזמינים: `ic_app_aspect_ratio_16_9.xml` `ic_app_aspect_ratio_3_2.xml` `ic_app_aspect_ratio_4_3.xml` `ic_app_aspect_ratio_fullscreen.xml` `ic_app_aspect_ratio_half_screen.xml` תרחיש לדוגמה או הקשר תמונות סטטיות עם עיצוב כהה בכל אחת מהאפשרויות בקטע הגדרות > פרטי האפליקציה > יחס גובה-רוחב.
רכיב 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. לחצן הפעלה מחדש של התאמת הגודל.