-
-
[原创]【CoCollider】让系统和应用适配如此简单
-
发表于: 2024-11-4 10:21 929
-
在各平台应用开发过程中,随着业务的功能增加,不免会涉及到非公开的
API
依赖,针对某些应用或厂商系统的适配,每个版本都需要投入精力去排查,CoCollider
可以让我们的适配效率从几个星期提升到几小时即可完成。
项目已开源:
☞ Github:https://www.github.com/iofomo/fireyer ☜
☞ Github:https://www.github.com/iofomo/wing ☜
如果您也喜欢,别忘了给我们点个星。
01. 写在前面
在Android
平台(后续会支持iOS
平台)日常开发过程中,不免会接触到一些 Hidden
(或私有函数和类)的类,JVM
层通过反射,Native
则通过查找函数 symbol
来完成。特别是涉及系统Framework
层和底层库较多的实现(特别是安全产品和系统工具类应用),成为每次系统和厂商ROM
更新适配的重灾区,严重影响适配效率。
以往,开发同学要么先一个个自行排查代码后再提交测试,这个过程重复,耗时且容易遗漏。要么先让测试同学先进行用例覆盖测试,然后开发同学通过BUG
来进行分析,这会导致整个团队效率更加低下。
由于我们虚拟化产品的特性,工程中涉及系统和应用适配的接口众多,工作量很大,主要有两部分:
- 如何快速寻找到系统新增的模块,感兴趣的可以查看我们的另一个开源项目 【ASeeker】 https://www.github.com/iofomo/aseeker
- 如何快速定位现有使用的
API
是否已发生变化,这就是**【CoCollider】
** 要解决的问题。
CoCollider
已经在我们内部使用,极大提升我们系统适配效率,原本需要几个星期的工作量,现在只需几小时便可适配完成,原理简单,堪称适配效率神器。Android 15
发布在即,现在分享给大家。
CoCollider
同样适用于其他平台(如:iOS)和某些深度定制的应用版本适配。
02. 我们需要
对于系统的API
,我们的需求是:
- 类的属性是否有变化。
- 类的成员属性是否有变化。
- 类的方法属性是否有变化。
Native
库和函数是否存在。
对于开发工程师的工作量,首次需要在源码中添加注释标签,这个工作不可省略,却一劳永逸。后续需要在每次涉及适配的代码处加上@CoCollider
标签就行。
Java代码标签格式:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | 格式: // @CoCollider {class name},{-/+}{field name/method name},... 范例: # 仅查看类是否变更 // @CoCollider android.utils.Abc # 仅查看类所有成员是否变更 // @CoCollider android.utils.Abc,-* # 查看类和某成员或方法是否变更(支持多个) // @CoCollider android.utils.Abc,-mFile // @CoCollider android.utils.Abc,-mFile,mName // @CoCollider android/utils/Abc,-mFile // @CoCollider android.utils.Abc,+getFile,-mName // @CoCollider android/utils/Abc,+getFile,+getName,-mName # 支持缺省自动填充:(按照顺序依次填充) Class.forName( "android.utils.Abc" ); // @CoCollider # 等同于: // @CoCollider android.utils.Abc ReflectUtils.getStaticField( "android.utils.Abc" , "mName" ); // @CoCollider ,- # 等同于: // @CoCollider android.utils.Abc,-mName |
Native 代码标签格式:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | 格式: // @CoCollider ~{lib name},{-/+}{field name/method name},... 范例: # 查看方法是否变更 // @CoCollider ~libc.so,+open // @CoCollider ~/system/lib/libc.so,+open // @CoCollider ~/system/lib/libc.so,+open,+close # 支持缺省自动填充:(按照顺序依次填充) utils_dlsym( "libc.so" , "open" ); // @CoCollider ~,+ # 等同于:// @CoCollider ~libc.so,+open utils_dlsym( "open" ); // @CoCollider ~libc.so,+ # 等同于:// @CoCollider ~libc.so,+open |
03. 配置运行
电脑下载配置
wing
。手机安装
Fireyer
,或集成CoCollider
模块的应用,链接adb
。扫描代码:
12345678# 命令格式:扫描当前目录下的代码(默认支持 h/c/cpp/java/kt/aidl,也可以追加文件类型)
$ wing -cocollider scan
$ wing -cocollider scan
/home/space
# 或
$ python .
/cocollider
.py scan
$ python .
/cocollider
.py scan
/home/space
# 在当前目录输出结果
>>> cocollider-scan-20241023-112044.txt
解析运行:
1234567# 命令格式:调用 Fireyer 应用
$ wing -cocollider run
/home/cocollider-scan-20241023-112044
.txt
# 或
$ python .
/cocollider
.py run
/home/cocollider-scan-20241023-112044
.txt
# 在当前目录输出结果
>>> cocollider-run-20241023-112044.txt
使用对比工具查看结果即可快速定位变更内容。
04. 扫描结果
cocollider-scan-20241023-112044.txt
中的文件内容为:
############################################################ = android.utils.Abc - mFile > application/fireyer/test/test1.java,14 - mName3 > application/fireyer/test/test1.java,14 - mPath > application/fireyer/test/test1.java,14 ############################################################ = android.utils.Abc1 - mFile > application/fireyer/test/test1.java,5 ...
05. 运行结果
cocollider-run-20241023-112044.txt
中的文件内容(已对class
,lib
库,function
,field
和method
排序,便于使用对比工具对比)
############################################################ ~ libwilhelm.so [OK] + _ZN7androidxx6BufferE [OK], public final class libcore.io.Linux > cmpt/xxx/jni/xxx/jni/src/xxx.cpp,362 + _ZN7android1xx6BufferE [OK], public final class libcore.io.Linux > cmpt/xxx/jni/xxx/jni/src/xxx.cpp,350 ############################################################ = ohos.abilityshell.HarmonyApplication [Fail] - applicationHandler [Fail] > scene/xxx/xxx.java,36 ############################################################ = ohos.system.Parameters [Fail] + nativeGet [Fail] > scene/xxx.cpp,250 ...
06. 对比结果
分别在不同版本系统运行 python cocollider.py run
之后,使用对比工具(如:Beyond Compare
)对内容进行比较查看,可以快速找到新增,修改和删除项,从而可以快速进行排查和修复。