SuperAPI AI 工具集

capacitor-splash-screen

编程与开发

查看项目

更新于 10-15 17:31

技能介绍

用途:配置、生成与调试 Capacitor 应用的启动闪屏(splash)与图标资源,解决闪屏不消失、过早消失、白屏/黑屏闪烁、Android 12+ 显示小图标、iOS 8.5+ 黑屏等问题。不适用于状态栏样式、uiscene 迁移、性能优化和商店图标要求。

安装与生成:npm install @capacitor/splash-screen && npx cap sync。资源放入 assets/(icon-only.png、icon-foreground.png、icon-background.png、splash.png、splash-dark.png;splash 不低于 2732x2732,图标不低于 1024x1024),然后 npm install -D @capacitor/assets && npx capacitor-assets generate(可用 --ios、--android、--pwa 限定范围)。Logo 保持在中心约 1/3 内,避免 Android 12+ 圆形遮罩裁剪。

主要能力:通过 capacitor.config.* 的 plugins.SplashScreen 配置 launchAutoHide、launchFadeOutDuration、backgroundColor;在首屏渲染后调用 await SplashScreen.hide()(可传 fadeOutDuration)。建议 launchAutoHide: false,并加超时兜底 setTimeout(() => SplashScreen.hide(), 8000) 防止 JS 崩溃卡住。

关键限制与版本:Android 12+ 由系统绘制启动闪屏,多数 androidScaleType、showSpinner、useDialog 等选项仅影响 show() 与 12 以下设备。Capacitor 9 中 Android launchFadeOutDuration 默认由 200 改为 0;8.5 iOS 由 SceneDelegate 创建窗口,Main.storyboard 不再提供根视图,但 Info.plist 的 UILaunchStoryboardName 仍须保留。

验证与排错:npx cap sync 后做干净原生构建,删除并重装应用,在 iOS 明暗模式、Android 12+、Android 11 及以下冷启动验证。常见修复包括设置 launchFadeOutDuration: 200 恢复淡出、恢复 androidx.core:core-splashscreen 依赖、确认 drawable 名称存在、iOS 删除应用重启后重装以清除启动屏缓存。

官方资源:https://capacitorjs.com/docs/apis/splash-screen、https://capacitorjs.com/docs/guides/splash-screens-and-icons、https://capacitorjs.com/docs/updating/9-0、https://developer.android.com/develop/ui/views/launch/splash-screen。