微信改了推動(dòng)機(jī)制，真愛(ài)請(qǐng)星標(biāo)本公號(hào)
公眾號(hào)回復(fù)加入BATcoder技術(shù)群BAT

作者：Magic旭
鏈接：https://www.jianshu.com/p/da4c0e87d8b4

背景

谷歌最近更新android 12的同時(shí)，看android開(kāi)發(fā)者掘進(jìn)推送時(shí)候，發(fā)現(xiàn)一個(gè)新增一個(gè)我之前留意過(guò)的接口和一些類。好奇的我小手一動(dòng)，就想一探究竟了。

介紹的內(nèi)容

ActivityResultContracts類，該類高度封裝了Intent，讓開(kāi)發(fā)者更為方便訪問(wèn)系統(tǒng)App進(jìn)行數(shù)據(jù)交互、更為方便的進(jìn)行Activity之間的數(shù)據(jù)交互、更為方便的申請(qǐng)權(quán)限、更為方便去訪問(wèn)圖庫(kù)、相機(jī)等。下面我會(huì)從幾個(gè)簡(jiǎn)單用例入手講解。

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

介紹對(duì)象：ActivityResultContracts.PickContact 場(chǎng)景：假如某個(gè)需求場(chǎng)景中需要獲取系統(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，就能通過(guò)Intent獲取返回的數(shù)據(jù)了。這里不羅列齊全，因?yàn)闀?huì)導(dǎo)致篇幅過(guò)長(zhǎng)，詳細(xì)可以看這篇android如何訪問(wèn)通訊錄，這篇文章獲取手機(jī)號(hào)是獲取不了的，只能輔助你看下之前訪問(wèn)訊錄多麻煩。

二、新方式（ActivityResultContracts.PickContact）

1. 當(dāng)你看完上面android如何訪問(wèn)通訊錄后，你會(huì)覺(jué)得巨麻煩，而且又長(zhǎng)又臭。在之前你沒(méi)辦法，只能屈服、卑微的接收，但是現(xiàn)在不同了，大人時(shí)代改變了。

//第一步，注冊(cè)交互數(shù)據(jù)回調(diào)監(jiān)聽(tīng)
val contact = registerForActivityResult(ActivityResultContracts.PickContact()) { uri : Uri? ->
      //如果Uri為null，說(shuō)明用戶沒(méi)有操作直接返回，這里代碼會(huì)在下面補(bǔ)貼出來(lái)，因?yàn)樯婕翱邕M(jìn)程交互，代碼比較長(zhǎng)，不想貼這里影響閱讀效率
     ……
}

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

2. 看完上面后，是不是都不敢相信自己眼睛，直接launch就能跳轉(zhuǎn)通訊錄了，從register上就能收到通訊錄的數(shù)據(jù)了,但是你很快發(fā)現(xiàn)點(diǎn)擊某個(gè)通訊錄用戶后就崩潰的。看完下面崩潰信息，是不是覺(jué)得最終還是沒(méi)能逃過(guò)權(quán)限的問(wèn)題？別急，下面我介紹你如何快速便捷的調(diào)用申請(qǐng)權(quán)限的接口，而且很方便的能得到用戶請(qǐng)求同意還是拒絕。

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

申請(qǐng)權(quán)限

這里結(jié)合上面通訊錄問(wèn)題，就申請(qǐng)?jiān)L問(wèn)通訊錄權(quán)限為例子介紹新的ActivityResultContract功能。

一、舊方式申請(qǐng)權(quán)限

<!--訪問(wèn)通訊錄-->
<uses-permission android:name="android.permission.READ_CONTACTS"/>

//6.0以上要?jiǎng)討B(tài)獲取權(quán)限
protected final int REQUEST_PERMISSION_ADDRESSBOOK = 10;
protected final int REQUEST_ADDRESSBOOK = 11;  

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

//申請(qǐng)權(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) {
              //用戶同意訪問(wèn)通訊錄權(quán)限
        }
   }

二、新方式（ActivityResultContracts.RequestPermission）

上面的舊方式在一個(gè)發(fā)起權(quán)限后，還要到onRequestPermissionsResult方法里面去做權(quán)限區(qū)分，耦合嚴(yán)重，而且麻煩啰嗦。下面看完我們新方式申請(qǐng)權(quán)限后，你會(huì)發(fā)出疑惑：“哈？這么簡(jiǎn)單，這么容易，我不信”。不信你可以試試，反正后續(xù)真香定律。

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

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

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

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

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

一、舊方式Activity之間的數(shù)據(jù)交互

MainActivity的代碼

//定義請(qǐng)求的CODE碼，用于在onActivityResult方法里區(qū)分回來(lái)的數(shù)據(jù)哪個(gè)是預(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 {
            //通過(guò)intent返回?cái)?shù)據(jù)
            val intent = Intent()
            intent.putExtra("magic", "Hello world")
            setResult(Activity.RESULT_OK, intent)
            finish()
 }

二、新方式（ActivityResultContracts.StartActivityForResult）

舊方式的缺陷和上面申請(qǐng)權(quán)限差不多。就是在當(dāng)requestCode越來(lái)越多時(shí)候，onActivityResult就會(huì)變得冗余臃腫。現(xiàn)在新方式是單一職責(zé)，register只處理對(duì)應(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") ?: "沒(méi)返回intent"
                Toast.makeText(this, msg, Toast.LENGTH_LONG).show()
            }
            else -> {
                Log.i("magic", "返回?cái)?shù)據(jù)失敗")
            }
        }
    }

總結(jié)

1. 要使用ActivityResultContract必須引入兩個(gè)庫(kù)

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

2. 這次新功能的發(fā)布可以看出后續(xù)google都是為了開(kāi)發(fā)者更為便捷，更解耦方向去做代碼優(yōu)化了，值得期待往后android的發(fā)展。自學(xué)官網(wǎng)地址

3. 如果想運(yùn)行我demo中的代碼，歡迎大家clone我的項(xiàng)目來(lái)跑一跑GitHub項(xiàng)目地址

4. register返回的對(duì)象還能保存到Activity的viewModel里，這樣子可以利用ViewModel來(lái)進(jìn)行Activity與Fragment交互，fragment也可以操作權(quán)限申請(qǐng)等行為了。

5. 由于時(shí)間問(wèn)題我沒(méi)辦法全部類都介紹完，這篇文章目的是引起大家的興趣，后續(xù)完全可以自行解讀里面源碼明白用處以及官網(wǎng)是如何封裝的，希望大家都能收獲屬于自己的知識(shí)點(diǎn)。到點(diǎn)搬磚了??