Taro迁移完成之后,总结了一些踩坑经验

2023-03-31 15:20:27 浏览数 (1)

背景

四月份的时候,尝试将老的移动端项目改造成多端。因为老项目使用的React框架,综合考量,保障当前业务开发的进度同时,进行项目迁移,所以最后选择了Taro框架。迁移成本会低一些,上手快一些。

上个月,也就是七月份,我们用一个月的时间实现了两个项目从原生小程序到Taro框架的迁移。这当中,因为几个「小水坑」,我们连着加了两周的班。我把其中几个比较难搞的问题,解决方案总结了下来。

Taro文档

Taro的官方文档写的挺详细的,不过感觉搜索功能不是特别顺手。我平时搜不到想要的词条,会在菜单里找找可能的页面,基本多刷刷文档,能找到想找的内容。

项目迁移

之前写过一篇项目迁移的文章——《「Taro开发」前端多端开发,Taro观赏指南》。文章中对于基本配置、采用的UI框架、路由处理等基础功能实现,本篇不再重复。

踩坑指示牌

这次的坑,新旧都有。原本以为解决的问题,其实没有完全解决,所以我把最终的实现方案做了总结。

小程序文件过大的问题

最开始用分包的方式,在开发者工具中提交代码提示文件体积过大。但是又没找到问题在哪,最后才用了方案B,设置环境变量 NODE_ENV 为 production 可以开启压缩。如下为项目命令:

代码语言:javascript复制
"scripts": {
  "build:weapp": "NODE_ENV=production taro build --type weapp",
  "dev:weapp": "npm run build:weapp -- --watch"
}

但是这样做会有个额外的问题,就是无法在用NODE_ENV区分环境。后来我采用的解决方案是

  • 小程序端使用envVersion区分环境
代码语言:javascript复制
const env = wxConfig.envVersion;
// 小程序开发环境 release-正式 trial-体验 develop-开发
const baseUrl = env === 'release' ? requestUrl : devrequestUrl;
  • H5端则通过页面的域名区分环境
代码语言:javascript复制
let env = 'production';
if (NODE_ENV === 'production' && window.location) {
  if (window.location.origin.indexOf('//dev') !== -1) {
    env = 'dev';
  }
  if (window.location.origin.indexOf('//release') !== -1) {
    env = 'release';
  }
} else if (NODE_ENV === 'development') {
  env = 'dev';
}

H5页面间样式冲突

开始我并没有往样式冲突上想。我把项目发布到测试环境之后,页面布局发生了局部混乱。

一开始我以为是功能写的有问题,找了半天,换了实现方式,也没有解决问题。然后我找了一下规律,发现当不同页面切换时,切到某个页面会导致样式错乱。于是我打开浏览器的元素审查,查看页面源码。截图如下:

原来Taro框架生成的H5页面,每次切换路由之后,所有的页面都是在app根下,通过display控制展示和隐藏。这种情况下,我采用的样式隔离的方式来避免冲突。

官方提供的CSS Modules,尝试了一下觉得有点繁琐,所以没有采用。

不要使用空标签

空标签会导致项目部署时报错,如下代码:

代码语言:javascript复制
<>111</>

我统一用Fragment组件替换了空标签:

代码语言:javascript复制
<Fragment>111</Fragment>

部署前需要确认Jenkins上是否已安装了Taro

我们的项目刚上测试环境时,发版工具给了如下报错:

代码语言:javascript复制
sh: taro: command not found

请教了运维的同事后,运维的同事帮忙安装了Taro。所以部署前确认一下,不然发版会失败,着急提测会手忙脚乱。

尺寸单位替换

小程序迁移的时候注意单位的替换,因为我是直接把小程序的样式代码迁移过来的,所以需要将原本的rpx更换为px。Taro 默认以 750px 作为换算尺寸标准,所以尺寸值不需要进行额外的修改。

总结

后面还会有React项目迁移的需求,等那个项目迁移完成之后,我会再总结一般踩坑经验。

0 人点赞