Koyu tema uygulama

Oluşturma yöntemini deneyin
Android için önerilen kullanıcı arayüzü araç seti Jetpack Compose'dur. Oluşturma'da temalarla nasıl çalışacağınızı öğrenin.
Renk Şeması - Materyal Tasarım 3 →

Şekil 1. Koyu tema.

Koyu tema, Android 10 (API düzeyi 29) ve sonraki sürümlerde kullanılabilir. Bu yöntemin şu avantajları vardır:

  • Cihazın ekran teknolojisine bağlı olarak güç tüketimini önemli ölçüde azaltır.
  • Az gören ve parlak ışığa duyarlı kullanıcılar için görünürlüğü iyileştirir.
  • Cihazın az ışıklı ortamlarda kullanılmasını kolaylaştırır.

Koyu tema, Android sistem kullanıcı arayüzü ve cihazda çalışan uygulamalar için geçerlidir.

Android 10 ve sonraki sürümlerde koyu temayı etkinleştirmenin üç yolu vardır:

  • Koyu temayı etkinleştirmek için Ayarlar > Ekran > Tema'ya giderek sistem ayarını kullanın.
  • Etkinleştirildiğinde, bildirim tepsisinden tema değiştirmek için Hızlı Ayarlar kartını kullanın.
  • Pixel cihazlarda koyu temayı da etkinleştirmek için Pil Tasarrufu modunu etkinleştirin. Diğer cihazlar bu davranışı desteklemeyebilir.

Web Görünümü bileşeni kullanarak web tabanlı içeriğe koyu tema uygulamayla ilgili talimatlar için WebView'de web içeriğini koyulaştırma başlıklı makaleyi inceleyin.

Uygulamanızda koyu temayı destekleme

Koyu temayı desteklemek için uygulamanızın temasını (genellikle res/values/styles.xml içinde bulunur) bir DayNight temasından devralacak şekilde ayarlayın:

<style name="AppTheme" parent="Theme.AppCompat.DayNight">

Material Components koyu temasını da kullanabilirsiniz:

<style name="AppTheme" parent="Theme.MaterialComponents.DayNight">

Bu, uygulamanın ana temasını sistem kontrollü gece modu işaretleriyle ilişkilendirir ve etkinleştirildiğinde uygulamaya varsayılan koyu tema verir.

Temalar ve stiller

Açık temada kullanılmak üzere kodlanmış renkleri veya simgeleri kullanmaktan kaçının. Bunun yerine tema özelliklerini veya geceye uygun kaynakları kullanın.

Koyu tema için en önemli iki tema özelliği şunlardır:

  • ?android:attr/textColorPrimary: Genel amaçlı bir metin rengi. Açık temada neredeyse siyah, koyu temalarda ise neredeyse beyazdır. Devre dışı bir durum içerir.
  • ?attr/colorControlNormal: Genel amaçlı simge rengi. Devre dışı bir durum içerir.

Tema özellikleri ?attr/colorSurface ve ?attr/colorOnSurface gibi renk temalandırma sistemi, uygun renklere kolay erişim sağladığından Material Design Bileşenleri'ni kullanmanızı öneririz. Bu özellikleri temanızda özelleştirebilirsiniz.

Uygulama içinde temaları değiştirme

Kullanıcıların uygulama çalışırken temasını değiştirmelerine izin verebilirsiniz. Önerilen seçenekler şunlardır:

  • Hafif
  • Kasvetli
  • Sistem varsayılanı (önerilen varsayılan seçenek)

Bu seçenekler doğrudan AppCompat.DayNight modlarıyla eşlenir:

Temayı değiştirmek için aşağıdakileri yapın:

Zorunlu koyu mod

Android 10, geliştiricilerin DayNight temasını açıkça ayarlamaksızın koyu temayı hızlı bir şekilde uygulamalarını sağlayan Koyu Temayı Zorunlu Kılma özelliğini sunar.

Koyu Modu Zorunlu Kılma, açık temalı uygulamanızın her görünümünü analiz eder ve ekrana çizilmeden önce otomatik olarak koyu tema uygular. Koyu temayı uygulamak için gereken süreyi kısaltmak amacıyla koyu temayı zorlama ve yerel uygulamayı birlikte kullanabilirsiniz.

Uygulamalar, etkinliğin temasında android:forceDarkAllowed="true" ayarlayarak Koyu'yu Zorla etkinleştirmelidir. Bu özellik, sistem ve AndroidX tarafından sağlanan tüm açık temalarda (ör. Theme.Material.Light) ayarlanır. Koyu Modu Zorunlu Tut'u kullandığınızda uygulamanızı kapsamlı bir şekilde test edin ve gerektiğinde görünümleri hariç tutun.

Uygulamanız koyu tema (ör. Theme.Material) kullanıyorsa Koyu Temayı Zorla seçeneği uygulanmaz. Benzer şekilde, uygulamanızın teması bir DayNight temasından devralındıysa otomatik tema geçişi nedeniyle Koyu'yu Zorunlu Tut özelliği uygulanmaz.

Bir görünümde koyu modu zorlamayı devre dışı bırakma

Zorunlu karanlık modu, belirli görünümlerde android:forceDarkAllowed düzen özelliği veya setForceDarkAllowed() ile kontrol edilebilir.

Web içeriği

Web tabanlı içeriklerde koyu temaları kullanma hakkında bilgi edinmek için WebView'de web içeriğini koyulaştırma başlıklı makaleyi inceleyin. WebView'e uygulanmış koyu tema örneği için GitHub'daki WebView demosuna göz atın.

En iyi uygulamalar

Aşağıdaki bölümlerde, koyu temaları uygulamayla ilgili en iyi uygulamalar sunulmaktadır.

Bildirimler ve widget'lar

Cihazınızda görüntülediğiniz ancak doğrudan kontrol etmediğiniz kullanıcı arayüzü yüzeylerinde, kullandığınız görünümlerin ana uygulamanın temasını yansıttığından emin olun. Bildirimler ve başlatıcı widget'ları buna örnek gösterilebilir.

Bildirimler

Sistem tarafından sağlanan bildirim şablonlarını (ör. MessagingStyle) kullanın. Bu, doğru görüntü stilini uygulamanın sistemden sorumlu olduğu anlamına gelir.

Widget'lar ve özel bildirim görünümleri

Başlatıcı widget'ları için veya uygulamanız özel bildirim içeriği görünümleri kullanıyorsa içeriği hem açık hem de koyu temalarda test edin.

Dikkat edilmesi gereken yaygın hatalar şunlardır:

  • Arka plan renginin her zaman açık renk olduğu varsayılır.
  • Metin renklerini sabit kodlama
  • Varsayılan metin rengini kullanırken kodla yazılmış bir arka plan rengi ayarlama.
  • Statik renkte bir çizilebilir simge kullanılması

Tüm bu durumlarda, kodlanmış renkler yerine uygun tema özelliklerini kullanın.

Lansman ekranları

Uygulamanızda özel bir başlatma ekranı varsa bunu, seçilen temayı yansıtacak şekilde değiştirmeniz gerekebilir.

Programlı olarak beyaza ayarlanmış arka plan renkleri gibi kodlanmış tüm renkleri kaldırın. Bunun yerine ?android:attr/colorBackground tema özelliğini kullanın.

Yapılandırma değişiklikleri

Uygulamanın teması, sistem ayarı veya AppCompat aracılığıyla değiştiğinde uiMode yapılandırma değişikliği tetiklenir. Bu durumda etkinlikler otomatik olarak yeniden oluşturulur.

Bazı durumlarda, yapılandırma değişikliğini bir uygulamanın yapmasını isteyebilirsiniz. Örneğin, bir video oynatıldığı için yapılandırma değişikliğini ertelemek isteyebilirsiniz.

Bir uygulama, her Activity'ün uiMode yapılandırma değişikliğini işleyebileceğini bildirerek koyu temanın uygulanmasını yönetebilir:

<activity
    android:name=".MyActivity"
    android:configChanges="uiMode" />

Bir Activity, yapılandırma değişikliklerini işlediğini beyan ettiğinde tema değişikliği olduğunda onConfigurationChanged() yöntemi çağrılır.

Uygulamalar, mevcut temayı kontrol etmek için aşağıdaki gibi bir kod çalıştırabilir:

Kotlin

val currentNightMode = configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK
when (currentNightMode) {
    Configuration.UI_MODE_NIGHT_NO -> {} // Night mode is not active, we're using the light theme.
    Configuration.UI_MODE_NIGHT_YES -> {} // Night mode is active, we're using dark theme.
}

Java

int currentNightMode = configuration.uiMode & Configuration.UI_MODE_NIGHT_MASK;
switch (currentNightMode) {
    case Configuration.UI_MODE_NIGHT_NO:
        // Night mode is not active, we're using the light theme
        break;
    case Configuration.UI_MODE_NIGHT_YES:
        // Night mode is active, we're using dark theme
        break;
}