Android新出功能 ActivityResultContract

背景

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

介绍的内容

  1. 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)
  }
  1. 看完上面后,是不是都不敢相信自己眼睛,直接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)

  1. 上面的旧方式在一个发起权限后,还要到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)

  1. 旧方式的缺陷和上面申请权限差不多。就是在当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. 由于时间问题我没办法全部类都介绍完,这篇文章目的是引起大家的兴趣,后续完全可以自行解读里面源码明白用处以及官网是如何封装的,希望大家都能收获属于自己的知识点。到点搬砖了👷

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,198评论 4 359
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,663评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 106,985评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,673评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,994评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,399评论 1 211
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,717评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,407评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,112评论 1 239
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,371评论 2 241
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,891评论 1 256
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,255评论 2 250
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,881评论 3 233
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,010评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,764评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,412评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,299评论 2 260