Android 升级适配爬坑历程

作者:如果执着
链接:https://www.jianshu.com/p/20252fc5c836
声明:本文已获如果执着授权发表,转发等请联系原作者授权

以下部分适配是针对的是混合开发的项目,使用的是mui及h5+ api和原生代码实现

最近接手了一个公司项目,项目比较老了,从Android 5.0之后就再也没有适配过了,然而重写时间又来不及,然后我的爬坑之旅便开始了。(以下适配方案是按照项目需求顺序来的)

相机部分

适配嘛,肯定得一步一步来,先从Android 6.0开始适配吧。起因是有同事反馈说h5调用原生相机的时候一片漆黑,经过调试发现是权限被拒绝,然后我给他的应用管理中开启,相机就能正常调用了,然而我在测试过程中发现,应用新安装的话bug会重现,后来才发现原来根本没有加入权限的申请这个功能,不得不说还是有点意外的,好吧,言归正传,开始适配吧。

回顾一下6.0最大的改动,不,应该说是新特性-就是加入了权限管理机制,从6.0(API 23)开始,用户开始在应用运行时向其授予权限,而不是在应用安装时授予。这种权限机制可以让用户更好的管理应用的权限,保障用户隐私。

Android将权限分为普通权限和危险权限,危险权限需要在使用时让用户手动允许。危险权限一共9组24个权限,包括拨打电话,相机,定位等等,下面是一个权限的表格,给个参考。https://blog.csdn.net/cui130/article/details/80772186

危险权限列表


我们项目是用的mui的框架,然后相机部分是原生代码实现的,所以适配这个,还需要Dcloud提供的h5+ api 附上官方文档说明(http://www.html5plus.org/doc/zh_cn/camera.html)

还是贴以下代码吧,有些比较懒的小伙伴就不用查了

var Context = plus.android.runtimeMainActivity();
var res = plus.android.invoke("android.support.v4.app.ActivityCompat", "checkSelfPermission", Context, "android.permission.CAMERA");
var PERMISSIONS_STORAGE = new Array();
PERMISSIONS_STORAGE.push("android.permission.CAMERA");
if(res != "0") {
  plus.android.invoke("android.support.v4.app.ActivityCompat", "requestPermissions", Context, PERMISSIONS_STORAGE, 1);
}
plus.scanplug.GetScanCodeFunction(function(result) {}, function(result) {});

这是前段时间的实现方式,后来有小伙伴说由于迁移到了Android X,这个方式用不了,其实只需要把相应的类名更换下就行了,上述代码部分需要同步适配下,同样的贴出源码

具体映射查看官方文档(developer.android.com)

var Context = plus.android.runtimeMainActivity();
var res = plus.android.invoke("androidx.core.app.ActivityCompat", "checkSelfPermission", Context, "android.permission.CAMERA");
var PERMISSIONS_STORAGE = new Array();
PERMISSIONS_STORAGE.push("android.permission.CAMERA");
if(res != "0") {
  plus.android.invoke("androidx.core.app.ActivityCompat", "requestPermissions", Context, PERMISSIONS_STORAGE, 1);
}
plus.scanplug.GetScanCodeFunction(function(result) {}, function(result) {});

以上是在mui的js中做的相应的适配,为了更好的兼容性,原生代码中也需要对权限进行相应的处理,本来项目中是没有这一部分的管理的,我自己使用最原始的方式封装了一个,后来发现兼容性貌似有问题,然后更改成了rxpermissions,最容易上手,最简单的使用。同样的先贴地址 RxPermissions。虽然有一年多没更新了,但是权限这一部分基本还是能用。针对Android 10以后需要做相应的更改,这个之后会提到。

只需要在 module 的 build.gradle中配置如下依赖就成功引用了

implementation 'com.tbruyelle.rxpermissions:rxpermissions:0.7.0'

然后在需要调用的地方这样实现

if (Build.VERSION.SDK_INT > 23){
    RxPermissions.getInstance(mContext)
            .request(Manifest.permission.CAMERA)
            .subscribe(new Action1<Boolean>() {
                @Override
                public void call(Boolean granted) {
                    if (granted){
                        //实际实现功能的代码
                    }
                }
            });
}else {
    //这个说明系统版本在6.0之下,不需要动态获取权限
    //实际实现功能的代码
}

这样有了双重保证,相机的权限应该是没有问题了,因为手上设备有限,如果你在使用中遇到了问题,留言或者私信我,我尽可能解决。

Android O (8.0)升级自动安装问题

到上面做了相机的权限适配后,项目总算是上线了,之前因为相机权限的问题,我也被逼上梁山,翻了无数文档,可算是解决了。上线之后,在一次更新中,部分用户反馈自己无法安装应用,提示升级后点击立即升级,安装包下载完成后会闪退或者还是停留在升级页面。网上一搜无法自动升级,全是8.0以后自动安装受限了,在后来的测试中,发现确实是8.0以上的设备才会出现这个问题,解决方式很简单,只需要在AndroidManifest.xml中添加以下这句就可以了

<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

如果还是没解决,可以再加上下面这一句

<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"

如果做得更细致一些,需要对是否开启未知来源安装权限做提醒,不过好在很多设备厂商对这个在底层已经做了处理了,这里就暂时忽略,有探索精神的可以尝试下。

PS:多说几句。很多人回复我说这个处理方式是开发Android最基本的,也会困扰我吗。我这里说明下,由于公司的业务发展,前端几乎都是h5实现的,比如公众号中的页面,或者是小程序,对于安卓这部分的了解确实少了,从中也可以做一个反面教材吧,提醒各位做开发的小伙伴们,不要忘了自己的本行技能,给别人以嘲笑你的理由。

网络请求部分

这个是在内部测试时发现的,打包后同事的手机安装后都无法请求网络,他们一度以为我打的包是测试包,hah。我一开始也是很茫然的,想了好多搜索的关键词找答案,然而还是没有结果,最后发现访问不到数据的同事设备都是Android P(9.0),通过这个一查,就有了很多的解答了。

最直接的就把问题抛给做后端的同事吧,这个是9.0之后Google禁止明文的数据传输,所以只要把http请求换成 https就可完美解决。但是如果后端不好做或者是不配合,那就只能使用内功心法了。
1)targetSdkVersion 降到27以下
2)就是下面这种最简单的方式了

在AndroidManifest.xml, <application 节点中添加以下一句

android:usesCleartextTraffic="true"

PS:更新一下,很多小伙伴说加上这句没有效果,经过测试需要gradle版本3.2.0及更新的版本才能够正常使用。至于原因嘛,就不深究了。有兴趣的可以去尝试,解决了可以给我留言哈。

3)更改网络安全配置 ①在res文件夹下创建一个xml文件夹,然后创建一个network_security_config.xml文件,文件内容如下

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true" />
</network-security-config>

②接着,在AndroidManifest.xml文件下的application标签增加以下属性

android:networkSecurityConfig="@xml/network_security_config"

我在项目中是用的第二种方案,大家就结合自己的项目,各取所需吧。

Android N(7.0) 权限收缩,需要申请权限更难了

最近有两个同事换了新手机,一个是一加7T,一个是华为meta 30,这两款手机出厂都是Android Q(10),在这两个手机上发现了一个问题,就是自动更新时出现了和适配Android 8.0时同样的问题,反复查找问题,调试,最终也没找到解决方案。之前的更新是用 h5+ api 实现的,迫于这是个第三方的框架,在论坛寻求解决方式无果后,决心把升级这块用原生的实现,然后就到了我的Android 10 适配之旅,至于为什么小标题是 Android 7.0的适配,请耐心往下看。

我的第一步就是直接在网上寻找已经封装好了的实现方案,找了很久,写了个demo,发现可用,简单,方便,交互友好,想想这么好的东西要是集成到我负责项目,想想都激动,于是我就着手准备了。引用来源-->> https://www.jianshu.com/p/cdf707aeb76c

接下来就是爬坑之旅了,开始的详细步骤就是按照这个简书操作的,只是作者可能只是贴了最关键的更新实现的代码。关于升级的这部分的过程就不赘述了,只提我在集成中遇到的问题。

集成之后第一步,很开心的点击studio中绿色的run按钮,然后安装包就开始pupu的开始下载了,通知栏也是很配合的有进度加载,然后。。。然后。。。然后下载完成之后安装时提示错误,我很惊奇,demo中好好的为啥集成后会报错呢。于是赶紧开始了调试大法--debug一下,然后看到错误了。提示的是

FileUriExposedException

一看到这个错误就知道,肯定是apk的下载路径配置的不对,查找之后发现这个是Android 7.0之后权限不够导致的,下载的apk安装包不在包名的目录下,所以没有权限去获取到apk,肯定也就无法调用安装的操作。

同样的百度了一下这个错误,找到了问题所在,Android 7.0之后需要使用FileProvider提供的方法去获得临时访问外部文件夹的权限。这里同样找到了一篇很好的文章来解决这个问题。引用来源-->> https://www.jianshu.com/p/55b817530fa3,这篇文章介绍的很详细,包括之后导致了哪些错误,然后怎么解决的都有了说明。

官方文档说明 https://developer.android.com/training/secure-file-sharing/index.html

简而言之就是在AndroidManifest.xml中配置一个provider组件,用这个组件去申请一个临时的访问外部路径的权限,然后配置一个你需要访问的目录的路径,达到即能够访问这个目录又对用户隐私起到保护的目的。

 <provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="com.xg.shfcoc.fileProvider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

接着在res目录下新建一个xml文件夹,新建一个和provider中配置的文件名一样的文件,我创建的文件名就是file_paths。

<?xml version="1.0" encoding="utf-8"?>
<paths >
    <external-files-path name="external-files-path" path="VersionChecker/"/>

</paths>

中可以定义以下子节点


再具体点的话就是下面的解释了

1.<root-path/> 代表设备的根目录new File("/");
2.<files-path/> 代表context.getFilesDir()
3.<cache-path/> 代表context.getCacheDir()
4.<external-path/> 代表Environment.getExternalStorageDirectory()
5.<external-files-path>代表context.getExternalFilesDirs()
6.<external-cache-path>代表getExternalCacheDirs()

再多说几句,因为这里有坑,所以提前提醒下 1)name代表什么 name 属性用于给 path 属性所指定的子目录名称取一个别名。后续生成 content:// URI 时,会使用这个别名代替真实目录名。这样做的目的,很显然是为了提高安全性 2)path是什么意思 path 属性用于指定当前子元素所代表目录下需要共享的子目录名称。注意:path 属性值不能使用具体的独立文件名,只能是目录名。

再多的就不说了,实在还是不懂,本文与各大搜索引擎达成战略合作,可以自行搜索结果。

假如我要替换的目录是/storage/emulated/0/diary sdcard/photo/那么配置应该写成

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<external-path name="external_files" path="VersionChecker"/>
</paths>

这里特别说明下,木来我的目录配置是这个的,之后在Android 10上会出现闪退现象,就换成了这个配置,原因不明,但是这样就能解决,不多纠结了,能解决问题才是最重要的。

之后就是在你需要存储文件地方做如下的获取方式

getExternalFilesDir("文件夹名字").getAbsolutePath()+"/"

然后获取自动更新的方式如下所示

Intent installIntent = new Intent(Intent.ACTION_VIEW);
installIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
// System.out.println(result.getPath());
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    installIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK );
     //添加这一句表示对目标应用临时授权该Uri所代表的文件
    installIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
    Uri contentUri = FileProvider.getUriForFile(DownApkService.this,
            BuildConfig.APPLICATION_ID + ".fileProvider", new File(result.getPath()));

    installIntent.setDataAndType(contentUri, "application/vnd.android.package-archive");
} else {
    installIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
    installIntent.setDataAndType(Uri.fromFile(new File(result.getPath())), "application/vnd.android.package-archive");
}

这里有个坑,先提醒下大家

installIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK );一定是在installIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);之前设置,还有上一句一定是addFlags而不是setFlags,不然在Android 10 的设备上会出现解析软件包异常。

在多说一句,BuildConfig一定是引用的项目中你自己的包,而不是其他jar包中的方法,不然也会抛异常,小伙伴有兴趣的也可以尝试一下。

还是觉得要再补充一下在这个项目中使用的网络请求框架是Xutils,xUtils3 github传送门:https://github.com/wyouflf/xUtils3

具体解决方法如下

只需要在 module 的 build.gradle中配置如下依赖就成功引用了

implementation 'org.xutils:xutils:3.8.3'

然后写一个Activity,在这里去初始化这个Xutils

@Override
public void onCreate() {
   super.onCreate();

   x.Ext.init(this);
   x.Ext.setDebug(BuildConfig.DEBUG);

}

这里的Activity的onCreate()中不能有setContentView(R.layout.xxx) 否则会报错,切记。

由上面的初始化引出了下面的问题。由于是本项目使用的是mui还有原生的混合开发,Dcloud官方称呼这种是离线打包,怎么叫不重要,重要的是用法,Xutils在使用时需要初始化,一般的处理方式是在AndroidManifest.xml<application 节点中添加 android:name=".ApplicationContext",但是我们的项目必须要这样配置android:name="io.dcloud.application.DCloudApplication",才能使用mui提供的plus调用原生方法。所以解决方法是,这里贴出全部的源码

package com.xxx;

import android.content.Context;
import org.xutils.x;
import io.dcloud.application.DCloudApplication;

public class ApplicationContext extends DCloudApplication {
   private static ApplicationContext context;

   public static ApplicationContext getContext(){
       return context;
   }

   @Override
   protected void attachBaseContext(Context base) {
       super.attachBaseContext(base);
       context = this;
   }

   @Override
   public void onCreate() {
       super.onCreate();

       x.Ext.init(this);
       x.Ext.setDebug(BuildConfig.DEBUG);

   }
}

这样就可以android:name=".ApplicationContext"这样配置了。以上就完美的解决了Xutils的引用,也不会影响mui的原生调用。

这是适配的第一篇,重新捡起丢失的Android技能,后续会尽快更新。

移动端常见崩溃指标

崩溃分析,是将 Android 和 iOS 平台常见的 APP 崩溃问题进行归类分析,帮助企业根据崩溃指标快速发现、定位问题。

发布于:3天以前  |  48次阅读  |  详细内容 »

Android死锁初探

说到死锁,大家可能都不陌生,每次遇到死锁,总会让计算机产生比较严重的后果,比如资源耗尽,界面无响应等。

发布于:7天以前  |  100次阅读  |  详细内容 »

Android AES加密(Kotlin)

halo~最近工作上写的东西比较简单,感觉分享不出来,最近刚好看到数据加密这一块,感觉挺不错的,也挺好用的,所以下面分享给大家!

发布于:13天以前  |  83次阅读  |  详细内容 »

Android 持续滑动布局 ConsecutiveScrollerLayout 的使用

在开发项目的时候,有时候会遇到一些比较复杂的页面,需要多个不同的列表或者滑动布局、甚至是WebView,组成一个完整的页面。要实现这样一个复杂的页面,在以前我们可能会通过布局嵌套的方式,在一个大的ScrollView下嵌套多个RecyclerView、WebView、ScrollView来实现。但是这种嵌套的方式不仅会严重影响布局的性能,而且处理滑动事件的冲突也是一件头疼的事,处理不好会严重影响用户操作的体验。

发布于:16天以前  |  105次阅读  |  详细内容 »

Android 升级适配爬坑历程

最近接手了一个公司项目,项目比较老了,从Android 5.0之后就再也没有适配过了,然而重写时间又来不及,然后我的爬坑之旅便开始了。(以下适配方案是按照项目需求顺序来的)

发布于:19天以前  |  185次阅读  |  详细内容 »

2020年,一文点破跨平台开发框架现状

多年来,跨平台移动开发已经获得了最流行软件开发趋势之一的声誉。这并不令人意外,因为采用跨平台开发技术使得软件工程师使用同一代码就能为不同平台构建应用程序,从而节省时间、金钱以及不必要的工作。

发布于:1月以前  |  206次阅读  |  详细内容 »

unicode编码在Android中的应用

Unicode(统一码、万国码、单一码)是计算机科学领域里的一项业界标准,包括字符集、编码方案等。Unicode 是为了解决传统的字符编码方案的局限而产生的,它为每种语言中的每个字符设定了统一并且唯一的二进制编码,以满足跨语言、跨平台进行文本转换、处理的要求。1990年开始研发,1994年正式公布。

发布于:2月以前  |  332次阅读  |  详细内容 »

Android动态权限详解

很多App在首次启动时一通弹窗,申请各式各样的权限。后来苹果为改善用户体验,在App Store审核时要求App必须在使用前一刻才能申请权限,有效改善了此类问题。比如一款直播App,当你启动App时并不需要相机、录音权限,等到你开播时才需要申请这两个权限。这一场景,其实就类似今天要提到的Android动态授权。

发布于:2月以前  |  370次阅读  |  详细内容 »

最多阅读

简化Android的UI开发 7月以前  |  193453次阅读
Android设计与开发工作流 7月以前  |  2302次阅读
Google Enjarify:可代替dex2jar的dex反编译 1年以前  |  2294次阅读
Android多渠道打包工具:apptools 1年以前  |  1926次阅读
Android权限 - 第一篇 1年以前  |  1895次阅读
Google Java编程风格规范(中文版) 1年以前  |  1877次阅读
Stetho 1年以前  |  1813次阅读
Android UI基本技术点 1年以前  |  1805次阅读
30分钟搭建一个android的私有Maven仓库 1年以前  |  1769次阅读
2015 Google IO带来的新 Android 开发工具 1年以前  |  1709次阅读
你应该知道的布局和属性 1年以前  |  1656次阅读
听FackBook工程师讲*Custom ViewGroups* 1年以前  |  1654次阅读
MVP在Android平台上的应用 1年以前  |  1635次阅读
Gradle小知识#3:任务的顺序 1年以前  |  1630次阅读