Başlangıç ekranı uygulamanızı Android 12 ve sonraki bir sürüme taşıma

Android 11 veya önceki sürümlerde özel bir başlangıç ekranı uygularsanız uygulamanızı Android 12 ve sonraki sürümlerde doğru şekilde görüntülenmesini sağlamak için SplashScreen API'ye taşıyın.

Android 12'den itibaren sistem, tüm uygulamalar için baştan ve hazırda başlatma durumlarında Android sistem varsayılan açılış ekranını uygular. Bu sistem açılış ekranı varsayılan olarak uygulamanızın başlatıcı simgesi öğesi ve temanızın windowBackground (tek renkse) kullanılarak oluşturulur.

Uygulamanızı taşımazsanız Android 12 ve sonraki sürümlerde uygulama başlatma deneyiminiz bozulabilir veya istenmeyen sonuçlara yol açabilir.

  • Mevcut başlangıç ekranınız android:windowBackground değerini geçersiz kılan bir özel tema kullanılarak uygulandıysa sistem, Android 12 ve sonraki sürümlerde özel başlangıç ekranınızı varsayılan Android sistem başlangıç ekranıyla değiştirir. Bu, uygulamanızın amaçladığı deneyim olmayabilir.

  • Mevcut başlangıç ekranınız özel bir Activity kullanılarak uygulanıyorsa uygulamanızı Android 12 veya sonraki bir sürüm çalıştıran cihazlarda başlattığınızda yinelenen başlangıç ekranları gösterilir: Sistem başlangıç ekranı gösterilir, ardından mevcut başlangıç ekranı etkinliğiniz gösterilir.

Bu belgede açıklanan taşıma işlemini tamamlayarak bu düşük kaliteli veya istenmeyen deneyimleri önleyebilirsiniz. Taşıma işleminden sonra API, başlatma süresini iyileştirir, açılış ekranı deneyimi üzerinde tam kontrol sahibi olmanızı sağlar ve platformdaki diğer uygulamalarla daha tutarlı bir başlatma deneyimi oluşturur.

SplashScreen uyumlu kitaplığı

SplashScreen API'yi doğrudan kullanabilirsiniz ancak bunun yerine Androidx SplashScreen uyumluluk kitaplığını kullanmanızı önemle tavsiye ederiz. Uyumluluk kitaplığı, SplashScreen API'sini kullanır, geriye dönük uyumluluğu etkinleştirir ve tüm Android sürümlerinde açılış ekranı görüntüleme için tutarlı bir görünüm ve his oluşturur. Bu doküman, compat kitaplığı kullanılarak yazılmıştır.

Doğrudan SplashScreen API'yi kullanarak taşıma yaparsanız Android 11 ve önceki sürümlerde başlangıç ekranınız taşıma öncesiyle aynı görünür. Android 12'den itibaren başlangıç ekranı Android 12'nin görünümüne ve tarzına sahiptir.

SplashScreen uyumluluk kitaplığını kullanarak taşıma yaparsanız sistem, Android'in tüm sürümlerinde aynı açılış ekranını gösterir.

Başlangıç ekranı uygulamanızı taşıma

Mevcut açılış ekranı uygulamanızı Android 12 ve sonraki sürümlere taşımak için aşağıdaki adımları tamamlayın.

Bu işlem, hangi uygulama türünden veri taşıdığınıza bağlı olarak geçerlidir. Özel bir Activity'ten geçiş yapıyorsanız özelleştirilmiş açılış ekranınızı Activity uyarlamak için bu dokümanda açıklanan en iyi uygulamaları uygulayın. SplashScreen API, özel bir açılış ekranı etkinliğiyle sunulan başlatma gecikmesini de azaltır.

Başlangıç ekranınızı taşımak için aşağıdakileri yapın:

  1. build.gradle dosyasında compileSdkVersion değerinizi değiştirin ve SplashScreen uyumluluk kitaplığını bağımlılıklara ekleyin.

    build.gradle

android {
   compileSdkVersion 31
   ...
}
dependencies {
   ...
   implementation 'androidx.core:core-splashscreen:1.0.0-beta02'
}

  2. Theme.SplashScreen üst öğesine sahip bir tema oluşturun. postSplashScreenTheme değerini Activity'ın kullanması gereken temaya, windowSplashScreenAnimatedIcon değerini ise bir çizilebilir veya animasyonlu çizilebilir öğeye ayarlayın. Diğer özellikler isteğe bağlıdır.

    <style name="Theme.App.Starting" parent="Theme.SplashScreen">
   <!-- Set the splash screen background, animated icon, and animation
   duration. -->
   <item name="windowSplashScreenBackground">@color/...</item>

   <!-- Use windowSplashScreenAnimatedIcon to add a drawable or an animated
        drawable. One of these is required. -->
   <item name="windowSplashScreenAnimatedIcon">@drawable/...</item>
   <!-- Required for animated icons. -->
   <item name="windowSplashScreenAnimationDuration">200</item>

   <!-- Set the theme of the Activity that directly follows your splash
   screen. This is required. -->
   <item name="postSplashScreenTheme">@style/Theme.App</item>
</style>

    Simgenizin altına arka plan rengi eklemek istiyorsanız Theme.SplashScreen.IconBackground temasını kullanabilir ve windowSplashScreenIconBackground özelliğini ayarlayabilirsiniz.

  3. Manifestte, başlangıç etkinliğinin temasını önceki adımda oluşturduğunuz temayla değiştirin.

    <manifest>
   <application android:theme="@style/Theme.App.Starting">
    <!-- or -->
        <activity android:theme="@style/Theme.App.Starting">
...

  4. super.onCreate()'u aramadan önce başlangıç etkinliğinde installSplashScreen'ü arayın.

    Kotlin

    class MainActivity : Activity() {

   override fun onCreate(savedInstanceState: Bundle?) {
       // Handle the splash screen transition.
       val splashScreen = installSplashScreen()

       super.onCreate(savedInstanceState)
       setContentView(R.layout.main_activity)
...

    Java

    public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
         // Handle the splash screen transition.
         SplashScreen splashScreen = SplashScreen.installSplashScreen(this);

         super.onCreate(savedInstanceState);
         setContentView(R.layout.main_activity);
    }
}

installSplashScreen, başlangıç ekranı nesnesini döndürür. Bu nesneyi isteğe bağlı olarak animasyonu özelleştirmek veya başlangıç ekranını ekranda daha uzun süre tutmak için kullanabilirsiniz. Animasyonu özelleştirme hakkında daha fazla bilgi için Başlangıç ekranını daha uzun süre ekranda tutma ve Başlangıç ekranını kapatma animasyonunu özelleştirme başlıklı makaleleri inceleyin.

Özel başlangıç ekranı etkinliğinizi başlangıç ekranına uyarlama

Android 12 ve sonraki sürümler için başlangıç ekranına geçtikten sonra önceki özel başlangıç ekranınızla Activity ne yapacağınıza karar verin. Şu seçeneklerden birini tercih edebilirsiniz:

  • Özel etkinliği saklayın ancak gösterilmesini engelleyin.
  • Marka bilinirliği için özel etkinliği saklayın.
  • Özel etkinliği kaldırın ve uygulamanızı gerektiği gibi uyarlayın.

Özel etkinliğin gösterilmesini engelleme

Önceki açılış ekranınız Activity öncelikle yönlendirme için kullanılıyorsa kaldırmanın yollarını düşünün. Örneğin, doğrudan gerçek etkinliğe bağlantı verebilir veya alt bileşenleri olan tek bir etkinliğe geçebilirsiniz. Bu mümkün değilse yönlendirme etkinliğini yerinde tutmak ancak oluşturmasını durdurmak için SplashScreen.setKeepOnScreenCondition kullanabilirsiniz. Bu işlem, başlangıç ekranını bir sonraki etkinliğe aktarır ve sorunsuz bir geçiş sağlar.

Kotlin

  class RoutingActivity : Activity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        val splashScreen = installSplashScreen()
        super.onCreate(savedInstanceState)

        // Keep the splash screen visible for this Activity.
        splashScreen.setKeepOnScreenCondition { true }
        startSomeNextActivity()
        finish()
     }
   ...

Java

  public class RoutingActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
      SplashScreen splashScreen = SplashScreen.installSplashScreen(this);

       super.onCreate(savedInstanceState);

       // Keep the splash screen visible for this Activity.
       splashScreen.setKeepOnScreenCondition(() -> true );
       startSomeNextActivity();
       finish();
    }
  ...

Marka bilinci oluşturma için özel etkinliği tutma

Marka bilinirliği nedeniyle önceki bir başlangıç ekranını Activity kullanmak istiyorsanız başlangıç ekranını kapatma animasyonunu özelleştirerek sistem başlangıç ekranından özel başlangıç ekranınıza Activity geçebilirsiniz. Ancak mümkünse bu senaryoyu önlemek ve başlangıç ekranınızı markalamak için SplashScreen API'yi kullanmak en iyisidir.

İletişim göstermeniz gerekiyorsa bunu sonraki özel başlangıç ekranı etkinliğinin veya sistem başlangıç ekranından sonraki ana etkinliğin üzerinde göstermenizi öneririz.

Özel açılış ekranı etkinliğini kaldırın

Genel olarak, açılış ekranlarının kopyalanmasını önlemek, verimliliği artırmak ve açılış ekranı yükleme sürelerini azaltmak için önceki özel açılış ekranınızı Activitytamamen kaldırmanızı öneririz. Gereksiz açılış ekranı etkinliklerini göstermemek için kullanabileceğiniz farklı teknikler vardır.

  • Bileşenleriniz, modülleriniz veya kitaplıklarınız için yavaş yüklemeyi kullanın. Uygulamanın ilk çalıştırıldığında çalışması için gerekli olmayan bileşenleri veya kitaplıkları yüklemekten ya da ilk kullanıma hazırlamaktan kaçının. Uygulama ihtiyaç duyduğunda bunları daha sonra yükleyin.

    Uygulamanızın düzgün çalışması için gerçekten bir bileşene ihtiyacı varsa bu bileşeni yalnızca gerçekten ihtiyaç duyulduğunda yükleyin (başlatma sırasında değil) veya uygulama başladıktan sonra yüklemek için arka plan iş parçacığı kullanın. Application.onCreate() dosyanızı mümkün olduğunca küçük tutmaya çalışın.

    Uygulama başlangıcında bileşenleri başlatmak için uygulama başlatma kitaplığını da kullanabilirsiniz. Bunu yaparken, başlangıç etkinliği için gerekli tüm modülleri yüklemeye devam ettiğinizden ve yavaşça yüklenen modüllerin kullanıma sunulduğu yerlerde takılmalara neden olmadığından emin olun.

  • Az miktarda veri yerel olarak yüklerken yer tutucu oluşturun. Önerilen tema yaklaşımını kullanın ve uygulama hazır olana kadar oluşturma işlemini bekletin. Geriye dönük uyumlu bir açılış ekranı uygulamak için Açılış ekranını daha uzun süre ekranda tutma başlıklı makalede açıklanan adımları uygulayın.

  • Yer tutucuları gösterin. Belirsiz süreleri olan ağ tabanlı yüklemeler için açılış ekranını kapatın ve eşzamansız yükleme için yer tutucular gösterin. İçerik alanına, yükleme durumunu yansıtan ince animasyonlar ekleyebilirsiniz. İçerik yüklendiğinde sorunsuz bir geçiş sağlamak için yüklenen içerik yapısının iskelet yapısıyla olabildiğince eşleştiğinden emin olun.

  • Önbelleğe alma özelliğini kullanın. Kullanıcılar uygulamanızı ilk kez açtığında, aşağıdaki şekilde gösterildiği gibi bazı kullanıcı arayüzü öğelerinin yükleme göstergelerini gösterebilirsiniz. Kullanıcı uygulamanıza tekrar geldiğinde, daha güncel içerikleri yüklerken bu önbelleğe alınmış içeriği gösterebilirsiniz.

Şekil 1. Kullanıcı arayüzü yer tutucularını gösterme.