Tutarlı ve yüksek kaliteli bir kullanıcı deneyimi sunmak ve Compatibility Test Suite (CTS) hatalarına yol açan sorunları önlemek için burada açıklanan temel WindowManager (WM) ilkelerini uygulayın. Bu ilkeler şunlar için geçerlidir:
Android 14'te başlatılan ve Android 15'te ölçeklenebilir kullanıcı arayüzüyle devam eden çok pencereli mimariyi kullanan Android sürümleri.
Android'de ölçeklenebilir kullanıcı arayüzü ve kendi özel uygulamalarınız
İlkeleri uygulayarak CTS uyumluluğu ve işlevsel test sorunlarının çoğunu proaktif bir şekilde önleyebilirsiniz.
Terminoloji
- değişmez
- Bir uygulamanın yürütülmesi boyunca doğru kalan ve yapısal bütünlüğe yol açan mantıksal koşul. Sabit, sınır kuralı görevi görür.
- özel etkinlik
- Otomatik kullanıcı arayüzü etkinliği veya sistem kullanıcı arayüzü etkinliği olarak da bilinen bu kritik uygulama etkinliği, ekranda her zaman görünür olan veya kullanıcı Ana Sayfa düğmesine bastığında bile çoğu zaman görünür olan özel bir alana sahiptir (ör. birincil gezinme veya küme uygulaması).
- standart etkinlik
- Sistemin temel kullanıcı arayüzü için kritik olmayan tüm standart uygulama etkinlikleri (ör. uygulama ızgarasından başlatılan üçüncü taraf medya uygulaması).
WM ilkeleri
CTS uyumluluğunu en üst düzeye çıkarmak için WM uygulamalarınızda bu ilkeleri uygulayın.
Etkinlik başlatılırken sabit bir yapılandırma kullanma
Her yeni standart etkinliği, son konumunu, boyutunu ve yoğunluğunu ayarlayan tek bir WM geçişiyle başlatın. İlk geçişten hemen sonra temel görevin pencere yapılandırmasını (ör. boyut veya yoğunluk) değiştiren ikinci bir geçişi tetiklememelisiniz. Aksi takdirde, etkinlik oluşturulduktan hemen sonra yapılandırma değişikliği gerçekleşir.
Standart etkinlikleri durduruldu durumuna taşıma
Kullanıcı, ana görev veya ana sahneye gittiğinde CTS testlerinin gerektirdiği öngörülebilir Android uygulama yaşam döngüsünü korumak için çalışan tüm standart etkinlikleri durdurulmuş duruma getirmeniz gerekir.
Standart etkinlik içeriğinin gizlenmesini önleme
Standart bir etkinliğin içeriğini engelleyen özel süslemeler veya kullanıcı arayüzü öğeleri çizmeyin. Özel yer paylaşımları (ör. özel iklim kontrol çubuğu) çiziyorsanız boyutları SystemOverlay
iç boşluklarla sisteme bildirmeniz gerekir. Android 15 ve sonraki sürümlerde, ölçeklenebilir kullanıcı arayüzünde DecorPanel simgesini kullanın.
Immersive mod isteğinde yer paylaşımlarını gizleme
Bir uygulama tam ekran modunu istediğinde, geçici özel kullanıcı arayüzü öğelerini gizlemeniz ve bunların SystemOverlayinset'lerini kaldırmanız gerekir. Kalıcı engeller, uygulamanın piksel beklentilerini etkiler.
Yuvarlatılmış köşeleri yalnızca ekran düzeyinde uygular.
Yuvarlatılmış köşeleri yalnızca frameworks/base içindeki uygun kaynak yapılandırmalarını kullanarak ekran düzeyinde uygulayın. Standart bir etkinliğin yüzeyine rastgele yuvarlatılmış köşeler uygulamayın.
Bu işlem, kullanıcı arayüzü öğesi testlerine müdahale eder. Geçici bir önlem olarak, standart etkinliğin yüzeyine uyguladığınız yuvarlak köşe yarıçapını ekranda da belirtebilirsiniz.
Immersive mod isteğinde uygulama boyutunu koruma
Bir uygulama tam ekran moduna girmeyi istediğinde uygulamanın penceresini yeniden boyutlandırmayın. Bu işlem, kesintiye neden olan bir yapılandırma değişikliğini tetikler. Bunun yerine, uygulamayı büyütmek için kullanıcı kontrollü bir tam ekran düğmesi sunun.