flutter项目迁移空安全

  1. 重中之重
    备份好项目文件,甚至连已经加载好的flutter库也可以备份。
  2. 环境包升级
    2.1
    不要直接换成flutter:3.0以上的版本,这样做既有基本的库兼容问题,又有空安全下的语法问题(整个项目中需要增加 late、?、!的语法错误,一片报错的红海/(ㄒoㄒ)/ )
    2.2
    将环境包升级到flutter:2.10.5,它是flutter:3.x前的最后一个版本。
    Flutter SDK下载地址:https://docs.flutter.dev/install/archive#windows
    pubspec.yaml 中配置dart sdk版本限制:sdk: '>=2.10.0 <3.0.0'(不能直接配置>=2.12.0,2.12.0以上强制使用空安全语法)

environment:

sdk: '>=2.10.0 < 3.0.0'

  1. 解决由于更换环境后出现的库版本不兼容问题

    3.1

    手动修改太麻烦时,可以运行命令行:dart fix --apply。它能自动修复Dart代码过时的方法调用、格式问题、或可被自动修正的小错误,但并不是全部。

  2. 进行空安全迁移前的准备 (项目已经在flutter:2.10.5环境顺利运行)

    4.1

    检查项目中依赖库是否支持空安全。运行命令:

dart pub outdated --mode=null-safety

未全部支持空安全会打印出哪些库未支持,

第三列绿色是足够支持空安全的版本,

第四列绿色是库当前的最新版本它的环境可能是3.x。

将对应库版本改为足够支持空安全的版本就好。(不用命令行dart pub upgrade为了避免升级到最新版本)

4.2

修复更改版本后的库调用问题(dart fix --apply可以用起来),保证项目能正常运行起来。

4.3

再次运行dart pub outdated --mode=null-safety检查,此时项目已经完全支持空安全了

  1. 开始空安全迁移
    5.1
    当第三方库不能完全支持空安全时有命令行(这样的操作常常会不完整或是迁移失败)

dart migrate --skip-import-check //跳过依赖的三方库是否支持空安全

--skip-import-check --ignore-exceptions //跳过依赖的三方库是否支持空安全且忽略异常情况

所以项目完全支持空安全的情况下应该直接迁移,运行命令:

dart migrate

顺利执行命令后会打印提供的迁移工具链接,在浏览器中打开。

点击按钮APPLY MIGRATION 应用迁移到项目中,等待迁移执行完成(对于文件太多的项目手动迁移不可取)

当执行完成后,在Android Studiio代码被自动更改。打开pubspec.yaml会看到SDK版本限制被改为了>=2.12.0

environment:

sdk: '>=2.12.0 < 3.0.0'

5.2

但项目中会有迁移工具无法修复的报错。

一般都是空条件判断的报错,一条条修复。(比起整个项目都报红好太多!)

报错代码示例:

dart 复制代码
int? _goodsQuantity;
if(condition == 1){
	_goodsQuantity += 1; //这句会报错
	_goodsQuantity  = (_goodsQuantity ?? 0) + 1; //改成这样
}

当所有报错解决项目能正常运行起来了,空安全迁移就完成了。

6.页面报错的修复

虽然空安全语法正确了项目跑起来了,但是在数据处理上不可避免的会出现逻辑上的空判断冲突,此时有问题的页面就会报错。

需要把各个页面点一点,耐心的走一遍整个app,修复这些bug。

一般是类型不匹配报错,示例:

type '() => Null' is not a subtype of type '(() => Future)?' in type cast

type 'String' is not a subtype of type 'String?' in type cast

解决空安全后,再去升级flutter3.x版本会更方便。

相关推荐
安当加密6 分钟前
CAS密钥管理系统在汽车行业的核心密钥管理实践——构建智能网联汽车的可信安全底座
网络·安全·汽车
upgrador8 分钟前
Linux内核与设备管理:USB存储驱动usb_storage/uas的安全卸载与复原
linux·运维·安全
andyguo32 分钟前
AI模型测评平台工程化实战十二讲(第五讲:大模型测评分享功能:安全、高效的结果展示与协作)
人工智能·安全·c#
细节控菜鸡1 小时前
【2025最新】ArcGIS for JS 实现地图卷帘效果,动态修改参数(进阶版)
开发语言·javascript·arcgis
lingggggaaaa2 小时前
小迪安全v2023学习笔记(九十五讲)—— 云原生篇&Docker安全&权限环境检测&容器逃逸&特权模式&危险挂载
笔记·学习·安全·web安全·网络安全·docker·云原生
南屿im2 小时前
把代码变成“可改的树”:一文读懂前端 AST 的原理与实战
前端·javascript
mxd018482 小时前
最常用的js加解密之RSA-SHA256 加密算法简介与 jsjiami 的结合使用指南
开发语言·javascript·ecmascript
摸着石头过河的石头4 小时前
从零开始玩转前端:一站式掌握Web开发基础知识
前端·javascript
南屿im5 小时前
别再被引用坑了!JavaScript 深浅拷贝全攻略
前端·javascript
sophie旭6 小时前
一道面试题,开始性能优化之旅(6)-- 异步任务和性能
前端·javascript·性能优化