如何为Wear OS 3应用制作与主流应用一致的启动屏效果

适配基础说明 #

Wear OS 3 已完整适配 Android 12 引入的原生 SplashScreen 机制，你在 Spotify、Strava 等应用上看到的「图标从应用抽屉位置向屏幕中央移动」的动效完全由系统自动生成，不需要自定义绘制动效。

现有测试方式问题 #

你当前在 onCreate 中调用 Thread.sleep 的测试方式不可用：该方法会阻塞主线程，系统启动屏的渲染逻辑依赖主线程调度，阻塞后会导致启动屏无法正常绘制，仅显示黑屏。

正确的冷启动延迟测试方法：

• 不要阻塞主线程，通过主线程 Handler post 延迟任务模拟启动耗时，延迟结束后再加载主视图，示例代码如下：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 模拟2秒的资源初始化/业务加载耗时
    Handler(Looper.getMainLooper()).postDelayed({
        setContentView(R.layout.activity_main)
        // 其余应用初始化逻辑
    }, 2000)
}

• 测试时必须采用冷启动路径：先将应用从后台栈完全清除，再从应用抽屉点击图标启动，不要直接通过 Android Studio 点击运行测试，热启动不会触发完整的启动屏动效。

原生启动屏实现步骤 #

仅需简单配置即可触发系统原生启动屏效果：

1. 引入依赖（如果你的项目 compileSdk >= 31 可直接使用系统API，跳过此步）
   implementation "androidx.core:core-splashscreen:1.0.1"
2. 在应用主题中配置启动屏属性

<!-- 项目res/values/styles.xml 中的应用主题节点下添加以下配置 -->
<item name="android:windowSplashScreenBackground">@android:color/black</item>
<item name="android:windowSplashScreenAnimatedIcon">@mipmap/ic_launcher</item>
<!-- 兼容低版本系统的配置项 -->
<item name="windowSplashScreenBackground">@android:color/black</item>
<item name="windowSplashScreenAnimatedIcon">@mipmap/ic_launcher</item>

3. 在启动页 Activity 的 onCreate 方法中初始化启动屏

override fun onCreate(savedInstanceState: Bundle?) {
    // 需在super.onCreate调用前执行初始化
    installSplashScreen()
    super.onCreate(savedInstanceState)
    // 其余逻辑
}

异常排查 #

如果配置后仍无法显示预期动效，检查以下配置：

• 项目的 compileSdk 和 targetSdk 至少设置为 31
• 不要在应用主题中添加 android:windowDisablePreview 属性，该属性会禁用系统启动预览
• 应用图标建议使用规范的自适应图标，动效显示更完整

内容的提问来源于stack exchange，提问作者user3697030