Android 新出功能 ActivityResultContract

Android社区 收藏文章

背景

谷歌最近更新android 12的同时,看android开发者掘进推送时候,发现一个新增一个我之前留意过的接口和一些类。好奇的我小手一动,就想一探究竟了。

介绍的内容

ActivityResultContracts类,该类高度封装了Intent,让开发者更为方便访问系统App进行数据交互、更为方便的进行Activity之间的数据交互、更为方便的申请权限、更为方便去访问图库、相机等。下面我会从几个简单用例入手讲解。

与系统App数据交互

介绍对象:ActivityResultContracts.PickContact 场景:假如某个需求场景中需要获取系统通讯录联系人,并且返回用户选择的通讯录联系人。

一、旧方式

Intent intent = new Intent();
intent.setAction("android.intent.action.PICK");
intent.addCategory("android.intent.category.DEFAULT");
intent.setType("vnd.android.cursor.dir/phone_v2");
startActivityForResult(intent, REQUEST_ADDRESSBOOK);

提示: 返回用户选择通讯录的联系人,是从onActivityResult中区分requestCode,就能通过Intent获取返回的数据了。这里不罗列齐全,因为会导致篇幅过长,详细可以看这篇android如何访问通讯录,这篇文章获取手机号是获取不了的,只能辅助你看下之前访问讯录多麻烦。

二、新方式(ActivityResultContracts.PickContact)

1 . 当你看完上面android如何访问通讯录后,你会觉得巨麻烦,而且又长又臭。在之前你没办法,只能屈服、卑微的接收,但是现在不同了,大人时代改变了。

//第一步,注册交互数据回调监听
val contact = registerForActivityResult(ActivityResultContracts.PickContact()) { uri : Uri? ->
      //如果Uri为null,说明用户没有操作直接返回,这里代码会在下面补贴出来,因为涉及跨进程交互,代码比较长,不想贴这里影响阅读效率
     ……
}

//第二步,点击访问通讯录
mBtn4.setOnClickListener {
            contact.launch(null)
  }

2 . 看完上面后,是不是都不敢相信自己眼睛,直接launch就能跳转通讯录了,从register上就能收到通讯录的数据了,但是你很快发现点击某个通讯录用户后就崩溃的。看完下面崩溃信息,是不是觉得最终还是没能逃过权限的问题?别急,下面我介绍你如何快速便捷的调用申请权限的接口,而且很方便的能得到用户请求同意还是拒绝。

java.lang.SecurityException: Permission Denial: reading com.android.providers.contacts.ContactsProvider2 uri content://com.android.contacts/data/phones from pid=13897, uid=10411 requires android.permission.READ_CONTACTS, or grantUriPermission()
        at android.os.Parcel.createException(Parcel.java:1953)
        ……

申请权限

这里结合上面通讯录问题,就申请访问通讯录权限为例子介绍新的ActivityResultContract功能。

一、旧方式申请权限

<!--访问通讯录-->
<uses-permission android:name="android.permission.READ_CONTACTS"/>

//6.0以上要动态获取权限
protected final int REQUEST_PERMISSION_ADDRESSBOOK = 10;
protected final int REQUEST_ADDRESSBOOK = 11;  

//申请权限
ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_CONTACTS}, REQUEST_PERMISSION_ADDRESSBOOK);

//申请权限结果
 override fun onRequestPermissionsResult(
        requestCode: Int,
        permissions: Array<out String>,
        grantResults: IntArray
    ) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        if(requestCode == REQUEST_PERMISSION_ADDRESSBOOK && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
              //用户同意访问通讯录权限
        }
   }

二、新方式(ActivityResultContracts.RequestPermission)

上面的旧方式在一个发起权限后,还要到onRequestPermissionsResult方法里面去做权限区分,耦合严重,而且麻烦啰嗦。下面看完我们新方式申请权限后,你会发出疑惑:“哈?这么简单,这么容易,我不信”。不信你可以试试,反正后续真香定律。

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

//注册一个申请权限后结果回调
val permission =
            registerForActivityResult(ActivityResultContracts.RequestPermission()) { result: Boolean ->
                   // true: 用户同意   false:用户不同意 or 用户不处理
            }

//
     mBtn3.setOnClickListener {
            //申请访问通讯录权限
            permission.launch(Manifest.permission.READ_CONTACTS)
        }

提示:上面是申请单个权限而已,官方还提供了申请多个权限的接口,具体可以看下ActivityResultContracts.RequestMultiplePermissions。简单介绍下就是launch是传一个string数组(想要申请的权限),register回来的是一个Map<String,Boolean>的map数组,一个权限对应一个操作结果。

Activity之间的数据交互

一、旧方式Activity之间的数据交互

MainActivity的代码

//定义请求的CODE码,用于在onActivityResult方法里区分回来的数据哪个是预期的行为
private val JUMP_TO_ANOTHER_ACTIVITY_CODE = 1

//MainActivity 跳转到 TestActivity
Intent intent = new Intent(this, TestActivity::class.java)
startActivityForResult(intent, JUMP_TO_ANOTHER_ACTIVITY_CODE);

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        when (requestCode) {
            JUMP_TO_ANOTHER_ACTIVITY_CODE -> {
                if(resultCode == Activity.RESULT_OK) {
                    //成功
                }else{
                    //失败
                }
            }
        }
    }

TestActivity的返回数据代码

click_finish.setOnClickListener {
            //通过intent返回数据
            val intent = Intent()
            intent.putExtra("magic", "Hello world")
            setResult(Activity.RESULT_OK, intent)
            finish()
 }

二、新方式(ActivityResultContracts.StartActivityForResult)

旧方式的缺陷和上面申请权限差不多。就是在当requestCode越来越多时候,onActivityResult就会变得冗余臃肿。现在新方式是单一职责,register只处理对应launch出去的activity返回的数据。

val betweenActivityResultLauncher =
            registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result: ActivityResult ->
                parserLastActivityData(result)
            }

        //activity之间intent交互
        jumpToActivity.setOnClickListener {
            val intent = Intent(this, TestActivity::class.java)
            betweenActivityResultLauncher.launch(intent)
        }

//解析register返回的ActivityResult
private fun parserLastActivityData(result: ActivityResult) {
        when (result.resultCode) {
            Activity.RESULT_OK -> {
                val msg = result.data?.getStringExtra("magic") ?: "没返回intent"
                Toast.makeText(this, msg, Toast.LENGTH_LONG).show()
            }
            else -> {
                Log.i("magic", "返回数据失败")
            }
        }
    }

总结

1 . 要使用ActivityResultContract必须引入两个库

implementation "androidx.activity:activity:1.2.0"
implementation "androidx.fragment:fragment:1.3.0"

2 . 这次新功能的发布可以看出后续google都是为了开发者更为便捷,更解耦方向去做代码优化了,值得期待往后android的发展。自学官网地址

3 . 如果想运行我demo中的代码,欢迎大家clone我的项目来跑一跑GitHub项目地址

4 . register返回的对象还能保存到Activity的viewModel里,这样子可以利用ViewModel来进行Activity与Fragment交互,fragment也可以操作权限申请等行为了。

5 . 由于时间问题我没办法全部类都介绍完,这篇文章目的是引起大家的兴趣,后续完全可以自行解读里面源码明白用处以及官网是如何封装的,希望大家都能收获属于自己的知识点。到点搬砖了

相关标签

扫一扫

在手机上阅读