Büyük ekranlarda uygulama uyumluluğu kurulum kılavuzu

Bu sayfada, Android'in büyük ekranlı cihazlarda uygulama uyumluluğu yapılandırma katmanları için kapsamlı bir kurulum kılavuzu ve dizin yer alır.

Ekran

Bu bölümde, görüntüleme düzeyindeki yapılandırmayı etkileyen tüm yapılandırma ayarları listelenmektedir.

Ad Konum Tür Varsayılan
ignoreOrientationRequest display_settings.xml yapılandırma false
Büyük ekranlar (>= 600 dp) için true
Açıklama
Belirtilen ekranda sabit yönlü etkinliklerin ücretsiz kullanıcı döndürmesini sağlar.
Örnek: 
          <display-settings>
              <config identifier="0" />
              <display
                  name="<display's uniqueId>"
                  ignoreOrientationRequest="true"/>
          </display-settings>

Kullanım alanı veya bağlam
Ekran, tüm uygulamaların istenen yönünü yoksayıyor ve uygulama sinemaskop olarak gösteriliyor.
Tüm büyük ekranlı cihazlarda ve Android Automotive OS'te kullanılır. Bu, Android 16 ve sonraki sürümlerde smallestScreenWidthDp >= 600dp bulunan tüm büyük ekranlı cihazlarda varsayılan ayardır.
config_letterboxIsDisplayRotationImmersiveAppCompatPolicyEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Tam ekran modundayken otomatik olarak en uygun olmayan ekran yönüne dönmeyi engelleyen, tam ekran uygulamaları için döndürme uyumluluğu politikasını etkinleştirir. Oyunlar gibi etkileyici uygulamalar genellikle tüm yönler için optimize edilmediğinden ve döndürüldüğünde kötü bir kullanıcı deneyimi sunabileceğinden bu gereklidir. Ayrıca bazı oyunlar, oynanış için sensörleri kullanır. Bu nedenle, otomatik döndürme açıkken kullanıcılar bu tür döndürmeleri yanlışlıkla tetikleyebilir.
Yalnızca ignoreOrientationRequest etkinse geçerlidir.

Kullanım alanı veya bağlam
Immersive uygulamalarda döndürmeyi kilitler.

En boy oranı

Bu bölümde, en boy oranı için etkinlik düzeyinde pencere yapılandırmasını etkileyen tüm yapılandırma ayarları listelenir.

Ad Konum Tür Varsayılan
config_fixedOrientationLetterboxAspectRatio frameworks/base/core/res/res/values/config.xml Float 0.0
Description
Sabit yön için letterboxing'in en boy oranını yapılandırır. 1.0 değerine eşit veya bu değerden küçük olan değerler yok sayılır.

Kullanım alanı veya bağlam
Cihazın varsayılan en-boy oranını, çoğu sinemaskop uygulaması için uygun olacak şekilde yapılandırır. Genellikle kare en-boy oranına daha yakındır.
config_letterboxIsSplitScreenAspectRatioForUnresizableAppsEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Yeniden boyutlandırılamayan uygulamalar için varsayılan en-boy oranı olarak bölünmüş ekran en-boy oranının kullanılıp kullanılmayacağını yapılandırır.

Kullanım alanı veya bağlam
Yeniden boyutlandırılamayan uygulamaların çoğu, dikey şeker çubuğu telefon düzeni bekler.
config_letterboxIsDisplayAspectRatioForFixedOrientationLetterboxEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Tüm sinemaskop uygulamalar için varsayılan en-boy oranı olarak ekran en-boy oranının kullanılıp kullanılmayacağını yapılandırır.

Kullanım alanı veya bağlam
Bir kayan noktalı değer yapılandırmak yerine ekran en-boy oranını programatik olarak kullanmaya yönelik bir yapılandırma.

Kamera

Bu bölümde, onCameraOpened geri çağrıldığında uygulamaları etkileyen tüm yapılandırma ayarları listelenir. Bu ayarlar ekranı, etkinliği ve kamera yapılandırmasını etkileyebilir.

Ad Konum Tür Varsayılan
config_isWindowManagerCameraCompatTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Kamera arabellekleri ile uygulama penceresi arasındaki yön uyuşmazlığından kaynaklanan sorunlar için kamera uyumluluğu işlemesini etkinleştirir.
Buna, sabit yönlü etkinliklerin tam ekranda kameraya bağlıyken zorunlu olarak döndürülmesi ve bölünmüş ekranda ipucu gösterilmesi dahildir.
Zorunlu döndürme işlemi, uygulama bazında geçersiz kılınarak devre dışı bırakılabilir: OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION.

Kullanım alanı veya bağlam
Ekranı, uygulamanın istediği yöne zorunlu döndürerek döndürülmüş kamera önizlemelerini düzeltir.
config_isWindowManagerCameraCompatSplitScreenAspectRatioEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Kamera uyumluluğu işleme özelliği etkinleştirildiğinde ve etkinlik tam ekran modunda kameraya bağlandığında bir etkinliğin bölünmüş ekran en-boy oranını kullanıp kullanmayacağını yapılandırır.

Kullanım alanı veya bağlam
Etkinliği, şeker çubuğu benzeri bir en-boy oranına dönüştürerek uzatılmış kamera önizlemelerini düzeltir.
Etkinlik için dikey şeker çubuğu benzeri en boy oranını simüle ederek, yatay cihazlarda gerilmiş kamera uyumluluğu sorunlarını düzeltmek amacıyla genellikle zorunlu döndürme işlemi etkinleştirilmiş olarak (config_isWindowManagerCameraCompatTreatmentEnabled ve camera.enable_landscape_to_portrait) kullanılır.
camera.enable_landscape_to_portrait Sistem özelliği Bool false
Açıklama
OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT tedavisine erişimi kısıtlar.
Doğal yönü yatay olan kameralarda, doğal yönü dikey olan kameraları taklit etmek için kamera çıkışının kırpılıp 90 derece döndürülmesini zorunlu kılar. Bildirilen kamera sensörü yönü, cihazdaki tüm yatay kameralar için dikey olarak ayarlanır. Birçok uygulama bu durumu ele almaz ve aksi takdirde gerilmiş resimler gösterir.

Kullanım alanı veya bağlam
Kamera HAL'ının döndürme ve kırpma işlemlerini etkinleştirir. Bu işlem hakkında daha fazla bilgi için Döndürme, kırpma, ölçeklendirme başlıklı makaleyi inceleyin.
Derleme sırasında mk dosyanıza aşağıdakileri ekleyin: PRODUCT_PROPERTY_OVERRIDES += camera.enable_landscape_to_portrait=true
Bu işlem için cihazın HAL'de desteklemesi SCALER_ROTATE_AND_CROP gerekir. CameraCharacteristics#SCALER_AVAILABLE_ROTATE_AND_CROP_MODES sayfasına göz atın.
SCALER_ROTATE_AND_CROP için HAL'ye özel uygulama hakkında bilgi edinmek istiyorsanız metadata_definitions.xml konusuna bakın.
config_isCameraCompatSimulateRequestedOrientationTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool true
Açıklama
Uygulamanın istediği yönü simüle eden kamera uyumluluğu işleminin etkin olup olmadığını gösterir. Bu işlemin amacı, kamera arabelleği ile uygulama penceresi arasındaki yön uyuşmazlığından kaynaklanan sorunları azaltmaktır. Buna, kameraya bağlı sabit yönlendirme etkinliklerine siyah bant ekleme, kamera arabelleğini kırpma (döndürme ve kırpma) ve ekran döndürmeyi, uygulamanın beklenen yönlendirmesine uyacak şekilde sanal alan oluşturma dahildir.

Kullanım alanı veya bağlam
Aşağıdaki durumlarda kamera etkinlikleri için istenen yönlendirmeyi simüle edin:
  • Serbest biçimli pencere modu
  • locked veya nosensor modları dışında sabit yön isteği

Android 17 ve sonraki sürümlerde bu ayar, config_isWindowManagerCameraCompatTreatmentEnabled'dan gelen döndürmeyi zorlama işlemini devre dışı bırakır ve ekran döndürme korumalı alanı, letterbox ve sabit yönlü kamera uygulamaları için kamera döndürme ve kırpma politikalarını birleştirir.
config_isCameraCompatSimReqOrientationLandscapeTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Bir uygulamanın istediği yönü simüle eden kamera uyumluluğu işleminin yatay kameralar için etkin olup olmadığını gösterir. Bu özelliğin amacı, uygulamaların portre kamera sensörlerini sabit kodlamasından kaynaklanan sorunları azaltmaktır. Bu işlem, kameraya bağlı sabit yönlendirme etkinlikleri için letterbox'ı, kamera arabelleğini kırpmayı (döndürme ve kırpma), sensörü dikey yöne yönlendirmeyi ve ekran döndürmeyi uygulamanın beklenen yönlendirmesine uyacak şekilde korumalı alana almayı içerir.

Kullanım alanı veya bağlam
Android 17 ve sonraki sürümlerde bu işlem, config_isCameraCompatSimulateRequestedOrientationTreatmentEnabled için istenen yönlendirmeyi simüle etme işlemiyle aynıdır ancak yatay yönlendirmeli kameralara sahip cihazlar için geçerlidir.

Arka plan ve kullanıcı arayüzü

Bu bölümde, kullanıcı arayüzü özelleştirmesi için mektup kutusu katmanının yüzeyine veya etkinlik düzeyinde uygulanan tüm yapılandırma ayarları listelenir.

Ad Konum Tür Varsayılan
config_letterboxActivityCornersRadius frameworks/base/core/res/res/values/config.xml Integer 0
Açıklama
Letterbox modunda sunulan bir etkinliğin köşe yarıçapını yapılandırır. 0 değerinden küçük değerler, cihazın alt köşe yarıçapları arasındaki minimum değere eşit bir yarıçapla yuvarlatılmış köşeleri etkinleştirir. 0 varsayılan değeri, AppCompatLetterboxPolicy içinde yuvarlatılmış köşe mantığını devre dışı bırakır.

Kullanım alanı veya bağlam
Genellikle fiziksel cihazın yuvarlatılmış köşeleriyle eşleşecek şekilde yapılandırılır.
config_letterboxIsEnabledForTranslucentActivities frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Yarı saydam etkinlikler için belirli davranışların (ör. sinemaskop) etkinleştirilip etkinleştirilmeyeceğini yapılandırır.

Kullanım alanı veya bağlam
Yarı saydam etkinliklerin veya kalıcı öğelerin sinemaskop şeklinde gösterilmesini ve sinemaskop şeklindeki etkinlik yapılandırması içinde sınırlandırılmasını sağlar. Politika, TransparentPolicy için geçerlidir.
config_isCompatFakeFocusEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Bölünmüş ekranla devam ettirilen etkinlikler için sahte odak uyumluluğu gönderme özelliğinin etkinleştirilip etkinleştirilmeyeceğini yapılandırır. Etkinleştirilirse, bölünmüş ekranla devam ettirilen etkinlikler için sahte odak uyumluluğu gönderilir.
Bazı oyun motorları, uygulamanın içeriğini çizmeden önce odaklanmayı beklediği için bu gereklidir. Bu özellik, çok pencereli modlarda varsayılan olarak sağlanmaz.

Kullanım alanı veya bağlam
Bölünmüş ekran moduna girdikten sonra kararan ve yalnızca kullanıcı uygulamaya dokunup odaklandıktan sonra çizilen uygulamalar için Unity oyun motorlarına uyumluluk işlemi uygulamak üzere kullanılan eski bir işaret.
config_letterboxBackgroundType frameworks/base/core/res/res/values/config.xml Integer 0
Açıklama
Mektup zarfı arka planının köşe görünümünü yapılandırır:
  • 0 - R.color.config_letterboxBackgroundColor içinde belirtilen rengin kullanıldığı düz arka plan.
  • 1 - R.attr.colorBackground içinde, sinemaskoplu uygulama için belirtilen renk.
  • 2 - R.attr.colorBackgroundFloating içinde, sinemaskop görünümündeki uygulama için belirtilen renk.
  • 3 - Bulanıklaştırma efekti uygulanmış veya koyu renkli duvar kağıdı. Aşağıdaki parametrelerden en az biri 0 değerinden büyük olmalıdır: config_letterboxBackgroundWallpaperBlurRadius veya config_letterboxBackgroundWallpaperDarkScrimAlpha. Bu durum söz konusu değilse veya bulanıklık yarıçapı sağlanmış ancak bulanıklık cihaz tarafından desteklenmiyorsa ve bu seçenek belirlenmişse uygulama varsayılan olarak 0 seçeneğini kullanır. Belirtilen değer bu aralığın dışındaysa 0 seçeneği varsayılır.


Kullanım alanı veya bağlam
Bu özellik, mevcut performans sorunları nedeniyle kullanıma sunulmamıştır. OEM'ler bu özelliğin kendi uygulamalarını oluşturabilir ancak AOSP, hataları ele almaz.
config_letterboxBackgroundColor frameworks/base/core/res/res/values/config.xml Color @color/system_neutral1_1000
Açıklama
Aşağıdaki koşullardan biri geçerliyse mektup kutusu arka planının rengini yapılandırır true:
  • R.integer.config_letterboxBackgroundType için 0 seçeneği belirlendi.
  • 1 seçeneği R.integer.config_letterboxBackgroundType için belirlenmiş ve uygulama için R.attr.colorBackground belirtilmemiş.
  • 2 seçeneği R.integer.config_letterboxBackgroundType için belirlenmiş ve uygulama için R.attr.colorBackgroundFloating belirtilmemiş.
  • 3 seçeneği R.integer.config_letterboxBackgroundType için belirlenmiş ve bulanıklaştırma istenmiş ancak cihazda desteklenmiyor ya da hem koyu katman alfa hem de bulanıklaştırma yarıçapı sağlanmamış.


Kullanım alanı veya bağlam
Bu özellik, mevcut performans sorunları nedeniyle kullanıma sunulmamıştır. OEM'ler bu özelliğin kendi uygulamalarını oluşturabilir ancak AOSP, hataları ele almaz.
config_letterboxBackgroundWallpaperBlurRadius frameworks/base/core/res/res/values/config.xml Dimen 38dp
Description
R.integer.config_letterboxBackgroundType içindeki 3 seçeneği için bulanıklaştırma yarıçapını yapılandırır. 0 değerinden küçük değerler yoksayılır ve 0 değeri kullanılır.

Kullanım alanı veya bağlam
Bu özellik, mevcut performans sorunları nedeniyle kullanıma sunulmamıştır. OEM'ler bu özelliğin kendi uygulamalarını oluşturabilir ancak AOSP, hataları ele almaz.
config_letterboxBackgroundWallpaperDarkScrimAlpha frameworks/base/core/res/res/values/config.xml Float 0.54
Açıklama
R.integer.config_letterboxBackgroundType için 3 seçeneği belirlendiğinde duvar kağıdı mektup kutusu arka planı üzerinde gösterilen siyah yarı saydam bir scrim'in alfa değerini yapılandırır. R.integer.config_letterboxBackgroundType için 3 seçeneği belirlendiğinde duvar kağıdı mektup kutusu arka planı üzerinde gösterilen siyah yarı saydam bir scrim'in alfa değerini yapılandırır. 0 değerinden küçük veya 1 değerine eşit ya da bu değerden büyük olan değerler yoksayılır ve bunun yerine 0.0 (şeffaf) kullanılır.

Kullanım alanı veya bağlam
Bu özellik, mevcut performans sorunları nedeniyle kullanıma sunulmamıştır. OEM'ler bu özelliğin kendi uygulamalarını oluşturabilir ancak AOSP, hataları ele almaz.
config_enableSelfKillRecoveryBetweenInternalDisplays frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
true, ekran dahili ekranlar arasında hareket ettiğinde kendi kendini kapatma kurtarma mantığı geçerli olur.

Kullanım alanı veya bağlam
Android 17 ve sonraki sürümlerde kendi kendini kapatma kurtarma işlemi yalnızca harici monitörlerin kullanıldığı ekran hareketleri için etkinleştirilir. Ancak bu işlem, iç ve dış ekranlarında farklı yoğunluklar bulunan katlanabilir cihazlarda da etkilidir. Bu yapılandırma, söz konusu cihazlarda işlemi etkinleştirir.

Erişilebilirlik ve konumlandırma

Bu bölümde, erişilebilirlik için etkinlik düzeyinde pencere yapılandırmasına uygulanan tüm yapılandırma ayarları listelenir.

Ad Konum Tür Varsayılan
config_letterboxIsHorizontalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Tam ekran pencereli modda, sinemaskop uygulamaları için yatay erişilebilirlik yeniden konumlandırmanın etkinleştirilip etkinleştirilmeyeceğini yapılandırır.

Kullanım alanı veya bağlam
Dikey bir uygulamayı daha kolay erişim için sola veya sağa yeniden konumlandırır.
config_letterboxHorizontalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.5
Açıklama
Sinemaskop görünümlü uygulama penceresinin ortasının yatay konumunu yapılandırır.
0 ekranın sol tarafını, 1 ise sağ tarafını ifade eder.
Belirtilen değer 0 değerinden küçük veya 1 değerinden büyükse yoksayılır. Kitap dışı duruşlarda merkezi konum (0.5) kullanılır. Kitap duruşu için sol konum (0.0) kullanılır.

Kullanım alanı veya bağlam
Dikey, sinemaskop şeklinde bir uygulama için varsayılan olarak ortalanır.
config_letterboxIsVerticalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Tam ekran pencereleme modunda, dikey erişilebilirlik yeniden konumlandırmasının sinemaskop uygulamalar için etkinleştirilip etkinleştirilmeyeceğini yapılandırır.

Kullanım alanı veya bağlam
Yatay uygulamaları daha kolay erişim için üste veya alta yeniden konumlandırır.
config_letterboxVerticalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
Açıklama
Letterbox'lı uygulama penceresinin merkezinin dikey konumunu yapılandırır.
0 değeri ekranın üst kısmına, 1 değeri ise alt kısmına karşılık gelir.
Belirtilen değer 0 değerinden küçük veya 1 değerinden büyükse yoksayılır. Masaüstü dışı modda, merkezi konum (0.5) kullanılır. Masaüstü duruşunda üst konum (0.0) kullanılır.

Kullanım alanı veya bağlam
Geniş ekranlı cihazlarda yatay olarak yapılandırılmış, mektup formatında bir uygulama için ortalanmış.
config_letterboxIsAutomaticReachabilityInBookModeEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Kitap duruşu otomatik yatay erişilebilirlik konumlandırmasının, tam ekran pencereli görüntüleme modundaki letterbox uygulamaları için etkinleştirilip etkinleştirilmeyeceğini yapılandırır.

Kullanım alanı veya bağlam
Katlanabilir cihaz kitap duruşundayken dikey letterbox uygulamasının sol ve sağ arasında hareket etmesine olanak tanır.
config_letterboxBookModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
Açıklama
Kitap duruşundayken sinemaskop uygulama penceresinin merkezinin yatay konumunu yapılandırır.
0 ekranın sol tarafını, 1 ise sağ tarafını ifade eder. Belirtilen değer 0 değerinden küçük veya 1 değerinden büyükse bu değer yoksayılır ve sol konum (0.0) kullanılır.

Kullanım alanı veya bağlam
Uygulamanın kitap duruşunda yeniden konumlandırıldığında ne kadar hareket edeceğini belirten bir çarpan.
config_letterboxDefaultPositionForBookModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
Açıklama
Erişilebilirlik etkinleştirildiğinde ve bir uygulama yatay cihaz yönünde ve kitap duruşunda tam ekran olduğunda sinemaskop uygulama penceresinin varsayılan yatay konumunu yapılandırır. Erişilebilirlik etkinleştirildiğinde konum; sol, orta ve sağ arasında değişebilir:
  • 0. seçenek - Sol
  • 1. seçenek - Ortala
  • 2 seçeneği - Sağ
Belirtilen değer bu aralığın dışındaysa 0 seçeneğinin (sol) kullanıldığı varsayılır.

Kullanım alanı veya bağlam
Uygulamanın kitap modunda yerleştirildiği varsayılan konum.
config_letterboxTabletopModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
Açıklama
Masaüstü duruşundayken sinemaskoplu uygulama penceresinin merkezinin dikey konumunu yapılandırır.
0 değeri ekranın üst kısmına, 1 değeri ise alt kısmına karşılık gelir. Belirtilen değer 0 değerinden küçük veya 1 değerinden büyükse bu değer yoksayılır ve en üst konum 0.0 kullanılır.

Kullanım alanı veya bağlam
Uygulamanın masaüstü duruşunda katlanabilir bir cihazda ne kadar hareket edeceğini belirten bir çarpan.
config_letterboxDefaultPositionForTabletopModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
Açıklama
Erişilebilirlik etkinleştirildiğinde ve bir uygulama dikey cihaz yönünde ve masaüstü duruşunda tam ekran olduğunda sinemaskop uygulama penceresinin varsayılan dikey konumunu yapılandırır. Erişilebilirlik etkinleştirildiğinde konum üst, orta ve alt arasında değişebilir. Bu yapılandırma varsayılanı tanımlar:
  • 0. seçenek - Üst
  • 1. seçenek - Ortala
  • 2. seçenek: Alt
Belirtilen değer bu aralığın dışındaysa 0 seçeneğinin (üst) kullanıldığı varsayılır.

Kullanım alanı veya bağlam
Uygulamanın masaüstü modunda yerleştirildiği varsayılan konum.

Ayarlar

Bu bölümde, Ayarlar > Uygulamalar > En-boy oranı'nda kullanıcı en-boy oranı ayarlarını özelleştirmek ve etkinleştirmek için kullanılan tüm yapılandırma ayarları listelenir.

Ad Konum Tür Varsayılan
config_appCompatUserAppAspectRatioSettingsIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Uygulama başına kullanıcı en-boy oranı geçersiz kılma ayarlarının etkinleştirilip etkinleştirilmeyeceğini yapılandırır.

Kullanım alanı veya bağlam
Ayarlar > Uygulamalar > En-boy oranı'nda en-boy oranı ayarları özelliğini etkinleştirir.
config_appCompatUserAppAspectRatioFullscreenIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Kullanıcı en-boy oranı ayarlarında uygulama başına tam ekran geçersiz kılma seçeneğinin etkinleştirilip etkinleştirilmeyeceğini yapılandırır.

Kullanım alanı veya bağlam
Kullanıcı en-boy oranı ayarları özelliğinde Tam ekran seçeneğini etkinleştirir.
Bu ayar, uygulamaların yeniden boyutlandırılamama, en boy oranı ve yönlendirme kısıtlamalarını yoksayar.
config_userAspectRatioOverrideEntries packages/apps/Settings/res/values/config.xml string-array Tüm seçenekler varsayılan olarak etkindir.
Açıklama
Uygulama en-boy oranı ayarları ekranını ve kullanıcı en-boy oranı geçersiz kılma seçeneklerini yapılandırır. config_userAspectRatioOverrideValues ile aynı uzunlukta ve sırada olmalıdır.
Değiştirilirse UserAspectRatioBackupManager.java içinde en yakın değeri seçmek için Yedekleme ve Geri Yükleme mantığını da güncelleyin.

Kullanım alanı veya bağlam
Ayarlar'da gösterilen dizeler için eşlemeler.
config_userAspectRatioOverrideValues packages/apps/Settings/res/values/config.xml integer-array Varsayılan olarak tüm AOSP dizeleri kullanılır.
Açıklama
Uygulama en-boy oranı ayarları ekranını ve kullanıcı en-boy oranı geçersiz kılma seçeneklerini yapılandırır. config_userAspectRatioOverrideEntries ile aynı uzunlukta ve sırada olmalıdır. Değerler, PackageManager.UserMinAspectRatio ile eşleşmelidir.
Değiştirilirse UserAspectRatioBackupManager.java'deki en yakın değeri seçmek için Yedekleme ve Geri Yükleme mantığını da güncelleyin.UserAspectRatioBackupManager.java.

Kullanım alanı veya bağlam
Arka uçtaki seçeneklerin eşlemeleri PackageManager.UserMinAspectRatio:
  • Uygulama varsayılanı: 0
  • Bölünmüş ekran - 1
  • Ekran en-boy oranı: 2
  • 4:3 - 3
  • 16:9 - 4
  • 3:2 - 5
  • Tam ekran: 6
Statik açık tema çizilebilirleri packages/apps/Settings/res/drawable/ic_app_aspect_ratio_<option>.xml vector Yatay katlanabilir boyutlu öğeler
Açıklama
Mevcut çizilebilir öğeleri yapılandırır:


Kullanım alanı veya bağlam
Ayarlar > Uygulama bilgileri > En-boy oranı bölümündeki her seçeneğin altında açık temalı statik resimler.
Statik koyu tema çizilebilirleri packages/apps/Settings/res/drawable-night/ic_app_aspect_ratio_<option>.xml vector Yatay katlanabilir boyutlu öğeler
Açıklama
Mevcut çizilebilir öğeleri yapılandırır:


Kullanım alanı veya bağlam
Ayarlar > Uygulama bilgileri > En-boy oranı bölümündeki her seçeneğin altında koyu temalı statik resimler.
Dinamik çizilebilir öğe
user_aspect_ratio_education.json		 packages/apps/Settings/res/raw/user_aspect_ratio_education.json JSON Yatay katlanabilir boyutlu dinamik öğe
Açıklama
UserAspectRatioAppsPageProvider içinde bir Lottie çizimi yapılandırır.

Kullanım alanı veya bağlam
Uygulama listesinin altındaki bir animasyon: Ayarlar > Uygulamalar > En-boy oranı.

Eğitim

Bu bölümde, kullanıcıları uygulama uyumluluğu özellikleri hakkında eğitmek için kullanılan tüm yapılandırma ayarları listelenir.

Ad Konum Tür Varsayılan
config_letterboxIsEducationEnabled frameworks/base/core/res/res/values/config.xml Bool false
Açıklama
Tam ekran uygulamalarda mektup zarfı eğitimi özelliğinin etkinleştirilip etkinleştirilmeyeceğini yapılandırır.

Kullanım alanı veya bağlam
Tam ekran uygulamalarda mektup zarfı eğitimi kullanım alanı için Şekil 1'e bakın.
config_letterboxIsRestartDialogEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
Açıklama
Genişletilmiş yeniden başlatma iletişim kutusunun etkinleştirilip etkinleştirilmeyeceğini yapılandırır.

Kullanım alanı veya bağlam
Genişletilmiş yeniden başlatma iletişim kutusunun kullanım alanını görmek için Şekil 2'ye bakın.
config_letterboxIsReachabilityEducationEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
Açıklama
Erişilebilirlik hakkında ek eğitimin etkinleştirilip etkinleştirilmeyeceğini yapılandırır.

Kullanım alanı veya bağlam
Erişilebilirlik eğitimi kullanım alanı için Şekil 3'e bakın.
config_isSizeCompatRestartButtonEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool true
Açıklama
Boyut uyumluluğu yeniden başlatma düğmesinin etkinleştirilip etkinleştirilmeyeceğini yapılandırır.

Kullanım alanı veya bağlam
Pencere boyutu değiştiğinde (ör. bölünmüş ekrana girildiğinde veya ekran döndürüldüğünde) yeniden boyutlandırılamayan uygulamaların yapılandırmasını yeniden başlatmak için kullanılan yeniden başlatma düğmesi.
Beden uyumluluğu yeniden başlatma düğmesinin kullanım alanı için Şekil 4'e bakın.
config_letterboxRestartButtonHideTolerance frameworks/base/libs/WindowManager/Shell/res/values/config.xml Integer 100
Açıklama
Boyut uyumluluğu yeniden başlatma düğmesini gizlemek için görevindeki etkinlik sınırlarının yüzdesinin minimum toleransını yapılandırır. 0 değerinden düşük veya 100 değerinden yüksek olan değerler yok sayılır.
100, boyut uyumluluğu yeniden başlatma düğmesinin gizlenmesine izin vermek için etkinliğin görevle tam olarak eşleşmesi gereken varsayılan değerdir. 0 değeri, boyut uyumluluğu yeniden başlatma düğmesinin her zaman gizli olduğu anlamına gelir.

Kullanım alanı veya bağlam
Yeniden boyutlandırılamayan uygulamalar kullanıcı tarafından döndürüldüğünde yeniden başlatma düğmesini gizlemek için kareye yakın cihazlarda kullanılır. Ancak uygulamayı yeniden başlatmak kullanıcı arayüzünü önemli ölçüde iyileştirmez.

Aşağıdaki resimlerde eğitim yer paylaşımının kullanım alanları gösterilmektedir:

Tam ekran uygulamalar için letterbox eğitimi

Şekil 1. Tam ekran uygulamalar için letterbox eğitimi

Genişletilmiş yeniden başlatma iletişim kutusu örneği.

Şekil 2. Genişletilmiş yeniden başlatma iletişim kutusu

Erişilebilirlik eğitimi örneği.

Şekil 3. Erişilebilirlik eğitimi.

Boyut uyumluluğu yeniden başlatma düğmesinin örneği.

Şekil 4. Boyut uyumluluğu yeniden başlatma düğmesi.