taro-quickapp-manifest
Taro和快应用配置差异
如果希望自己现在写的Taro程序日后能更平滑的转换到快应用,在十大厂商的多个入口(搜索、语音、浏览器、负一屏)快速上线,就需要了解Taro和快应用的配置差异,由于Taro是立足于微信小程序的开发框架,因此只需要比较微信小程序和快应用的官方文档即可了解差异,以生态更完善的微信小程序为基础整理出如下表格:
微信小程序属性 | 类型 | 必填 | 描述 | 对应快应用属性 |
---|---|---|---|---|
pages | string[] | 是 | 页面路径列表 | router.pages |
window | Object | 否 | 全局的默认窗口表现 | display |
tabBar | Object | 否 | 底部 tab 栏的表现 | 无 |
networkTimeout | Object | 否 | 网络超时时间 | 无 |
functionalPages | boolean | 否 | 是否启用插件功能页,默认关闭 | 无 |
subpackages | Object[] | 否 | 分包结构配置 | subpackages |
workers | string | 否 | Worker 代码放置的目录 | 无 |
requiredBackgroundModes | string[] | 否 | 需要在后台使用的能力,如「音乐播放」 | features |
plugins | Object | 否 | 使用到的插件 | 无 |
preloadRule | Object | 否 | 分包预下载规则 | 无 |
resizable | boolean | 否 | iPad 小程序是否支持屏幕旋转,默认关闭 | 无 |
navigateToMiniProgramAppIdList | string[] | 否 | 需要跳转的小程序列表,详见 wx.navigateToMiniProgram | 无 |
usingComponents | Object | 否 | 全局自定义组件配置 | 无 |
permission | Object | 否 | 小程序接口权限相关设置 | 无 |
sitemapLocation | String | 是 | 指明 sitemap.json 的位置 | 无 |
style | String | 否 | 指定使用升级后的weui样式 | 无 |
以上是全局配置的差异,从表中可以看到微信小程序有非常多的定制属性,比如tabBar\plugins\sitemapLocation等,当然快应用也有很多定制属性,如下表加粗所示:
属性 | 类型 | 默认值 | 必填 | 描述 |
---|---|---|---|---|
package | String | - | 是 | 应用包名,确认与原生应用的包名不一致,推荐采用 com.company.module 的格式,如:com.example.demo |
name | String | - | 是 | 应用名称,6 个汉字以内,与应用商店保存的名称一致,用于在桌面图标、弹窗等处显示应用名称 |
icon | String | - | 是 | 应用图标,提供 192x192 大小的即可 |
versionName | String | - | 否 | 应用版本名称,如:`"1.0"` |
versionCode | Integer | - | 是 | 应用版本号,从1 自增,推荐每次重新上传包时versionCode+1** |
minPlatformVersion | Integer | - | 否 | 支持的最小平台版本号,兼容性检查,避免上线后在低版本平台运行并导致不兼容;如果不填按照内测版本处理 |
features | Array | - | 否 | 接口列表,绝大部分接口都需要在这里声明,否则不能调用,详见每个接口的文档说明 |
config | Object | - | 是 | 系统配置信息 |
router | Object | - | 是 | 路由信息 |
display | Object | - | 否 | UI 显示相关配置 |
subpackages 1040+ | Object | - | 否 | 定义并启用分包加载 |
微信小程序还支持每个页面定制自己的页面配置json(大部分属性继承自window),而快应用的页面配置则统一由display.pages管理,从宏观上可以看到两类轻应用的配置差别,微观上我们也来分析一下:
- pages VS router.pages
微信的pages只是一个路径字符串数组,没有额外的信息,而快应用的pages有很多细腻的属性,比如filter属性,声明该属性之后,页面中可以使用$page获取打开页面的参数,还有launchMode可以指定启动模式,Taro为了兼容这一差异,使用customPageConfig属性进行适配,参考文档 。
- window VS display
微信小程序属性 | 描述 | 快应用属性 |
---|---|---|
navigationBarBackgroundColor | 导航栏背景颜色,如 #000000 | titleBarBackgroundColor |
navigationBarTextStyle | 导航栏标题颜色,仅支持 black / white | titleBarTextColor |
navigationBarTitleText | 导航栏标题文字内容 | titleBarText |
navigationStyle | 导航栏样式,仅支持以下值: default 默认样式 custom 自定义导航栏,只保留右上角胶囊按钮。参见注 2。 | 无 |
backgroundColor | 窗口的背景色 | backgroundColor |
backgroundTextStyle | 下拉 loading 的样式,仅支持 dark / light | 无 |
backgroundColorTop | 顶部窗口的背景色,仅 iOS 支持 | 无 |
backgroundColorBottom | 底部窗口的背景色,仅 iOS 支持 | 无 |
enablePullDownRefresh | 是否开启全局的下拉刷新。 详见 Page.onPullDownRefresh | 无 |
onReachBottomDistance | 页面上拉触底事件触发时距页面底部距离,单位为 px。 详见 Page.onReachBottom | 无 |
pageOrientation | 屏幕旋转设置,支持 auto / portrait / landscape 详见 响应显示区域变化 | orientation |
微信小程序对背景和导航栏的样式配置更加细腻,快应用则新增了对沉浸式状态栏的管理。
属性 | 类型 | 默认值 | 描述 |
---|---|---|---|
statusBarImmersive 1050+ | Boolean | false | 是否显示沉浸式状态栏 |
statusBarTextStyle 1050+ | light | dark | auto | auto | 状态栏文字样式,有亮,暗和自动 当为自动时会根据状态栏背景色调整 |
statusBarBackgroundColor 1050+ | String | - | 状态栏背景色,默认值同标题栏背景色 |
statusBarBackgroundOpacity 1050+ | float(0-1.0) | false | 状态栏背景色不透明度,默认值同标题栏背景色不透明度 |
至于啥是沉浸式状态栏,参考经验
subPackages VS subPackages
既然是轻应用自然少不了分包机制,微信的subPackages 支持root\name\pages\independent字段,当independent字段为true时为独立分包,此时可以不需下载主包即可运行,否则为普通分包,当用户进入普通分包或主包内页面时,主包会被下载,快应用则支持name\resource字段,resource就是包名,运行时,快应用将优先加载基础包和页面所在分包,其余分包会自动在后台进行预加载。
以上就是Taro和快应用的配置对比啦。
参考链接: