新增啟動畫面

關鍵字：splashscreen

如果您的應用程式實作自訂啟動畫面，或使用啟動器主題，請將應用程式遷移至 Jetpack 中提供的 SplashScreen 程式庫，以確保應用程式能在所有 Wear OS 版本上正確顯示。

請參閱本頁的逐步實作說明，瞭解如何使用 SplashScreen 程式庫新增啟動畫面，讓畫面能夠符合設計規範。

新增依附元件

請在應用程式模組的 build.gradle 檔案中新增以下依附元件：

Groovy

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

Kotlin

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

請務必使用 1.0.1 以上版本，以取得預設的 Wear OS 尺寸相關支援。

新增主題

請在 res/values/styles.xml 中建立啟動畫面主題。圖示形狀會影響您要使用何種父項元素：

  • 如果圖示為圓形，請使用 Theme.SplashScreen。
  • 如果圖示為其他形狀，請使用 Theme.SplashScreen.IconBackground。

您可以使用 windowSplashScreenBackground 將背景填滿單一黑色。請將 postSplashScreenTheme 的值設為 Activity 應使用的主題，並將 windowSplashScreenAnimatedIcon 的值設為可繪項目或可繪的動畫項目：

<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>

如果使用非圓形圖示，則需在圖示背後設定白色的背景顏色。在這種情況下，請使用 Theme.SplashScreen.IconBackground 做為父項主題，並設定 windowSplashScreenIconBackgroundColor 屬性：

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

其他屬性為選用屬性。

為主題建立可繪項目

啟動畫面主題需要用到一個會傳入 windowSplashScreenAnimatedIcon 屬性中的可繪項目。舉例來說，您可以新增檔案 res/drawable/splash_screen.xml，並使用應用程式啟動器圖示，以及正確的啟動畫面圖示大小，來建立這個可繪項目：

<?xml version="1.0" encoding="utf-8"?>
<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>

啟動畫面圖示大小定義於 res/values/dimens.xml 中，且因圖示是否為圓形而異：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- Round app icon can take all of default space -->
    <dimen name="splash_screen_icon_size">48dp</dimen>
</resources>

若不是圓形，則須使用圖示背景：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- Non-round icon with background must use reduced size to fit circle -->
    <dimen name="splash_screen_icon_size">36dp</dimen>
</resources>

指定主題

請在應用程式的資訊清單檔案 (AndroidManifest.xml) 中，將起始活動的主題 (通常是定義啟動器項目或以其他方式匯出的主題) 替換成您在上一個步驟中建立的主題。

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

更新起始活動

請先在啟動活動中安裝啟動畫面，然後再呼叫 super.onCreate()：

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        // Handle the splash screen transition.
        installSplashScreen()

        super.onCreate(savedInstanceState)
        setContent {
            WearApp("Wear OS app")
        }
    }
}

其他資源

請點選這個連結，瞭解更多有關啟動畫面的一般概念，以及在應用程式中使用這類畫面的方法。