目录

如何设置应用的启动图为全屏图片

问题现象

如何做到startWindowIcon设置的图片和闪屏页面使用的是同一张,现在startWindowIcon设置的图片尺寸明显超过闪屏页面所需尺寸。

背景知识

解决方案

startWindowIcon的大小跟随图源尺寸,一般推荐放一个icon小图。startWindowIcon启动图全屏居中,按图片像素大小居中显示。

常见FAQ

Q:自定义启动页跳转后是否还能返回。

A:router模块提供了两种跳转模式,分别是router.pushUrl和router.replaceUrl。router.pushUrl:目标页面不会替换当前页,而是压入页面栈。这样可以保留当前页的状态,并且可通过返回键或router.back方法返回到当前页。router.replaceUrl:目标页面会替换当前页,并销毁当前页。这样可以释放当前页的资源,并且无法返回到当前页,可以把router.pushUrl替换为router.replaceUrl实现。

Q:启动图片没有占满全屏。

A:给需要全屏显示的Image组件设置expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM])来扩展组件的安全区域。

Q:使用配置增强启动页,配置了startWindow不生效,还是startWindowIcon在生效。

A:配置增强启动页需确保配置文件(如start_window.json)中正确设置或文件路径无误。请确保startWindow字段正确指向了一个有效的json配置文件,并且该文件中包含了正确的启动页配置,另外,查看启动页的分类和实现方式可以发现,是从API version 19开始支持startWindow字段。

Q:startWindowIcon启动图可以自适应吗?

A:目前startWindowIcon启动图是按图片实际像素大小居中显示的,如果要实现资源文件适配不同类型设备,不同分辨率,不同场景,可以根据设备一个或多个不同特征,创建限定词目录文件,在文件中存放适合场景的资源文件,可以参考限定词目录与设备状态的匹配规则、创建资源目录和资源文件。

Q:配置了startWindow增强启动页同时在onWindowStageCreate又设置了相同的启动页(即方案二方案三同时使用),应用启动页出现闪屏现象。

A:startWindow配置增强启动页和onWindowStageCreate设置启动页两者互相独立且发生在不同的阶段,在两者过渡的时候可能会造成闪屏的现象,建议只配置其中之一。

Q:启动页的显示区域是否可以自己设置?

A:图标/插画资源区域和品牌标识资源区域不支持三方应用设置,该区域由系统侧计算。

Q:应用设置全屏启动图后,在启动时出现闪屏现象。

A:startWindow配置增强启动页和onWindowStageCreate设置启动页两者互相独立且发生在不同的阶段,在两者过渡的时候可能会造成闪屏的现象,建议只配置其中之一。

Q:增强启动页startWindowIllustration和startWindowBrandingImage的布局规则是什么?

A:规则如下: