tmui-cli 2.0.3 → 2.0.5

package/data/uniappx/sample.md

@@ -0,0 +1,157 @@
+# 源码和示例
+
+官方有6个开源项目比较重要
+- [hello uni-app x](https://gitcode.com/dcloud/hello-uni-app-x)：uni内置组件和API的使用示例，也包括一些常见但复杂的模板示例
+- [hello uts](https://gitcode.com/dcloud/hello-uts)：uts的语法和内置对象的使用示例
+- [hello uvue](https://gitcode.com/dcloud/hello-uvue)：vue语法的使用示例
+- [uni-api](https://gitcode.com/dcloud/uni-api)：uni api的实现源码。大量uts API插件源码，适合uts插件作者学习
+- [uni-component](https://gitcode.com/dcloud/uni-component)：内置组件的实现源码。uts组件插件源码，适合uts插件作者学习
+- [uni-ai-x](https://ext.dcloud.net.cn/plugin?name=uni-ai-x)：用于快速搭建 AI 聊天类应用的开源插件，适合开发者学习 AI 功能与 uni-app x 结合的开发方案
+
+这些开源项目的master分支对应着HBuilderX最新正式版，alpha分支对应着最新alpha版。
+
+关于[uni-api](https://gitcode.com/dcloud/uni-api)和[uni-component](https://gitcode.com/dcloud/uni-component)，再强调说明下：
+
+uni-app x 的组件和API，大多是uts语言开发的。和开发者做的uts插件是一样的。\
+它们都符合[exi api](https://uniapp.dcloud.net.cn/api/extapi.html)规范，也就是说，把这些uni_modules复制到工程下，会替换内置API和组件的实现。
+
+所以如需修改 uni-app x 的组件和API，比如修复一些bug或添加一些功能，可以通过这种方式来实现。
+
+如果这些改动有助于其他开发者，欢迎给开源项目回提pr。
+
+在 uni-app x 的组件和API文档页面的右上角，也有每个组件和API的源码，都是链接到[uni-api](https://gitcode.com/dcloud/uni-api)和[uni-component](https://gitcode.com/dcloud/uni-component)项目。
+
+除此之外，插件市场还有众多插件，[详见](https://ext.dcloud.net.cn/?uni-appx=1)
+
+目前插件市场已经有近千款适配uni-app x的插件，不管是uts还是uvue，已有大量开发者在使用。
+
+上线的App案例：
+由于 uni-app x 没有运行时数据采集，所以DCloud并不知道哪些开发者在真实使用uni-app x。\
+希望大型开发者，能主动给本文档提交pr，贡献案例，帮助uni-app x生态发展。
+
+以下列出部分案例：
+
+- 发票匣：（蒸汽模式案例）[Android](https://sj.qq.com/appdetail/com.juxiang.fapiaoxia)、[iOS](https://apps.apple.com/cn/app/%E5%8F%91%E7%A5%A8%E5%8C%A3/id6593679748)、[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.juxiang.hfapiaoxia&channelId=SHARE&source=appshare)
+- 仪表宝典(化工资料)：（蒸汽模式案例）[Android](https://sj.qq.com/appdetail/ins.ybbd.app )、[iOS](https://apps.apple.com/us/app/absign/id6760313721 )、[鸿蒙](https://appgallery.huawei.com/app/detail?id=ins.ybbd.app )
+- e线签（天津数字认证有限公司）：[Android](https://sj.qq.com/appdetail/com.tjca.elinesign)、[iOS](https://apps.apple.com/cn/app/e%E7%BA%BF%E7%AD%BE/id6743433163)
+- Tevau 海外应用：[Google Play](https://play.google.com/store/apps/details?id=uni.UNI2317D55&hl=zh&pli=1)、[iOS](https://apps.apple.com/cn/app/tevau/id6504911110)
+- 舆情秘书专业版：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.istarshine.yqms4harmonyos)
+- 我要查快递（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.youjuda.woyaochakuaidi)
+- 账王业财（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=cn.cash360.lionhm)
+- 台球追分记分（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=zhuifen.huawei.com)
+- 学识魔方（教育）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=Huangwj.XueShiMoFang.huawei)
+- 环保计算小帮手（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.ahzx.jzssds)
+- RiceUI（组件库）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.rice.xui)
+- 手机数据库（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.xingyueldh.phonedatabase)
+- 信息安全速记助手（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.ruixiang.xxaqsjzs)
+- 都测（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.hime.dotest)
+- 典萃诗词（教育）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.ahzx.dcsc)
+- HUD抬头显示（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.szzhongke.hud_hm)
+- 大咖复刻（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.ahzx.dkfk)
+- 名人妙语通（教育）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.ahzx.mrmyt)
+- OC智联（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=cn.ocdw.app.oczl)
+- 远火（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=hm.yuanhuo.cn)
+- 月月好（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.menstrual.period)
+- 格式转换专家（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.gszh.app)
+- 数学公式导航仪（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.ahzx.sxgsdhy)
+- 海江消防：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.hjnet.app.harmons)
+- 诗律魔方（教育）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.ahzx.slmf)
+- 词林探秘（教育）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.ahzx.cltm)
+- 生态调查（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=ecological_investigation.www.gzqtai.com)
+- 注册环保工程师大全（学习）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.relations.huanbao)
+- 大张（OA）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=elan.mobile.dazhang)
+- 掌上粤剧宝（教育）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=Huangwj.ZhangShangYueJuBao.huawei)
+- ProcessOn思维导图（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.processon.app)
+- 星云办公（OA）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.xdong.cloudclient)
+- AI问邮（问答工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.isoftstone.AIStamp)
+- 友友露营（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=Huangwj.LuYingZhuShou.huawei)
+- 宝贝成长记录（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.bbczjl.huawei)
+- 粤语点读工具（教育）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=hxl.yyddgj.huawei)
+- 京唐签到（OA）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.example.sgjt_daka_jiaqin)
+- 轻松化学宝典（教育）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=Huangwj.QingSongHuaXueBaoDian.huawei)
+- 金鸣表格文字识别（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=cn.jm189.hm)
+- 小羊口袋粤语（教育）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=Huangwj.KouDaiYueYu.huawei)
+- 安全审批（OA）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.tec.approval)
+- 芯片助手ICHELPS（电商）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.ichelps.huawei)
+- 租客管家（租房）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=Huangwj.ZuKeGuanJia.com)
+- 喵大大（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=Huangwj.MiaoDaDa.huawei)
+- 厦团团（旅游）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.liuchangos.xiatuantuan)
+- 相约乒乓（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=Huangwj.XiangYuePingPang.huawei)
+- 小易CRM助手（客户管理）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=Huangwj.CRMZhuShou.huawei)
+- 花草君（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=xmshannian.huaca.huawei.com)
+- 能源帮帮记（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=Huangwj.NengYuanBangBangJi.huawei)
+- 旅途管家（出行）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.tojoy.kangbosstriph)
+- Ozon运费（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.xixisys.ozonship)
+- 露营仓库（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.luyi.weilei)
+- 图片压缩精灵（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.tpys.app)
+- 怡宁网院平台医生（平台）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.hlwxm.hlwxmMedicalCare.construction)
+- 甘肃党建（党建信息化平台）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=cn.gov.gsdj.app.hmos)
+- 清科锐华（OA）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=cn.reachway.cemis.reachway.huawei)
+- 现在种什么（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.suye.xzzsm)
+- 广州公务出行（交通）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=gz.gwcx.huawei)
+- BKT智能（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.bktclub.bkthm)
+- 云医点餐（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.easyhospital.rest)
+- 应安联（应急安全服务平台）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.aky.yal.huawei)
+- IRTool（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=cn.cenz.irtool)
+- 备考注册道路工程师（教育）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.relations.daolu)
+- 街舞口袋宝（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=Huangwj.JieWuKouDaiBao.huawei)
+- 堆塔（OA）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.detaclould.huawei)
+- 黄石城发移动OA：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.hcit.hscfoa)
+- 襄阳交通移动OA：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.hcit.xyjtoa)
+- 启蒙abc（教育）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.qimeng.abc)
+- 齐鲁风云（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.qlfy.weather.hm)
+- 安全审批（工具）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.tec.approval)
+- 二狗英语（教育）：[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.youjuda.ergouenglish)
+- W Life（租房）：[Android](https://appgallery.huawei.com/app/C114037237)、[iOS](https://apps.apple.com/cn/app/w-life/id6742771365?uo=4)
+- 维度新闻（黑龙江官媒）：[Android](https://sj.qq.com/appdetail/uni.UNIDB3060D)
+- Atter（AI工具）：[Android](https://sj.qq.com/appdetail/com.wbgrecordx.app)、[iOS](https://apps.apple.com/us/app/atter-ai-voice-to-text-notes/id6747348330)
+- 崇胜AI助手（工具）：[Android](https://appgallery.huawei.com/app/C110643037)、[iOS](https://apps.apple.com/bn/app/%E5%B4%87%E8%83%9Cai%E5%8A%A9%E6%89%8B-ai%E8%A7%86%E9%A2%91%E5%88%9B%E4%BD%9C%E5%B7%A5%E5%85%B7/id6479941790)
+- 知食有为（AI健康）：[Android](https://sj.qq.com/appdetail/cn.sshcn.nutrition.m)、[iOS](https://apps.apple.com/hk/app/%E7%9F%A5%E9%A3%9F%E6%9C%89%E4%B8%BA/id6739123603)
+- 智能PPT生成器（工具）：[Android](https://app.mi.com/details?id=com.pptgen.Intelligent)
+- 格式作坊（工具）：[Android](https://sj.qq.com/appdetail/com.gszf.app)、[iOS](https://apps.apple.com/cn/app/%E6%A0%BC%E5%BC%8F%E4%BD%9C%E5%9D%8A-%E6%A0%BC%E5%BC%8F%E8%BD%AC%E6%8D%A2%E5%99%A8/id6472780051)
+- 金股讯（金融）：[Android](https://sj.qq.com/appdetail/com.jinguxun.app)、[iOS](https://apps.apple.com/cn/app/%E9%87%91%E8%82%A1%E8%AE%AF/id1615272585)、[鸿蒙](https://appgallery.huawei.com/app/detail?id=com.jinguxun.happ)
+- 应安联（政务）：[Android](https://sj.qq.com/appdetail/com.aky.yal)、[iOS](https://apps.apple.com/cn/app/%E5%BA%94%E5%AE%89%E8%81%94/id1566809671)
+- 智慧强安（政务）：[Android](https://sj.qq.com/appdetail/com.demlution.aatianfangyetan)、[iOS](https://apps.apple.com/cn/app/%E6%99%BA%E6%85%A7%E5%BC%BA%E5%AE%89/id6476082028)
+- 脱单吧（社交）：[Android](https://sj.qq.com/appdetail/com.liewu.desingle)、[iOS](https://apps.apple.com/cn/app/%E8%84%B1%E5%8D%95%E5%90%A7/id1560465075)
+- 缘乐多（社交）：[Android](https://sj.qq.com/appdetail/com.adaphan.myloves)
+- 面具漂流瓶（社交）：[Android](https://appgallery.huawei.com/app/C113757831)
+- 一起超慢跑（健身）：[Android](https://sj.qq.com/appdetail/com.cloud.dema.jog)
+- 萤科物联（物联网）：[Android](https://sj.qq.com/appdetail/iot.ykwl.vip)、[iOS](https://apps.apple.com/cn/app/%E8%90%A4%E7%A7%91%E7%89%A9%E8%81%94/id6741841541)、[鸿蒙](https://appgallery.huawei.com/app/detail?id=huawei.iot.ykwl.vip&channelId=SHARE&source=appshare)
+- 牛轻松（物联网）：[Android](https://sj.qq.com/appdetail/com.wuitu.nqs)
+- 小溪相册（物联网）：[Android](https://app.mi.com/details?id=com.yanxi.xiaoxizaijia)、[iOS](https://apps.apple.com/vn/app/%E5%B0%8F%E6%BA%AA%E7%9B%B8%E5%86%8C/id6593673873)
+- 灵犀一点（物联网）：[Android](https://sj.qq.com/appdetail/uni.qinhua)、[iOS](https://apps.apple.com/cn/app/%E7%81%B5%E7%8A%80%E4%B8%80%E7%82%B9/id1661770402)
+- HDK车联网（物联网）：[Android](https://sj.qq.com/appdetail/com.hdk.app)、[iOS](https://apps.apple.com/cn/app/hdk%E8%BD%A6%E8%81%94%E7%BD%91/id6740163146)
+- 易瓜优选（电商）：[Android](https://sj.qq.com/appdetail/huaban.yigua)
+- 槟购跨境（电商）：[Android](https://sj.qq.com/appdetail/com.bingo.bg)、[iOS](https://apps.apple.com/hk/app/%E6%A7%9F%E8%B4%AD%E8%B7%A8%E5%A2%83/id1463306856)
+- 嘟卡邦（电商）：[Android](https://sj.qq.com/appdetail/com.dukabang.app)
+- 百佣（电商）：[Android](https://app.mi.com/details?id=com.baiyong.yuehu)、[iOS](https://apps.apple.com/cn/app/%E7%99%BE%E4%BD%A3/id6451459018)
+- 华杰全优采（医药电商）：[Android](https://sj.qq.com/appdetail/com.wta.NewCloudApp.jiuwei314439)、[iOS](https://apps.apple.com/cn/app/%E5%8D%8E%E6%9D%B0%E5%85%A8%E4%BC%98%E9%87%87/id1577869835)
+- 时一助手（工具）：[App端](http://app.yuteng.vip/sy/index.html)
+- 拾用视频去水印（工具）：[Android](https://sj.qq.com/appdetail/io.video.convertApp)
+- 云旅迹：[Android](https://sj.qq.com/appdetail/com.yunlvji.trip)
+- uyultax（维吾尔族多语言应用）：[Android](https://sj.qq.com/appdetail/com.android.uyultax)
+- 我爱点读（教育）：[Android](https://sj.qq.com/appdetail/com.aiduowan.diandu)
+- 天玑智研（教育）：[Android](https://sj.qq.com/appdetail/com.phadscholar)、[iOS](https://apps.apple.com/us/app/%E5%A4%A9%E7%8E%91%E6%99%BA%E7%A0%94/id6743391396)
+- 金玉良言（教育）：[Android](https://sj.qq.com/appdetail/uni.app.UNI1F8CF4F)
+- 治学课堂（教育）：[Android](https://sj.qq.com/appdetail/com.zhixuerj.zxkt)、[iOS](https://apps.apple.com/cn/app/%E6%B2%BB%E5%AD%A6%E8%AF%BE%E5%A0%82/id6737838504)
+- 课教帮（教育）：[Android](https://sj.qq.com/appdetail/com.dw.kejiaobang)
+- 同年数科（交通）：[Android](https://sj.qq.com/appdetail/kemi.io.com)
+- 汇成车队（交通）：[Android](https://sj.qq.com/appdetail/cn.dsknykj.hccd)、[iOS](https://apps.apple.com/lb/app/%E6%B1%87%E6%88%90%E8%BD%A6%E9%98%9F/id6744993779)
+- 觅数（交通）：[Android](https://sj.qq.com/appdetail/com.jspdg.mishu)
+- 亦如茶（社交）：[Android](https://sj.qq.com/appdetail/com.yiru.cha)、[iOS](https://apps.apple.com/cn/app/%E4%BA%A6%E5%A6%82%E8%8C%B6/id1544325304)
+- 桔子家（家装O2O）：[Android](https://sj.qq.com/appdetail/com.juzijia.app)
+- PowerMJ（企业管理）[Android](https://sj.qq.com/appdetail/com.power.powermj)、[iOS](https://apps.apple.com/hk/app/powermj/id6738763443)
+- 融合办公（企业管理）[Android](https://sj.qq.com/appdetail/com.gsxx.office)
+- 智沄+（酒店管理）： [Android](https://sj.qq.com/appdetail/com.zhiyun.pms)
+- 智控节能（物业管理）：[Android](https://sj.qq.com/appdetail/uni.UNIFA742E9)
+- 企财网（企服）：[Android](https://sj.qq.com/appdetail/com.dx.qicaiwang)
+- 中财企服：[Android](https://sj.qq.com/appdetail/com.zhongcaiqifu)
+- 泡泡配送（外卖）：[Android](https://app.mi.com/details?id=com.wxh66.dc.android)
+- 招财猫计算器（记账）：[Android](https://sj.qq.com/appdetail/com.zhaocaimao.cal)、[iOS](https://apps.apple.com/cn/app/%E6%8B%9B%E8%B4%A2%E7%8C%AB%E8%AE%A1%E7%AE%97%E5%99%A8-%E6%96%B0%E7%89%88%E6%97%A0%E5%B9%BF%E5%91%8A%E8%AE%A1%E7%AE%97%E6%9C%BA/id6742278907)
+- 智消云管家（消防）：[Android](https://sj.qq.com/appdetail/com.jbufa.iot3)、[iOS](https://apps.apple.com/sa/app/%E6%99%BA%E6%B6%88%E4%BA%91%E7%AE%A1%E5%AE%B6/id6499505198)
+- ABSign（电子合同）：[iOS](https://apps.apple.com/us/app/absign/id6751777998)
+
+其实uni-app x最大的案例就是uni-app x自身，
+1. uni-app x有几十个内置组件（form类、video）、uni-ui x、以及界面有关的API（showModal、showActionSheet、previewImage、chooseLocation、scanCode等）都是用uvue实现的。
+2. uni-app x的几百个API，都是用uts实现的。
+这些组件和API的文档上都列有源码链接。

package/data/uniappx/select/native-render-and-self-render.md

@@ -0,0 +1,382 @@
+# 一文讲透原生渲染和自渲染
+
+原生渲染、自渲染，都是跨端开发领域耳熟能详的词。
+
+但是：
+
+- 原生渲染和自渲染的准确概念是什么？
+- 自渲染为什么有时候比原生组件还快？
+- 为什么 flutter 自己画得很快，但一旦混入原生 View，就会出现各种复杂问题？
+- 原生渲染是不是天然意味着跨平台 UI 不一致？
+- 有没有一种方案，既渲染的快，又多平台UI一致，且没有混合原生 View 渲染的各种兼容性问题？
+
+理解这些问题，需要先把渲染系统搞明白。
+
+## 渲染系统简述
+
+### 典型原生渲染
+以原生渲染为列，看看一套渲染系统包括什么，渲染流程是什么。
+
+1. 初始化渲染资源：操作系统给App初始化一套渲染资源，包括窗体、渲染线程/进程、GPU上下文、字体加载、事件系统等。
+2. 组件系统初始化：操作系统会提供一套的原生的 UI Framework 和组件系统。有的操作系统会提供多套，比如Android有View体系和Compose UI库，iOS有UIView体系和SwiftUI。
+3. 排版布局：操作系统会提供多种布局，比如线性布局、约束布局、绝对定位等。
+4. 渲染线程/进程：负责把开发者写的组件代码和使用的布局，转换为GPU可识别的指令。比如Android上skia运行在这个环节来操作GPU。
+5. 合成与上屏：操作系统会合成应用的绘制内容，最终显示在屏幕上。
+
+### flutter的自渲染
+
+那么flutter的自渲染是什么？
+1. 在应用完成第一步初始化渲染资源后，
+2. flutter使用了OS提供的一类特殊组件，可以直接操作GPU。Android上是surfaceView/textureVIew，iOS是MTKView/CAMetalLayer，鸿蒙是XComponent。
+3. 在创建好可操作GPU的组件后，flutter自行又初始化了一套渲染资源，仍然要做一遍原生已经做过的事情，包括窗体、渲染线程、GPU上下文、字体加载、事件系统等。
+4. flutter提供了自己的一套widget组件系统。
+5. flutter提供了自己的排版布局系统。
+6. flutter的渲染线程把开发者写的组件代码和使用的布局，转换为GPU可识别的指令。
+7. 回到原生层进行合成和上屏。
+
+也就是flutter在原生渲染系统之上，又开辟了一套自己的渲染系统，但最终还要和原生合成。
+
+在web上，flutter采取了一致的思路，在浏览器已经为这个网页初始化好资源后，flutter利用了canvas组件，通过编译为wasm的渲染引擎和Dart代码在上面自绘UI，然后整体合成上屏。
+
+自渲染除了初始化渲染系统慢外，还有一个很大的问题是和原生组件的融合。后面会详细展开。
+
+flutter在不同平台的组件，都是一套dart编写的组件，所以不同平台的组件渲染一致性很高。
+
+### 再看看 react native
+
+react native 使用的是原生渲染，但在排版布局这个环节，改成了用 yoga 这个c库来做 flex排版。这种方式可以让多平台使用一致的flex布局。
+
+但 react native 使用了大量的各平台原生组件，分别由java/kotlin、objective-c/Swift等不同语言编写，这些组件差异，导致 react native 在不同平台的细节无法像flutter那样对齐。
+
+react native 的渲染性能，在跨平台框架中属于偏低的，虽然在 Fabric + JSI 架构下消除了序列化，但它仍然在原生渲染系统之上，又建立了自己的js层虚拟DOM，js代码中发送指令到原生层，在原生层动态创建OS的原生组件。
+
+这是 react native 的渲染流程：
+
+1. 初始化渲染资源：与原生一致
+2. 组件初始化：创建js虚拟dom，在js层 diff UI变更，发送指令给原生层，由原生层创建OS的原生组件
+3. 排版布局：在C层统一flex布局
+4. 渲染线程/进程：与原生一致
+5. 合成与上屏：与原生一致
+
+### 再看看 Compose UI
+
+它家的做法又有点不同。
+
+- Compose UI 在Android平台是原生渲染，但没有使用 Android View体系组件和排版布局系统，而是在Android canvas上重新开发了一套自己的组件和排版布局系统。
+	虽然听起来也有点像canvas自绘，但它不是基于surface/texture直接操作GPU的。它的绘制指令仍然要走到原生的渲染线程中统一处理。不存在跨渲染管线融合的问题。
+	这种做法的好处是可以和 Android View 体系完美融合。
+- 不过 compose-multiplatform 的iOS版，又和flutter一样，是完全的自渲染。也就是它在不同平台，采取了完全不同的渲染技术路线。这种工程选择有点怪异，其实是KMP语言本身的特性决定的。
+
+### 最后看看 uni-app x 蒸汽模式
+
+uni-app x 蒸汽模式也基于原生渲染管线，没有自渲染。
+
+在组件系统方面，它和 Compose UI 的Android平台类似，开发了一套自己的组件系统，可以和系统原生组件生态完美融合。但uni在Android、iOS和鸿蒙，是统一的策略，不存在一会儿原生渲染、一会儿自渲染。
+
+uni-app x 蒸汽模式的组件系统采用c++和uts语言开发，不同平台的组件代码一致，良好的保证了跨平台对齐。
+并且渲染速度更快。[详见benchmark](https://doc.dcloud.net.cn/uni-app-x/benchmark/vapor-benchmark-android.html)
+
+对比标准的原生渲染，uni-app x 蒸汽模式的变化如下：
+
+1. 初始化渲染资源：与原生一致
+2. 组件初始化：无虚拟DOM，通过预编译字节码/机器码，直接在原生层创建由C++编写的组件。
+3. 排版布局：在C层统一flex布局
+4. 渲染线程/进程：与原生一致
+5. 合成与上屏：与原生一致
+
+了解了渲染系统的基本原理和各家的做法，我们来看看原生渲染和自渲染的性能差异。
+
+## 自渲染问题1：初始化性能
+
+前文的渲染系统简述中，已经看出自渲染多做的事情。
+
+初始化渲染资源是一套较重的流程，在原生已经初始化好渲染资源后，自渲染需要再次创建一套自己的渲染系统。但最终也需要由OS统一合成。
+
+可以展开讲下一套自渲染系统要做的事情，在一个应用启动后，原生渲染系统已经准备好，此时发现界面中有flutter的view，
+1. 创建surfaceView/textureVIew/MTKView/CAMetalLayer/XComponent等重型组件。
+2. flutter要初始化图形后端如Impeller/skia，创建自己的渲染线程、GPU上下文、图层合成管理。有些情况下还要额外创建Platform线程。
+3. flutter要创建自己的屏幕事件监听系统，由于platformView的存在，flutter的屏幕事件监听系统还需要和原生屏幕事件监听系统互相竞赛。
+4. flutter要再自行开辟资源加载系统字体库，需要自建常用字光栅化缓存体系。
+5. 此外，flutter使用了大量的着色器，在低版本Android上，无法启用impeller时，会造成大量耗时用于着色器的运行时编译。
+
+这就是自渲染会比原生渲染在初始化时慢、占用内存和显存更多的原因。
+
+## 自渲染问题2：原生混合渲染
+
+在自渲染系统创建好后，渲染内置组件（如view、text）的速度，取决于渲染系统的代码实现性能。
+此时原生渲染和自渲染，谁快谁慢是不一定的，取决于谁的代码写的更好。
+
+不得不说，flutter的渲染内置组件代码写的非常优秀，尤其是在Android和鸿蒙上，部分组件的渲染速度比原生的同功能组件要快。
+
+但注意这里有2个前提：
+1. 自渲染系统已经初始化完毕
+2. 渲染的是自渲染系统的内置组件
+
+一旦要绘制平台原生组件（flutter中叫platform View），就不是这回事了。
+
+很多系统组件、三方sdk，用的是原生渲染，这是无法改变的。
+
+- 系统组件里有iOS的液态玻璃，鸿蒙的沉浸光感，还有弹出的软键盘也是原生渲染。
+- 三方SDK中，比如信息流广告等都是原生的。如果这些组件是flutter的dart语言实现的，那就可以和 flutter UI 很好的融合，但现实中这很难做到。
+- 还有一些组件不是原生渲染，但也不是flutter渲染，而是有自己的独立渲染，比如webview、video、map地图、camera、直播，这些也融不到flutter的渲染管线中，统一被纳入到platform view中。
+
+当一个界面同时要渲染多套不同管线的内容时，合成问题非常多。
+
+> **单一渲染体系主要是性能问题；多套渲染体系混合以后，问题就变成了 Composition、Synchronization、Input、Transform 和 Semantics 等系统级问题。**
+
+flutter在原生混合渲染上也在持续优化，推出各种不同思路的方案，但官方文档只能列出不同方案的优劣权衡，没有完美方案。本质是多套渲染管线难以调和的问题。
+
+### 1. 层叠合成
+
+假设有这样的页面：
+
+```text
+Flutter Widget
+    ↓
+半透明弹层
+    ↓
+Native WebView
+```
+
+如果所有内容属于同一个渲染体系，渲染系统知道每一层的位置、透明度和绘制顺序，可以统一处理。
+
+但如果上面是 Flutter 自己绘制的内容，下面是原生view，那么问题就复杂了。
+
+尤其是：
+
+* opacity
+* blur
+* backdrop blur
+* mask
+* clipping
+* transform
+* shadow
+* material effect
+
+这些效果都依赖正确的前后层关系。
+
+如果来回穿插多层，为了正确合成，要处理很多事情，性能问题就会更加严重。
+
+正常情况下，一个渲染系统内部不同组件层级和透明度，是在渲染系统的渲染线程里统一计算的，动态变更也没问题。
+
+flutter的渲染系统，内部计算自己的widget的层级和半透明关系没问题，但和原生view混合在一起计算层级和半透明，真是难为它了，只能上各种黑科技。
+
+为了处理不同渲染系统的合成，flutter要做很多事情。
+所以如果一个界面没有platform view，性能有时能超过原生渲染。
+但一旦有带有层级的platform view，性能就不行了。
+
+iOS的液态玻璃效果，被开发者吐槽精准打击 flutter 和 compose-multiplatform iOS版。
+
+这个透明效果与众不同，动态材质、手势变化、光照形变都非常复杂，Apple并未公开其算法。
+原生开发可以直接用iOS提供的API，但自渲染很难精准模拟，也达不到系统的省电效果。
+
+更麻烦的是合成，如果液态玻璃下面，一会展现自渲染的组件、一会展现原生或其他渲染方式的platform view，实现起来各种兼容性问题，高性能更不可能。
+
+那开发者不在界面上使用液态玻璃效果是否就能规避此问题？iOS系统有很多隐密的坑，输入框长按的上下文菜单也是液态玻璃的，这个菜单在透显自渲染和自渲染框架下的原生视图都有问题。
+
+注：uni-app x 蒸汽模式，提供了内置的液态玻璃组件，使用系统原生能力，就不会有完全自渲染带来的问题。可以在iOS 26+设备上体验[hello uni-app x](http://hellouniappx.dcloud.net.cn/)。录屏如下：
+
+### 2. 滚动同步
+
+flutter的滚动，是自己模拟实现的，并非系统原生滚动。
+
+在flutter滚动容器中，如果插入一个原生view，比如信息流广告或视频：
+
+```text
+Flutter List
+ ├── Flutter Cell
+ ├── Flutter Cell
+ ├── Native Advertisement
+ ├── Flutter Cell
+ └── Flutter Cell
+```
+
+Flutter滚动容器的滚动位置由 Flutter 管理。
+
+但是中间的原生view，是另一条渲染管线上的，它的排版布局不是flutter的。
+
+前端同学，可以理解下flutter在web上的做法，在canvas上创建了一套自己的渲染管线，滚动也是自己模拟的，此时需要在flutter的列表中插入信息流广告，但这个广告是一个div组件，
+如何把这些div，按正确的位置，显示在canvas里的某处，并且随着canvas内部的模拟滚动而移动div的位置？
+
+如果 Flutter 和 原生内容不能在正确的时机提交到**同一帧**，用户就可能看到位置不同步、抖动或者短暂错位。
+
+保持同步。这不仅是简单地修改一个坐标。还涉及：
+
+* Scroll position
+* frame timing
+* input
+* composition
+* clipping
+* visibility
+* nested scrolling
+
+为了维持滚动同步，flutter需要多做不少事情来处理各种情况，这造成了性能下降。
+
+并且在高渲染压力下，仍然可能会错帧。
+
+这里并没有否认flutter的努力，它在高版本利用OS的新API做了一定优化，但只是缓解，本质不变。
+
+### 3. 动画联动
+
+自渲染和原生渲染，走在不同的渲染管线上。
+如果需要一个flutter widget 需要和一个 platform view 做联动动画，甚至多个不同组件需要联动动画，难以流畅衔接。
+
+- 如果不同渲染系统的组件是嵌套关系，它们联动时遇到的问题类似滚动同步，都需要解决在动画过程中保持同一帧提交的问题，否则就会错位。
+- 如果不同渲染系统的组件是衔接关系，比如让一个原生view做动画，把一个widget顶飞，2个组件可能叠在一起或者中间有缝隙。
+
+软键盘动画是很多开发者未预见的坑。因为它不是flutter的 platform view，但软键盘也是属于原生渲染管线的。
+
+软键盘弹起时有一套原生动画，界面上的widget如想跟着动，在不同平台有各自的坑。
+
+基于手势的动画也是难点，手势事件同时传递给自渲染和原生渲染，并且让各自的区域都跟随手势做动画并衔接，性能不佳且复杂动画很容易错帧。
+
+### 4. 事件冲突
+
+原生和自渲染不仅有两套渲染体系，还存在两套事件体系。
+
+Flutter 有自己的：
+
+* Hit Test（根据手势坐标判断点到了那个组件）
+* Gesture Arena
+* Pointer Event
+* Gesture Recognizer
+
+Native UI 也有自己的：
+
+* Hit Test（根据手势坐标判断点到了那个组件）
+* Touch Event
+* Gesture Recognizer
+* Gesture Conflict Resolution
+
+flutter和原生，都要各自独立的处理手势事件，点击、缩放、双击、平移、长按等。hit test、冒泡、协商各自独立。
+
+手指在屏幕上滑过多个区域，有的是自渲染、有的是原生渲染，或者多指触摸有的在自渲染区域、有的在原生渲染区域，都会引发事件冲突。
+
+还有手势协商，本来系统原生是有手势协商概念的，可以每个组件吃掉一部分手势余量。
+但2套渲染管线，难以高性能协商，需要跨语言、甚至可能跨线程协商，麻烦很多，而且协商的不够快就可能造成渲染异常。
+
+很常见的是嵌套滚动，
+比如滚动容器中内嵌了webview组件。在原生渲染中，webview滚动到头后，可以触发原生的父滚动容器的继续滚动。它们直接还可以协商谁吃掉多少滚动余量。
+
+但让flutter的滚动容器和系统webview滚动协商，就难以流畅运行了。
+
+### 5. Transform形变
+
+如果 Flutter 对一个区域进行了形变处理：
+
+* Scale
+* Rotate
+* Translate
+* Clip
+* Perspective
+
+然后这个区域里面又有原生view，就需要把 Flutter 的 transform 正确传递给原生的合成系统。
+
+否则就可能出现flutter渲染的内容正确形变了，而原生view没变或错位。
+
+反之也一样。
+
+除了platform view，也有一个开发者难以预料的原生view会造成问题，就是输入框中长按然后左右移动时放大镜。
+
+这个放大镜需要对下面的内容实时放大和位移，并以显示当前光标的具体位置。
+这本来就很麻烦了，更麻烦是一旦此时实时在一套渲染中又做了形变操作，另一套渲染系统并不知道，就会错位。
+
+### 6. 综合冲突
+
+上面5个混合渲染问题，可能在一个界面中组合出现，那就会造成更多兼容性问题和更差的性能。
+
+## UI一致性
+
+有一个广泛流传的讹传。自渲染，是不是不同平台的UI一致性是严格一样的？原生渲染，是不是就无法保证不同平台的一致性？
+
+### 首先，自渲染也有不一致
+
+真正开发过渲染引擎的人才知道，自渲染在不同平台要做很多原生适配工作。
+
+1. 滚动的阻尼算法、边缘的回弹效果，iOS、Android、鸿蒙，都是不一样的
+
+为了和原生应用贴近，flutter等自渲染框架需要查看开源系统的相关算法，或者推测闭源系统的相关算法，在不同平台进行模拟。
+
+一旦OS系统升级，修改了相关算法，flutter就得尽快更新，开发者也得尽快更新内嵌的flutter sdk。
+
+Android有很多ROM厂商，如果有ROM厂商自己调整了滚动和回弹算法，flutter是难以适配这些个性化ROM的。
+
+在一个App里，如果部分界面使用flutter渲染，这个问题会尤其严重，使用者会感觉到这个界面的滚动和回弹有点怪。
+
+2. 输入法适配
+
+flutter的输入框，并不是系统的输入框控件，那个闪烁的光标是flutter引擎自己绘制的，为了让光标的大小、颜色、闪烁频率和系统保持一致，flutter都需要做平台适配。
+
+输入框点击后，又会有更多问题
+- 如何弹出原生渲染的软键盘？
+- 软键盘上输入的字或快捷短语如何上到flutter渲染的界面上？
+- 原生渲染的长按上下文菜单如何处理？
+- 长按的放大镜如何正确显示放大内容？
+- 自动填充、语法校验这些原生已经存在的功能如何重新实现？
+
+这都是flutter需要在每个平台都自行写代码处理的。这些代码，也都在消耗系统资源。
+
+flutter和系统预置输入法的适配一般没有问题。
+而三方输入法如果实现的很规范，也不会有问题，但仍然可能出现三方输入法在系统输入框下正常，但在flutter的输入框中异常的情况。
+这很大程度上取决于三方输入法在发版时是否同时测试了flutter输入框的兼容性。
+
+3. GPU适配
+
+现代 Flutter 已经通过 Impeller 等方案显著改善了渲染后端的一致性和着色器问题。
+
+但 Android 设备仍然存在大量 GPU 和驱动差异。
+
+尤其是老设备、不同 GPU 厂商以及不同 Android 版本之间，图形能力并不完全一致。
+
+因此，自渲染引擎依然需要进行大量兼容性测试。
+
+也存在在某些边缘设备上GPU适配有问题的可能。
+
+### 其次，原生渲染也并非效果不一致。
+
+原生渲染效果在各平台不一致，这是react native的一些内置组件的特点，并不是所有原生渲染系统的共性。
+
+造成这种差异的核心，不是原生渲染系统的问题，而是原生组件的实现方式问题。
+
+flutter的widget，是一套dart代码编写的。而react native的不同组件，几乎都是各平台原生语言写的。
+
+在 uni-app x 蒸汽模式中，通过相同的组件代码，实现了原生渲染下的UI一致性。这些组件使用跨平台的c++和uts语言编写。（并不要求开发者使用uts，开发者可使用js/ts）
+
+这种方式，即保障了跨平台的严格一致性，又大幅提升了渲染性能。
+
+同时 uni-app x 中使用系统原生组件也是无缝的，比如 uni-app x 内置的 glass-effect-view组件，就是iOS原生的液态玻璃组件。
+
+## 总结
+
+几种不同的架构总结到下表中：
+
+| 架构												| 渲染管线						| 组件和排版							| 典型代表											|
+| -------------------------	| ------------------| ---------------------	| --------------------				|
+| 经典原生										| OS								| OS native							| UIKit / Android View				|
+| 原生渲染的框架UI						| OS								| 框架										| Compose UI Android版 / uni-app x 蒸汽模式	|
+| 自渲染											| 框架								| 框架										| Flutter	和 compose-multiplatform iOS版	|
+
+我们钦佩flutter团队的工程能力和代码水平，尤其是在GPU着色器上的极致运用。
+
+但如果这个世界出现了一个跨平台引擎：
+- 渲染速度更快
+- UI一致性很好
+- 没有自渲染的初始化和混合渲染顽疾
+- 除了iOS和Android，还能跨好更多平台，比如web、小程序、鸿蒙
+
+那对于开发者，是一个更完美的方案。
+
+uni-app x 蒸汽模式，正是基于这种思路设计的，并且成功实现了上述目标。
+
+在之前公布的benchmark中显示，
+uni-app x 蒸汽模式在渲染大量view和text时，性能是原生同类组件的2~3倍。
+在长列表、canvas、rich-text等各项测试中也展现出强于原生或其他跨平台相同功能组件的性能表现。
+
+详见：
+- [Android benchmark](https://doc.dcloud.net.cn/uni-app-x/benchmark/vapor-benchmark-android.html)
+- [iOS benchmark](https://doc.dcloud.net.cn/uni-app-x/benchmark/vapor-benchmark-ios.html)
+- [鸿蒙 benchmark](https://doc.dcloud.net.cn/uni-app-x/benchmark/vapor-benchmark-harmony.html)
+
+一些人可能难以相信 uni-app x 蒸汽模式的渲染性能这么快，但解释 uni-app x 渲染更快的原因，需要更多单独长文，本文主要讲述的是原生渲染和自渲染的原理和优劣。
+
+如果开发者对为什么渲染快的原因感兴趣，可以阅读 [uni-app x 蒸汽模式的文档](https://doc.dcloud.net.cn/uni-app-x/app-vapor.html)

package/data/uniappx/select.md

@@ -0,0 +1,3 @@
+# 跨平台开发框架比较
+
+> 注意：本文为VDOM模式的比较。不适用于蒸汽模式。蒸汽模式在性能、内存占用、原生生态兼容、易用性等方面均远超其他跨平台开发框架。[另见](./app-vapor.md)

package/data/uniappx/tutorial/android-16kb.md

@@ -0,0 +1,91 @@
+## 概述  
+16K，是指C语言等可操作内存的语言使用内存的规范，对齐16K可以提升C代码的运行性能。只有so库涉及。如果使用js、java，不涉及16K问题。
+
+Google Play 的政策要求：  
+自 2025 年 11 月 1 日起，提交到 Google Play 且以 Android15（API 级别 35）及更高版本的设备为目标平台的所有新应用和现有应用更新都必须支持 16KB 的页面大小。  
+[详情](https://android-developers.googleblog.com/2025/05/prepare-play-apps-for-devices-with-16kb-page-size.html)。
+
+> HBuilderX4.81+，DCloud的自有so库已适配支持 16KB 内存页面大小
+
+但是，某些三方sdk的so库未适配16K，见下。
+
+**注意**  ：
+Android17+，默认会开启16KB兼容性检测，如果应用中包含未适配支持 16KB 的 so 库，在启动时会弹出 `Android 应用兼容性` 提示框。  
+提示内容为：“此应用不符合 16KB 对齐要求。ELF文件对齐检查失败。”。
+虽然这个列表中也会出现 DCloud的自有so库，但其实是因为三方sdk不支持16KB导致打包时被降级了。
+如去掉不支持16KB的三方sdk再打包，可以正常通过16K校验，不再弹框报警。
+
+## 不支持 16KB 的模块  
+虽然 uni-app x 核心功能模块已适配支持 16KB 内存页面大小，但部分涉及三方 SDK 的so库仍未完全适配支持。  
+
+以下列出三方sdk清单，开发者可根据需要，去除这些sdk再打包。有些三方sdk已经不再维护，开发者可在插件市场寻求替代方案或自行使用uni-agent开发相关插件。
+
+### [live-pusher 组件](../component/live-pusher.md)
+`uni-live-pusher`模块是由 DCloud 的合作伙伴七牛提供并实现 live-pusher 组件相关功能，此模块依赖七牛的多媒体SDK，但该 SDK 目前未适配支持 16KB 内存页面大小。  
+建议应用用于提交 Google Play 时不要使用此功能。  
+
+涉及的so库文件列表：
+- libpldroid_mmprocessing.so
+- libpldroid_streaming_aac_encoder.so
+- libpldroid_streaming_amix.so
+- libpldroid_streaming_core.so
+- libpldroid_streaming_h264_encoder.so
+- libpldroid_streaming_puic.so
+- libpldroid_streaming_srt.so
+
+### [live-player 组件](../component/live-player.md)
+`uni-live-player`模块是由 DCloud 的合作伙伴七牛提供并实现 live-player 组件相关功能，此模块依赖七牛的多媒体SDK，但该 SDK 目前未适配支持 16KB 内存页面大小。  
+建议应用用于提交 Google Play 时不要使用此功能。  
+
+涉及的so库文件列表：
+- libavcodec.so
+- libavformat.so
+- libavutil.so
+- libcrypto.1.1.so
+- libcurl.so
+- libqplayer2-core.so
+- libsoundtouch.so
+- libsrt.so
+- libssl.1.1.so
+- libswresample.so
+- libyuv.so
+- libpldroid_streaming_srt.so 
+
+### [uni-ad](https://uniapp.dcloud.net.cn/uni-ad/)
+`uni-ad`使用国内广告渠道SDK 仅支持国内环境，建议应用用于提交 Google Play 时不要使用国内渠道 SDK。  
+
+涉及的so库文件列表：
+- libplt-base.so
+- libsgcore.so
+- libti-monitor.so
+
+> HBuilder4.83及以上版本 国外广告 `applovin`、`pangle(海外穿山甲)` 广告渠道 SDK 已适配支持 16KB 内存页面大小。  
+
+### [uni-push](../api/uni-push.md)
+`uni-push`使用了个推的sdk，在国内环境下，该sdk又依赖`卓信ID SDK`，但`卓信ID SDK` 目前未适配支持 16KB 内存页面大小。  
+为满足 Google Play 的要求，应用在提交至 Google Play 时需避免使用`卓信ID SDK`。按以下方式配置，使用`uni-push`时将不会包含`卓信ID SDK`：  
+1. 项目manifest.json可视化界面，在 “安卓App配置” 下的 “uni-push（消息推送）” 中只勾选 “Google FCM推送SDK”  
+  ![](https://web-ext-storage.dcloud.net.cn/uni-app-x/uni-push/android-16k-unipush-fcm.png)  
+2. 云端打包界面，在 “打包格式” 下勾选 “AAB(谷歌商店仅支持aab)”  
+  ![](https://web-ext-storage.dcloud.net.cn/uni-app-x/uni-push/android-16k-unipush-aab.png)
+
+涉及的so库文件列表：
+- libzxprotect.so
+
+### [uni实人认证](../api/facial-recognition-meta-info.md)  
+`uni实人认证`功能仅支持国内环境，建议应用用于提交 Google Play 时不要使用此功能。
+
+涉及的so库文件列表：
+- libaliyunaf.so  
+- libfacedevice.so  
+
+### [腾讯地图](../component/map.md)  
+腾讯地图使用的 SDK 版本为 `5.8.3`，暂未更新到最新版本，需等待官方升级腾讯地图SDK版本适配。
+
+使用腾讯地图SDK的API：
+- [uni.createMapContext](../api/create-map-context.md)
+- [uni.chooseLocation](../api/choose-location.md)
+
+涉及的so库文件列表：
+- libtxmapengine.so
+- libtxmapvis.so