前言
在2020年新冠疫情的时候,我宅在家中无所事事,于是乎我写了一个flutter的版本更新插件: flutter_xupdate, 并且将其发布在了Google建立的Dart插件平台上,一年以来收到的反响还算不错,具体可看下图所示:
但与此同时,也收到了很多使用者的疑问.
为此,我简单看了一下问题,发现使用者之前可能压根就没有做过Android原生开发,对Android的一些基础知识非常缺乏,就会导致很多问题.
这里,为了能够让大家更好地去使用flutter_xupdate实现一键版本更新,我特地为大家盘点了使用过程中可能出现的几大问题,为大家提前排排雷.不仅如此,我还特地录了一期视频,喜欢看视频的小伙伴是不是赶紧三连支持一下呢?
视频地址如下: https://www.bilibili.com/video/BV1gy4y1g7pB/
常见问题
好了,言归正传,让我们简单瞧一瞧,常见的问题都有哪些?
- 1.无法显示版本更新弹窗。
- 2.版本更新提示显示异常。
- 3.下载完毕无法安装更新。
- 4.强制更新不起作用。
- 5.国际化问题。
下面我将一一为大家做出解答.
无法显示版本更新弹窗
出现无法显示版本更新弹窗的问题可能有多种情况. 主要的表现形式是: 更新发生报错或者显示当前无版本更新.
1.接口的问题
前提条件: 使用的框架提供的默认接口(默认更新).
请求的url没有返回默认格式的json,那样json序列化就会有问题,导致版本信息获取失败,无法判断更新状态.
因为flutter_xupdate底层调用的是XUpdate, 其默认json格式如下所述:
{
"Code": 0, //0代表请求成功，非0代表失败
"Msg": "", //请求出错的信息
"UpdateStatus": 1, //0代表不更新，1代表有版本更新，不需要强制升级，2代表有版本更新，需要强制升级
"VersionCode": 3, //本地也会对版本号进行校验,确保升级的时候,版本号自增
"VersionName": "1.0.2",
"ModifyContent": "1、优化api接口。\r\n2、添加使用demo演示。\r\n3、新增自定义更新服务API接口。\r\n4、优化更新提示界面。",
"DownloadUrl": "https://raw.githubusercontent.com/xuexiangjys/XUpdate/master/apk/xupdate_demo_1.0.2.apk",
"ApkSize": 2048
"ApkMd5": "..." //应用apk的md5值没有的话，就无法保证apk是否完整，每次都会重新下载。框架默认使用的是md5加密。
}
以上字段有任何一个不符合的都有可能导致json解析失败,无法显示版本更新弹窗. 除非你使用自定义接口或者直接传入UpdateEntity进行更新.
版本号的问题
前提条件: 使用的框架提供的默认接口(默认更新).
同样的, 使用的默认接口,返回的json格式也正常,也能正常解析, 唯独是这个返回的VersionCode没有自增,导致本地版本号更新校验失败,无法显示版本更新弹窗.
混淆打包的问题
前提条件: 使用的框架提供的默认接口(默认更新),且debug运行一切正常.
出现这种情况, 主要是因为android原生项目中设置了代码混淆. 但是使用flutter build apk --release进行打包, 混淆配置并不会生效（因为该指令默认使用的是R8压缩，会有问题）。
这里有三个方法可以解决：
1.使用
flutter build apk --no-shrink指令代替。2.主动关闭R8压缩，使用D8压缩进行代替。方法就是进入到项目的
android目录下，修改gradle.properties如下：
org.gradle.jvmargs=-Xmx1536M
# 开启D8压缩
android.enableD8=true
android.useAndroidX=true
android.enableJetifier=true
# 关闭R8压缩
#android.enableR8=true
- 3.直接使用android的原生打包方式进行打包。方法就是进入到当前项目的android目录下，使用
./gradlew assembleRelease命令进行打包。
版本更新提示显示异常
前提条件: 使用自定义更新弹窗样式, 设置了topImageRes属性.
出现的现象一般是在debug下正常显示,但是在release下却显示异常,详情如下:
出现这种问题, 主要原因是更新弹窗的顶部样式自定义使用的是反射的引用方式，所以在打release包的时候，如果我们不设置shrinkResources为false的话，打包程序就会默认清除你自定义的顶部图片，导致在release下图片不显示。
所以这个时候，我们只需要把shrinkResources显示设置为false就可以了, 具体可参考下图：
下载完毕无法安装更新
出现下载完毕无法安装更新的问题可能有多种情况. 主要的表现形式是: 无法进入到应用安装页面或者提示安装失败(签名不一致/文件解析失败).
1.apk下载的问题
如果apk没有被完整地下下来的话,或者下载下来的apk就是受损无法安装的,是肯定没法正常安装的.
所以这里我们可以先开启debug日志,然后获取到下载的apk路径,然后找到指定的文件打开看一下能否正常安装.(首先保证下载的文件是正确的).
2.MD5值设置的问题
注意这里的MD5值指的是应用APK文件的MD5值，而非应用签名文件的MD5值！！
之所以设置MD5值下载校验,就是为了防止文件下载被人篡改或者不完整,所以框架才会去对下载的APK进行MD5值的校验.
但很多人并不了解这其中的原理,所以初次使用的时候,很容易设置MD5的值是应用签名文件的MD5值,这就导致MD5值校验失败,应用无法进入到应用安装页面.
3.签名的问题
相信做过Android原生开发的人都知道,同一个包名下的应用,是不可以直接覆盖安装(更新升级)不同签名的应用的. 同包名的应用只可以覆盖安装相同签名的应用apk.
如果你debug的时候没有配置和release相同的签名,那么是不可以直接覆盖升级到release包上的.
4.设备终端的问题
因为Android的设备终端的rom以及版本都各不相同,可能在某些定制的rom机器上使用通用的apk安装方式并不起作用. 这种问题出现的概率相对较低,当上述3点都没有问题的话,可以尝试使用不同机型的机器来尝试能否安装,以排除特定设备机型的问题.
强制更新不起作用
前提条件: 使用自定义接口或者直接传入UpdateEntity进行更新.
这是因为UpdateEntity对象的isForce和isIgnorable属性是互斥的.如果设置了isIgnorable为true,这个时候再设置isForce为true那么isForce就会失效.因为强制更新的版本是不可能可忽略的,而可忽略的版本更新也不可能是强制更新的.
国际化问题
因为flutter_xupdate底层调用的是XUpdate原生库, 更新UI是原生写的,因此要实现多语言国际化的话,需要使用原生的国际化进行配置.
错误码
最后附上常见的错误码,方便debug调试的时候发现问题.
| 错误码 | 备注 |
|---|---|
| 2000 | 查询更新失败 |
| 2001 | 没有wifi |
| 2002 | 没有网络 |
| 2003 | 正在进行版本更新 |
| 2004 | 无最新版本 |
| 2005 | 版本检查返回空 |
| 2006 | 版本检查返回json解析失败 |
| 2007 | 已经被忽略的版本 |
| 2008 | 应用下载的缓存目录为空 |
| 3000 | 版本提示器异常错误 |
| 3001 | 版本提示器所在Activity页面被销毁 |
| 4000 | 新应用安装包下载失败 |
| 4001 | 读写权限申请失败 |
| 4002 | 取消下载 |
| 5000 | apk安装失败 |
| 5100 | 未知错误 |
最后
以上就是我整理出来的全部内容, 喜欢的小伙伴一定要记得去项目的主页: https://github.com/xuexiangjys/flutter_xupdate star支持一下哦~
我是xuexiangjys，一枚热爱学习，爱好编程，致力于Android架构研究以及开源项目经验分享的技术up主。获取更多资讯，欢迎微信搜索公众号：【我的Android开源之旅】
