Android新出功能 ActivityResultContract

背景

谷歌最近更新android 12的同時，看android開發(fā)者掘進(jìn)推送時候末早，發(fā)現(xiàn)一個新增一個我之前留意過的接口和一些類烟馅。好奇的我小手一動，就想一探究竟了然磷。

介紹的內(nèi)容

ActivityResultContracts類郑趁，該類高度封裝了Intent，讓開發(fā)者更為方便訪問系統(tǒng)App進(jìn)行數(shù)據(jù)交互姿搜、更為方便的進(jìn)行Activity之間的數(shù)據(jù)交互寡润、更為方便的申請權(quán)限、更為方便去訪問圖庫舅柜、相機(jī)等梭纹。下面我會從幾個簡單用例入手講解。

與系統(tǒng)App數(shù)據(jù)交互

介紹對象：ActivityResultContracts.PickContact
場景：假如某個需求場景中需要獲取系統(tǒng)通訊錄聯(lián)系人致份，并且返回用戶選擇的通訊錄聯(lián)系人变抽。

一、舊方式

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);

提示: 返回用戶選擇通訊錄的聯(lián)系人氮块，是從onActivityResult中區(qū)分requestCode绍载，就能通過Intent獲取返回的數(shù)據(jù)了。這里不羅列齊全滔蝉，因?yàn)闀?dǎo)致篇幅過長击儡，詳細(xì)可以看這篇android如何訪問通訊錄，這篇文章獲取手機(jī)號是獲取不了的蝠引，只能輔助你看下之前訪問訊錄多麻煩阳谍。

二、新方式（ActivityResultContracts.PickContact）

當(dāng)你看完上面android如何訪問通訊錄后螃概，你會覺得巨麻煩矫夯，而且又長又臭。在之前你沒辦法吊洼，只能屈服茧痒、卑微的接收，但是現(xiàn)在不同了融蹂，大人時代改變了。

//第一步弄企，注冊交互數(shù)據(jù)回調(diào)監(jiān)聽
val contact = registerForActivityResult(ActivityResultContracts.PickContact()) { uri : Uri? ->
      //如果Uri為null超燃，說明用戶沒有操作直接返回，這里代碼會在下面補(bǔ)貼出來拘领，因?yàn)樯婕翱邕M(jìn)程交互意乓，代碼比較長，不想貼這里影響閱讀效率
     ……
}

//第二步，點(diǎn)擊訪問通訊錄
mBtn4.setOnClickListener {
            contact.launch(null)
  }

看完上面后届良，是不是都不敢相信自己眼睛笆凌，直接launch就能跳轉(zhuǎn)通訊錄了，從register上就能收到通訊錄的數(shù)據(jù)了,但是你很快發(fā)現(xiàn)點(diǎn)擊某個通訊錄用戶后就崩潰的士葫∑蚨看完下面崩潰信息，是不是覺得最終還是沒能逃過權(quán)限的問題慢显？別急爪模，下面我介紹你如何快速便捷的調(diào)用申請權(quán)限的接口，而且很方便的能得到用戶請求同意還是拒絕荚藻。

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)
        ……

申請權(quán)限

這里結(jié)合上面通訊錄問題屋灌，就申請?jiān)L問通訊錄權(quán)限為例子介紹新的ActivityResultContract功能。
一应狱、舊方式申請權(quán)限

<!--訪問通訊錄-->
<uses-permission android:name="android.permission.READ_CONTACTS"/>

//6.0以上要動態(tài)獲取權(quán)限
protected final int REQUEST_PERMISSION_ADDRESSBOOK = 10;
protected final int REQUEST_ADDRESSBOOK = 11;  

//申請權(quán)限
ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_CONTACTS}, REQUEST_PERMISSION_ADDRESSBOOK);

//申請權(quán)限結(jié)果
 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) {
              //用戶同意訪問通訊錄權(quán)限
        }
   }

二共郭、新方式（ActivityResultContracts.RequestPermission）

上面的舊方式在一個發(fā)起權(quán)限后，還要到onRequestPermissionsResult方法里面去做權(quán)限區(qū)分疾呻，耦合嚴(yán)重除嘹，而且麻煩啰嗦。下面看完我們新方式申請權(quán)限后罐韩，你會發(fā)出疑惑：“哈憾赁？這么簡單，這么容易散吵，我不信”龙考。不信你可以試試，反正后續(xù)真香定律矾睦。

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

//注冊一個申請權(quán)限后結(jié)果回調(diào)
val permission =
            registerForActivityResult(ActivityResultContracts.RequestPermission()) { result: Boolean ->
                   // true: 用戶同意   false：用戶不同意 or 用戶不處理
            }

//
     mBtn3.setOnClickListener {
            //申請?jiān)L問通訊錄權(quán)限
            permission.launch(Manifest.permission.READ_CONTACTS)
        }

提示：上面是申請單個權(quán)限而已晦款，官方還提供了申請多個權(quán)限的接口，具體可以看下ActivityResultContracts.RequestMultiplePermissions枚冗。簡單介紹下就是launch是傳一個string數(shù)組（想要申請的權(quán)限）缓溅，register回來的是一個Map<String,Boolean>的map數(shù)組，一個權(quán)限對應(yīng)一個操作結(jié)果赁温。

Activity之間的數(shù)據(jù)交互

一坛怪、舊方式Activity之間的數(shù)據(jù)交互
MainActivity的代碼

//定義請求的CODE碼，用于在onActivityResult方法里區(qū)分回來的數(shù)據(jù)哪個是預(yù)期的行為
private val JUMP_TO_ANOTHER_ACTIVITY_CODE = 1

//MainActivity 跳轉(zhuǎn)到 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的返回?cái)?shù)據(jù)代碼

click_finish.setOnClickListener {
            //通過intent返回?cái)?shù)據(jù)
            val intent = Intent()
            intent.putExtra("magic", "Hello world")
            setResult(Activity.RESULT_OK, intent)
            finish()
 }

二股囊、新方式（ActivityResultContracts.StartActivityForResult）

舊方式的缺陷和上面申請權(quán)限差不多袜匿。就是在當(dāng)requestCode越來越多時候，onActivityResult就會變得冗余臃腫≈烧睿現(xiàn)在新方式是單一職責(zé)居灯，register只處理對應(yīng)launch出去的activity返回的數(shù)據(jù)。

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", "返回?cái)?shù)據(jù)失敗")
            }
        }
    }

總結(jié)

要使用ActivityResultContract必須引入兩個庫
implementation "androidx.activity:activity:1.2.0"
implementation "androidx.fragment:fragment:1.3.0"
這次新功能的發(fā)布可以看出后續(xù)google都是為了開發(fā)者更為便捷，更解耦方向去做代碼優(yōu)化了怪嫌，值得期待往后android的發(fā)展义锥。自學(xué)官網(wǎng)地址
如果想運(yùn)行我demo中的代碼，歡迎大家clone我的項(xiàng)目來跑一跑GitHub項(xiàng)目地址
register返回的對象還能保存到Activity的viewModel里岩灭，這樣子可以利用ViewModel來進(jìn)行Activity與Fragment交互拌倍，fragment也可以操作權(quán)限申請等行為了。
由于時間問題我沒辦法全部類都介紹完川背，這篇文章目的是引起大家的興趣贰拿，后續(xù)完全可以自行解讀里面源碼明白用處以及官網(wǎng)是如何封裝的，希望大家都能收獲屬于自己的知識點(diǎn)熄云。到點(diǎn)搬磚了??