当前位置:

首页 > 系统应用 > Taro小程序跨端开发入门实战

Taro小程序跨端开发入门实战

背景一开始我们只做微信小程序随着我们的业务不断扩张和各大小程序平台的崛起,针对每个平台都去写一套代码是不现实的。而且原生的小程序开发模式有很多弊端。为了让小程序开发更简单,更高效,我们采用 Taro 作为首选框架,我们将使用 Taro 的实践经验整理了出来,主要内容围绕着什么是 Taro,为什么用

本文目录

    背景

    一开始我们只做微信小程序随着我们的业务不断扩张和各大小程序平台的崛起,针对每个平台都去写一套代码是不现实的。而且原生的小程序开发模式有很多弊端。

    为了让小程序开发更简单,更高效,我们采用 Taro 作为首选框架,我们将使用 Taro 的实践经验整理了出来,主要内容围绕着什么是 Taro,为什么用 Taro,以及 Taro 如何使用(正确使用的姿势),还有 Taro 背后的一些设计思想来进行展开,让大家能够对 Taro 有个完整的认识。

    Taro 3.0 已经逐渐成熟,我们项目已经进行了Taro 3.0的升级,因此本文代码示例以 Taro 3.0 作为基础。

    什么是 Taro

    Taro 是一个多端统一的开发框架。使用 taro 它可以支持 React 的开发方式,编写一次可以运行多端的代码,就能够生成可以在各种小程序,H5 甚至 React Native 等多端应用。

    Taro 官方介绍:
    Taro 是一个开放式跨端跨框架解决方案,支持使用 React/Vue/Nerv 等框架来开发 微信 / 京东 / 百度 / 支付宝 / 字节跳动 / QQ 小程序 / H5/ React Native 等应用。现如今市面上端的形态多种多样,Web、React Native、微信小程序等各种端大行其道,当业务要求同时在不同的端都要求有所表现的时候,针对不同的端去编写多套代码的成本显然非常高,这时候只编写一套代码就能够适配到多端的能力就显得极为需要。

    它的主要特点是:
    快:可以快速开发小程序: 解决小程序开发各种痛点;
    多:可以实现多终端适配:一套代码适配小程序、H5、RN 等多终端;

    为什么用 Taro

    随着应用变得庞大之后,复杂度越来越高,原生小程序开发的痛点逐渐暴露出来:
    •代码组织复杂:写一个页面的文件结构繁琐(四个之多)
    •规范不统一:组件、方法命名规范不统一、各种书写方式,语法结构不一致像 React 又像 Vue
    •孱弱的字符串模板:逻辑表现力不强,不支持 eslint
    •依赖管理混乱:缺少 npm 包依赖管理
    •不完全的 ES Next:仅支持部分 ES Next 语法,比较新的 ES2020, ES2021+ 都不支持
    •落后的开发方式:前端工程体系不完善,webpack 打包,css 预处理等缺失,对于前端来说比较落后的,对个人成长也不利

    可选技术方案可选技术方案

    对于以上微信小程序开发模式的痛点,业界也给出了一些可选方案:

    对比分析

    • mpvue 是美团研发的框架,多端适配效果不好,很久问题都没人维护;
    • WePY 是腾讯出的组件化框架,但是无法适配多端;
    • Chameleon 在多端适配方面表现很突出,缺点是不支持京东小程序,无法转换原生小程序(想用只能重写项目);
    • Taro 优秀的特性,遵循 React/Vue 语法规范,引入的现代化的开发流程,让开发更专注核心代码,提供健全的代码检查方式。

    多端需求


    Taro 支持平台最全面,独具转换能力,性能方面优于其它框架,总结特点如下:

    • 可以实现微信小程序原生代码转换到微信平台,百度平台等;
    • Taro 框架是唯一一款实现京东小程序适配的框架;
    • 支持 React/Vue 语法,更好的支持组件化和 TypeScript;
    • 行业影响力大,社区活跃,京东内部优秀团队研发的框架,支持有保障,研发团队靠谱非常支持我们的工作;
    • 更加完善的UI组件库,支持多端同步调试能够适配更多终端;

    一处编写,多端运行

    设计思想

    主要采用 React 开发方式

    用 React 写多端应用

    核心思想

    代码转换:使代码可以在不同平台上运行
    运行时适配:使代码在不同平台上有相同表现

    以微信小程序为例以微信小程序为例

    JSX

    WXML

    Taro 代码编译原理


    Taro 的编译原理:就是对输入的源代码进行语法分析,语法树构建,随后对语法树进行转换操作再解析生成目标代码的过程。

    第一步是Parse,把代码解析(Parse)为抽象语法树(Abstract Syntex Tree)。这一步骤对于前端而言并不陌生,就好比操作DOM树一样。然后,对AST进行遍历(tra verse)和替换(replace)。最后一步是生成(generate),依据新的AST生成编译后的代码。

    开发时遵循 React 语法标准,结合编译原理的思想,对代码文件进行一系列转换操作,最终获得可以在小程序运行的代码。而 React 最开始就是为了解决 Web 开发而生的,所以对代码稍加改动,也可以直接生成在 Web 端运行的代码,而同属 React 语法体系下的 React Native,也能够很便捷地提供支持。同理其他平台,如快应用、百度小程序等,将源码进行编译转换操作,也能获得该平台下的对应语法代码。

    可以看出小程序和 Web 端上组件标准与 API 标准有很大差异,这些差异仅仅通过代码编译手段是无法抹平的,例如你不能直接在编译时将小程序的直接编译成

    ,因为他们虽然看上去有些类似,但是他们的组件属性有很大不同的,仅仅依靠代码编译,无法做到一致,同理,众多 API 也面临一样的情况。针对这样的情况,Taro 采用了定制一套运行时标准来抹平不同平台之间的差异。

    这一套标准主要以三个部分组成,包括标准运行时框架、标准基础组件库、标准端能力 API,其中运行时框架和 API 对应@taro/taro,组件库对应@tarojs/components,通过在不同端实现这些标准,从而达到去差异化的目的。

    多端适配基础标准

    • 基础框架(生命周期、组件API):以React的生命周期、组件api为基础,小程序的特性作为补充
    • 标准组件库(View、Button): 以微信小程序组件为标准,各端模拟实现
    • 标准Api (request、setState):扩展的小程序标准Api,各端模拟实现

    多端适配基础架构图如下:

    快速上手

    初始化项目

    环境准备:需要有个 node 环境,运行 npm 命令:


    开始使用 Taro 编写页面:

    运行项目

    多平台启动命令示例:

    如果同时看三端效果:分别运行以上命令即可;

    微信原生小程序转换 Taro 小程序

    Taro 项目的组成

    Taro项目目录结构

    基本的目录结构:

    比较完整的多端项目结构:

    完整的文档请访问:https://taro-docs.jd.com/

    多端适配

    多终端配置文件编写

    •微信的配置文件 project.config.json,文件内容可以自定义微信小程序的选项,运行的目录和 appid 等;
    •百度小程序的配置文件 project.swan.json 内容和微信类似;
    •京东小程序的配置文件 project.jd.json 内容和微信类似;
    •其它平台的小程序都有独立的配置文件便于运行的调试;

    多终端入口文件

    不同平台的页面配置信息各有差异:
    •微信小程序页面为全量配置,包含微信登录页面(这是其他平台所没有的);
    •百度小程序设有专门的登录页面,部分页面百度不支持,如图片裁剪、达达同城、打印等,需进行隐藏处理;
    •京东小程序:不支持批量寄件,无需登录页面,不支持分包,所有内容均需写入主包中;

    差异化配置

    • 不同平台加载对应的文件:
    • 每个平台差异化配置信息:
    • 地图类型;
    • 渠道信息;
    • 请求头信息;
    • 。。。

      代码差异化处理

    平台特定 js 代码块儿实现,在任意 js 代码中加入如下语法:

    平台特定 css 代码块儿实现, 在任意 css 代码中加入如下语法:

    提示:代码在打包时不会增加包体积,针对不同平台提取相应代码。

    多端适配案例

    一些典型的多端通用解决方案:

    • 样式解析:

      • 微信是 rpx,百度小程序 vw,京东小程序 px;
      • Taro 统一使用 px 通过框架处理转换成对应平台的像素,因此 px 值不要使用单数;
      • 1px(像素)的边框通常会转换成平台对应单位会导致无法显示, 可以使用大写的PX单位,例如: 1PX ;
      • 百度小程序和京东小程序不支持 externalClasses,其它小程序也可能不支持避免使用;
    • 模块导入和导出:

      • 导入模块需要使用ES6 的 import, 不要使用 require 到 JS 文件(有些平台不支持);
      • 内联本地图片资源可以使用 require 动态导入;
      • 导入外部资源的 url 必须使用 https,有些平台或机型不支持 http ;
      • 小程序插件导入可以使用 require 但是要做多平台适配和兼容性处理;
    • 组件开发细节:

      • 组件 key 取值,不要使用 index ,对象的 id 属性要先解构出来;
      • 组件渲染条件取 length 属性页面不更新;
      • dataset 问题:百度和微信获取的不一样,都要用小写来保持代码一致: 这种驼峰的:data-goodsIndex={index} ,微信会转成全小写 goodsindex, 百度会保留驼峰 ,正确地写法:data-goodsindex={index} ;

    百度小程序开发注意事项:

    • 层次较深的状态不会更新时,需要解构变量;
    • 转换成 vw 样式有偏差,确保样式的通用性;
    • 个别组件 height: auto 有bug,不写没事;
    • line-height 居中有偏差,用 flex 比较稳妥;
    • fixed 布局居底要设置 left: 0, bottom: 0 ,不写默认会有问题(默认在中间渲染);
    • mask 组件层级较深时,可能不会更新状态,可以使用 tt-modal 代替;
    • 图片裁剪,语音识别,打印功能等依赖原生 API 不支持;
    • 状态更新从有到无需要显性设置 null ,例如将列表组件隐藏:this.setState({list: null}) {list && <组件实例>};

    京东小程序开发注意事项:

    • 不支持全局覆盖组件样式,如果想兼容需要单写加上拼接样式名;
    • 不支持小程序分包,需要单独配置页面路由信息;
    • showModal 弹窗不能定制 confirmColor 属性;
    • storagesync 不支持存储 json 数据,读取需要自己手动JSON.parse;
    • 不支持 canvas绘画API:微信自定义分享功能,图片裁剪,订单条形码等功能都做不了;
    • 不支持同层渲染,原生组件上只能使用 Cover 组件;
    • ios 内嵌H5,如果url带参数,需要手动做一下urlencode编码;
    • H5页面使用小程序 webview 不具备全部京东 app webview 功能,有些功能不支持;
    • 京东小程序分享 URL 和 其它小程序分享的 URL 不一样,要注意路径的差异区分:
      • 例如:shareURL: 京东小程序: page/index/index 微信小程序:/pages/index/index

    多端同步调试

    在 config/index.js 配置:outputRoot: dist/${process.env.TARO_ENV}

    生态与规划

    物流风格的 Taro UI组件库—Tarot(已适配Taro3.0)

    定制化 Taro 模板工程定制化 Taro 模板工程

    模板工程主要特性:
    •自带按需引入的 Tarot 组件库及组件使用示例。
    •自带 pandora-tools 中的工具,如网关调用插件等。
    •登陆适配多端,小程序端自动引入京东无线登陆插件,h5端自动跳转无线统一登陆M页d等。
    •网关调用适配多端,自带 Demo 示例;
    •包含 TypeScript 和 Redux等更多高级API及用法示例;
    •其它功能持续更新……

    小程序 Mini Debug 工具

    MiniDebug 是一款多端小程序调试工具,旨在提高小程序开发、测试效率的工具库
    功能介绍:
    主要功能包括环境切换、身份Mock、应用信息获取、位置模拟、缓存管理、扫一扫、H5跳转、更新版本等。工具部分页面如下图所示:
    目前已经在 GitHub 上开源(欢迎 issue):https://github.com/jdlfe/minidebug

    物流风格的小程序可视化拖拽平台(规划中)

    京东商城已经实现了小程序可视化拖拽平台:https://ling.jd.com/atom/cms/pc/06599

    结语:

    Taro V3.0.0 目前支持 React、Nerv、Vue 三类框架,在未来 Taro 将开放拓展能力,使得开发者可以通过 Taro 拓展更多的框架支持,(比如:适配 Flutter 将成为可能 )。目前Taro框架完善社区活跃,即使没有多端需求,仅用 Taro 开发 H5 也是个不错的选择(未来可以 0 成本接入小程序平台),想了解更多 Taro 3.0 实践经验欢迎线下交流。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    系统应用 小程序
    相关文章 更多
    雀大侠视频与文案提取:小程序入口和结果功能
    雀大侠视频与文案提取:小程序入口和结果功能

    了解雀大侠视频提取和文案提取的界面、分享内容输入方式与结果页功能,使用前核对输出内容和适用范围。

    持续打通腾讯生态,元宝开启调用微信政务民生小程序能力
    持续打通腾讯生态,元宝开启调用微信政务民生小程序能力

    元宝打通微信政务民生小程序,用户更新至最新版并切换快速思考模式后,可处理社保、公积金、户籍等事务并跳转对应办理页面。目前已覆盖十余个政务领域,未来计划接入更多小程序及美团AI助手等生态服务。

    基于Taro开发京东小程序小记|京东云技术团队
    基于Taro开发京东小程序小记|京东云技术团队

    一、小程序基础模型这里要从微信小程序的历史说起,从前身到现在大概分为3个阶段:阶段1: 微信网页需要用到app的原生能力,微信官方推出了js-sdk阶段2: 解决移动端白屏问题,采用微信web资源离线存储阶段3: 追求原生的体验,重新设计并产生了小程序为了满足商家、服务商等用户在京东应用中的开放能力

    boss直聘怎么写自我评价
    boss直聘怎么写自我评价

    Boss直聘自我评价需紧扣岗位JD、量化成果、叠加精准身份标签、替换低效话术,并确保首句90字符内承载核心竞争力。 在Boss直聘平台,一份简历的自我评价部分如果缺乏抓力,往往意味着错失了黄金10秒。问题通常出在内容过于泛泛,没能精准对接招聘方的即时需求。那么,如何让这段文字成为你的“黄金广告位”?

    必应搜索怎么查找改编自小说的影视剧
    必应搜索怎么查找改编自小说的影视剧

    精准检索改编影视剧应使用限定站点、书名号搭配、逆向追溯、版权锚点及平台片单五类方法 想快速找到一部剧的原著小说?这事儿说简单也简单,但真要精准锁定官方承认的改编关系,避免被各种混杂的营销信息、短剧切片甚至盗版资源带偏,那就得讲究点方法了。常规的关键词搜索常常力不从心,问题往往出在检索逻辑上——没能贴

    QQ号怎么创邮箱
    QQ号怎么创邮箱

    不少朋友手上都有QQ号,但可能一直没想起来,其实它自带一个专属的、格式统一的“QQ号码@qq.com”邮箱,静待激活。激活过程也不复杂,一般就是确认协议、验证手机号,再设个密码的事儿。想操作的话,QQ客户端、官网或者微信小程序都行,选你顺手的方式即可。 如果你已经有个QQ号,但还没用过它的邮箱功能,

    雨课堂网页版登陆官网
    雨课堂网页版登陆官网

    雨课堂官网为https://www.yuketang.cn/,支持网页端登录和微信小程序多端使用,提供课前预习、课中互动、课后复习全流程教学服务。 雨课堂的网页版登录入口到底在哪里?这几乎是每位初次接触该平台的师生都会问的问题。别急,下面我们就来完整梳理一下雨课堂系统的在线登录方法,以及最核心的官网

    营销宣传被指违规,绿叶惠购小程序紧急撤架,产品为何经不起追问
    营销宣传被指违规,绿叶惠购小程序紧急撤架,产品为何经不起追问

    苏州绿叶惠购小程序因“消字号”卫生巾宣传养生功效、保健食品缺“蓝帽子”标识被调查,随后紧急下架涉事产品,但其他电商平台仍在售。公司未公开回应,仅调整小程序栏目名称。问题产品宣传与合规要求相冲突,引发对信息承诺的追问。

    百度答题有奖的小程序
    百度答题有奖的小程序

    百度答题红包入口需用最新版app(≥18.50)搜索“答题红包”四字,或通过“赚好礼”→“答题”模块、官方链接、首页下拉“红包专区”、组合词“百度答题红包2025”等方式进入。 想参与百度答题拿现金红包,却怎么也找不到入口?别急,这通常不是活动结束了,而是路径没找对。入口藏得有点深,关键词输错一点,

    抖音上线可颂活动小程序,探索线下兴趣社交
    抖音上线可颂活动小程序,探索线下兴趣社交

    最近有消息说,抖音旗下的同城兴趣组局、线下搭子社交小程序“趣玩”完成了品牌升级,正式更名为“可颂活动”。不止是名字变了,它同步上线了抖音小程序和微信小程序,算是正式露脸了。简单来说,这个产品就是帮用户基于兴趣发起线下活动——比如一起探店、一起手工、一起户外运动。这其实跟之前重启的“可颂”App形成了

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。