Başlangıç ekranı ekle

Uygulamanızda özel bir başlangıç ekranı uygulanıyorsa veya başlatıcı teması kullanılıyorsa tüm Wear OS sürümlerinde doğru şekilde gösterilmesi için uygulamanızı Jetpack'te bulunan SplashScreen kitaplığına taşıyın.

SplashScreen kitaplığını kullanarak ekranın tasarım kurallarına uygun şekilde açılış ekranı eklemeyi öğrenmek için bu sayfadaki adım adım uygulama talimatlarını inceleyin.

Bağımlılık ekleme

Aşağıdaki bağımlılığı uygulama modülünüzün build.gradle dosyasına ekleyin:

dependencies {
    implementation "androidx.core:core-splashscreen:1.2.0"
}

dependencies {
    implementation("androidx.core:core-splashscreen:1.2.0")
}

Varsayılan Wear OS boyutları için destek almak istiyorsanız 1.0.1 veya sonraki bir sürümü kullandığınızdan emin olun.

Tema ekleme

res/values/styles.xml içinde başlangıç ekranı teması oluşturun. Üst öğe, simgenin şekline bağlıdır:

• Simge yuvarlaksa Theme.SplashScreen simgesini kullanın.
• Simge farklı bir şekle sahipse Theme.SplashScreen.IconBackground simgesini kullanın.

Arka planı tek bir siyah renkle doldurmak için windowSplashScreenBackground simgesini kullanın. postSplashScreenTheme değerlerini Activity'nin kullanması gereken temaya, windowSplashScreenAnimatedIcon değerlerini ise çizilebilir veya animasyonlu çizilebilir öğeye ayarlayın:

<resources>
    <style name="Theme.App" parent="@android:style/Theme.DeviceDefault" />

    <style name="Theme.App.Starting" parent="Theme.SplashScreen">
        <!-- Set the splash screen background to black -->
        <item name="windowSplashScreenBackground">@android:color/black</item>
        <!-- Use windowSplashScreenAnimatedIcon to add a drawable or an animated
             drawable. -->
        <item name="windowSplashScreenAnimatedIcon">@drawable/splash_screen</item>
        <!-- Set the theme of the Activity that follows your splash screen. -->
        <item name="postSplashScreenTheme">@style/Theme.App</item>
    </style>
</resources>
styles.xml

Yuvarlak olmayan bir simge kullanıyorsanız simgenizin altında beyaz bir arka plan rengi ayarlamanız gerekir. Bu durumda, Theme.SplashScreen.IconBackground özelliğini üst tema olarak kullanın ve windowSplashScreenIconBackgroundColor özelliğini ayarlayın:

<style name="Theme.App.Starting" parent="Theme.SplashScreen">
    <!-- Set a white background behind the splash screen icon. -->
    <item name="windowSplashScreenIconBackgroundColor">@android:color/white</item>
</style>
styles.xml

Diğer özellikler isteğe bağlıdır.

Tema için çizilebilir öğe oluşturma

Açılış ekranı temaları için windowSplashScreenAnimatedIcon özelliğine aktarılacak bir çizilebilir öğe gerekir. Örneğin, yeni bir dosya res/drawable/splash_screen.xml ekleyerek ve uygulama başlatıcı simgesini kullanarak oluşturabilirsiniz. Doğru açılış ekranı simge boyutu:

<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:width="@dimen/splash_screen_icon_size"
        android:height="@dimen/splash_screen_icon_size"
        android:drawable="@mipmap/ic_launcher"
        android:gravity="center" />
</layer-list>
splash_screen.xml

Açılış ekranı simge boyutu res/values/dimens.xml içinde tanımlanır ve simgenin yuvarlak olup olmamasına bağlı olarak değişir:

<resources>
    <!-- Round app icon can take all of default space -->
    <dimen name="splash_screen_icon_size">48dp</dimen>
</resources>
dimens.xml

...veya yuvarlak olmayan ve bu nedenle simge arka planını kullanması gerekenler:

<resources>
    <!-- Non-round icon with background must use reduced size to fit circle -->
    <dimen name="splash_screen_icon_size">36dp</dimen>
</resources>
dimens.xml

Temayı belirtin

Uygulamanızın manifest dosyasında (AndroidManifest.xml), başlangıç etkinliğinin temasını (genellikle başlatıcı öğesini tanımlayan veya başka bir şekilde dışa aktarılan) önceki adımda oluşturduğunuz temayla değiştirin:

<activity
    android:name=".snippets.SplashScreenActivity"
    android:exported="true"
    android:taskAffinity=""
    android:theme="@style/Theme.App.Starting">
    <!-- ... -->
</activity>
AndroidManifest.xml

Başlangıç etkinliğinizi güncelleme

super.onCreate() işlevini çağırmadan önce başlangıç etkinliğine başlangıç ekranınızı yükleyin:

class SplashScreenActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        installSplashScreen()
        super.onCreate(savedInstanceState)

        setContent {
            WearApp()
        }
    }
}
SplashScreenActivity.kt

Ek kaynaklar

Genel olarak başlangıç ekranları ve bunları uygulamanızda nasıl kullanabileceğiniz hakkında daha fazla bilgi edinin.