הוספת מסך פתיחה

אם האפליקציה שלכם מיישמת מסך פתיחה בהתאמה אישית או משתמשת בעיצוב של מרכז האפליקציות, העבירו את האפליקציה לספריית SplashScreen שזמינה ב-Jetpack, כדי לוודא שהיא מוצגת בצורה תקינה בכל הגרסאות של Wear OS.

במאמר הזה מוסבר איך להוסיף מסך פתיחה באמצעות ספריית SplashScreen, כך שהמסך יעמוד בהנחיות העיצוב.

הוספת יחסי תלות

מוסיפים את התלות הבאה לקובץ build.gradle של מודול האפליקציה:

Groovy

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

Kotlin

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

כדי לקבל תמיכה במאפייני ברירת המחדל של Wear OS, צריך לוודא שאתם משתמשים בגרסה 1.0.1 ואילך.

הוסף עיצוב

יוצרים עיצוב למסך פתיחה ב-res/values/styles.xml. רכיב ההורה תלוי בצורת הסמל:

  • אם הסמל עגול, משתמשים ב-Theme.SplashScreen.
  • אם הסמל הוא בצורה אחרת, משתמשים ב-Theme.SplashScreen.IconBackground.

משתמשים ב-windowSplashScreenBackground כדי למלא את הרקע בצבע שחור אחד. מגדירים את הערכים של postSplashScreenTheme לנושא שבו הפעילות צריכה להשתמש, ואת הערך של windowSplashScreenAnimatedIcon ל-drawable או ל-drawable מונפש:

<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

אם משתמשים בסמל לא עגול, צריך להגדיר צבע רקע לבן מתחת לסמל. במקרה כזה, צריך להשתמש ב-Theme.SplashScreen.IconBackground כנושא הראשי ולהגדיר את מאפיין windowSplashScreenIconBackgroundColor:

<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

שאר המאפיינים הם אופציונליים.

יצירת משאב drawable לעיצוב

כדי להגדיר עיצובים למסך הפתיחה, צריך להעביר פריט גרפי שניתן להזזה למאפיין windowSplashScreenAnimatedIcon. לדוגמה, אפשר ליצור אותו על ידי הוספת קובץ חדש res/drawable/splash_screen.xml ושימוש בסמל של מרכז האפליקציות ובגודל הנכון של סמל מסך הפתיחה:

<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

גודל הסמל של מסך הפתיחה מוגדר ב-res/values/dimens.xml והוא שונה בהתאם לצורה של הסמל:

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

…או שהם לא עגולים ולכן צריך להשתמש ברקע של הסמל:

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

ציון העיצוב

בקובץ המניפסט של האפליקציה (AndroidManifest.xml), מחליפים את העיצוב של הפעילות הראשונית – בדרך כלל הפעילויות שמגדירות פריט של מרכז האפליקציות או שמיוצאות בדרך אחרת – בעיצוב שיצרתם בשלב הקודם:

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

עדכון הפעילות הראשונית

מתקינים את מסך הפתיחה בפעילות ההתחלתית לפני שמבצעים קריאה ל-super.onCreate():

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

        setContent {
            WearApp()
        }
    }
}
SplashScreenActivity.kt

מקורות מידע נוספים

מידע נוסף על מסכי פתיחה באופן כללי ועל האופן שבו אפשר להשתמש בהם באפליקציה.