本栖湖观富士山日出
起因
新加入了一个项目，翻了两遍代码后也没新的需求进来，
就这么闲了几天后，负责带我入项目的老哥鬼鬼祟祟地摸到了我座位边上...
“是不是没活干？”
“...还，还好”
“刚好第三方库有段日子没更新了，要不你都更到最新版本，适配和测试做一下？”
“...！”
RxSwift4->5
由于是个小项目，本身用的第三方库也不多，API基本没有变化，理论上是个轻松的活，
直到下面一行diff出现
- github "ReactiveX/RxSwift" "4.5.0"
+ github "ReactiveX/RxSwift" "5.0.1"
打开项目Build一下
rxswift5_warning.png
哦嚯？！
GG……
Variable被正式废弃并打出deprecated警告
根据RxSwift开发者的post，
Variable有以下问题
- it's not a standard cross platform concept so it's out of place in RxSwift target.
- it doesn't have an extensible counterpart for event management (PublishRelay). It models state only.
- it is naming is not consistent with *Relay
- it has an inconsistent memory management model compared to other parts of RxSwift (complete on dealloc)
大致意思是Variable不是一个跨平台的概念，也不符合Rx的设计标准，因此在RxSwift的未来发展中没有一席之地。
而RxSwift的中文文档也提到
...许多开发者滥用 Variable，来构建 重度命令式 系统，而不是 Rx 的 声明式 系统。这对于新手很常见，并且他们无法意识到，这是代码的坏味道。...
对非科班出身程序员的我来说很难产生共鸣...归纳下来就是Variable被生父养母踢出了家门。
而很明显的是，这个项目组的先人们就是上文所述的滥用Variable的开发者。
华丽丽地留下了上百条warning
Variable->BehaviorRelay
不管是warning内容还是官方文档都确切的注明了用BehaviorRelay来替代Variable，所以没有什么太多需要考虑。
Variable和BehaviorRelay唯一的区别是Variable被释放时会发出一个Complete事件，而Bahavior没有。
万幸的事本项目没有subscribeVariable的onComplete的事件，不需要进行结构性调整。
大部分改动利用Xcode的replace功能，用正则表达式匹配后修改即可。
1. 修改声明
func setTitle(_ text: Variable<String>) {
...
}
Variable<T>需要改成BahaviorRelay<T>
很简单，把: Variable全用: BahaviorRelay给replace掉，解决
find: :( *)Variable
replace: :$1BehaviorRelay
2. 修改初始化方法
final class AlbumListViewModel: ViewModel {
var myAlbums = Variable<[PhotoAlbum]>([])
var memberAlbums = Variable<[PhotoAlbum]>([])
var numOfAlbum = Variable<[Int]>([])
...
}
由于声明已经改完了，所以不用在意（本身这个项目内Variable的声明就都是隐式的）
只需要把
var myAlbums = Variable<[PhotoAlbum]>([])
修改为
var myAlbums = BehaviorRelay<[PhotoAlbum]>(value: [])
用以下正则修改完成
find: (var|let)(.*)= Variable(.*)\((.*)\)
replace: $1$2= BehaviorRelay$3\(value: $4\)
3. 修改赋值
myAlbums.value = albumResponse.myAlbums
memberAlbums.value = albumResponse.memberAlbums
由于BehaviorRelay的value属性为只读，现在黄色的warning没了，蹦出一大堆红色的error...
应使用BehaviorRelay的accept(:)函数来赋新值，
将以上表达式修改为
myAlbums.accept(albumResponse.myAlbums)
（插入）
有可能出现换行的情况
比如
licenses.value = licenseItems.compactMap { (licenseItem) -> LicenseItem? in
...
}
正则小白的作者不知道怎么将特定结尾的字符串除外，于是先匹配出特殊情况，手动修改。
以下情况可能出现换行
find: (.*)\.value = (.*) (in|\{|\(|\.|\[)$
用正则replace一次搞定
找出规律，用以下正则修改
find: (.*)\.value = (.*)$
replace: $1.accept($2)
4. 修改自增自减
var maxSelectedNum = BehaviorRelay<Int>(value: -1)
...
maxSelectedNum.value += 1
由于value为只读属性，需要设置一个中间变量将value拷贝，然后修改中间变量。
这里新建一个文件，对BehaviorRelay进行扩展，提供两个新的accept函数。
// BehaviorRelay+Update.swift
import RxRelay
extension BehaviorRelay {
/// Accept update of current value
/// - Parameter update: mutate current value in closure
func acceptUpdate(byMutating update: (inout Element) -> Void) {
var newValue = value
update(&newValue)
accept(newValue)
}
/// Accept new value generated from current value
/// - Parameter update: generate new value from current, and return it
func acceptUpdate(byNewValue update: (Element) -> Element) {
accept(update(value))
}
}
然后我们就可以将原代码修改为
maxSelectedNum.acceptUpdate(byMutating: { $0 += 1 })
// or
maxSelectedNum.acceptUpdate(byNewValue: { $0 + 1 }) //隐式return
同样使用正则+replace一键搞定
find: (.*)\.value (\+|\-)= ([0-9]+)
replace: $1.acceptUpdate(byNewValue: { \$0 $2 $3 })
5. 修改泛型为数组，字典等的BehaviorRelay的mutating函数
var selectedMembers = BehaviorRelay<[Member]>(value: [])
...
selectedMembers.value.append(member)
在上面的BehaviorRelay扩展中，已经添加了acceptUpdate(byMutating:)函数，只需将上述代码改为
selectedMembers.value.acceptUpdate(byMutating: { $0.append(member) })
即可
由于这个正则实在不好写，全部手动解决
6. 添加import
RxRelay被包含在RxCocoamodule中，但没有被包含在RxSwift下，
而Variable是被定义在RxSwift中的，
所以要在需要的地方添加import RxRelay
其它
RxSwift 5的其他更新比如，throttle的参数timeInterval改成了DispatchTimeInterval类型等，因为在这个项目中影响较小，修改起来比较方便，在此略过不提
RxSwift5的更新可以参考这篇文章
完工！
网友评论