Android新出功能 ActivityResultContract

背景

谷歌最近更新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）

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

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

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

看完上面后，是不是都不敢相信自己眼睛，直接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", "返回数据失败")
            }
        }
    }

总结

要使用ActivityResultContract必须引入两个库
implementation "androidx.activity:activity:1.2.0"
implementation "androidx.fragment:fragment:1.3.0"
这次新功能的发布可以看出后续google都是为了开发者更为便捷，更解耦方向去做代码优化了，值得期待往后android的发展。自学官网地址
如果想运行我demo中的代码，欢迎大家clone我的项目来跑一跑GitHub项目地址
register返回的对象还能保存到Activity的viewModel里，这样子可以利用ViewModel来进行Activity与Fragment交互，fragment也可以操作权限申请等行为了。
由于时间问题我没办法全部类都介绍完，这篇文章目的是引起大家的兴趣，后续完全可以自行解读里面源码明白用处以及官网是如何封装的，希望大家都能收获属于自己的知识点。到点搬砖了👷