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属性进行适配，参考 https://docs.taro.zone/docs/quick-app 。
- 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和快应用的配置对比啦。
参考链接：