再见!onActivityResult!你好,看完你还觉得算法不重要
1.
首先,在 app 下的build.gradle
中加入依赖:
implementation 'androidx.activity:activity:1.2.0-beta01'implementation 'androidx.fragment:fragment:1.3.0-beta01'复制代码
2\.
定义协议
新建一个 Contract 类,继承自ActivityResultContract<I,O>
,其中,I
是输入的类型,O
是输出的类型。需要实现 2 个方法,createIntent
和parseResult
,输入类型I
作为createIntent
的参数,输出类型O
作为parseResult
方法的返回值,在下面的例子中,输入输出类型都是 String:
class MyActivityResultContract: ActivityResultContract<String,String>(){override fun createIntent(context: Context, input: String?): Intent {return Intent(context,SecondActivity::class.java).apply {putExtra("name",input)}}
override fun parseResult(resultCode: Int, intent: Intent?): String? {val data = intent?.getStringExtra("result")return if (resultCode == Activity.RESULT_OK && data != null) dataelse null}
}复制代码
如上代码,我们在createIntent
方法中创建了 Intent,并且携带了参数name
,在parseResult
方法中,获取了返回的数据result
。
3\.
注册协议,获取启动器-ActivityResultLauncher
注册协议,使用registerForActivityResult
方法,该方法由ComponentActivity
或者Fragment
提供,接受 2 个参数,第一个参数就是我们定义的 Contract 协议,第二个参数是一个回调ActivityResultCallback<O>
,其中O
就是前面 Contract 的输出类型。代码如下:
private val myActivityLauncher = registerForActivityResult(MyActivityResultContract()){result ->Toast.makeText(applicationContext,result,Toast.LENGTH_SHORT).show()textView.text = "回传数据:$result"}复制代码
如上代码,注册了MyActivityResultContract
,registerForActivityResult
方法的返回值是ActivityResultLauncher
,?因此我们定义了一个myActivityLauncher
,回调方法中,result
就是从上一个界面传回的值。这里我们简单的用 Toast 显示。
4.
最后,调用启动器的 launch 方法开启界面跳转
MainActivity
中添加一个 Button,点击 Button 时,调用launch
方法跳转:
button.setOnClickListener {// 开启页面跳转 myActivityLauncher.launch("Hello,技术最 TOP")}复制代码
SecondActivity
的代码很简单:
class SecondActivity : AppCompatActivity(){
override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.second_layout)
val name = intent.getStringExtra("name")textView3.text = "接收到的数据为:$name"
button2.setOnClickListener {val intent = Intent().apply {putExtra("result","Hello,依然范特西稀,我是回传的数据!")}setResult(Activity.RESULT_OK,intent)finish()}}}复制代码
以上 3 步,就实现了使用新的Activity Results API
来完成 Activity 之间的数据传递,并获取 Activity 返回的数据
看一下效果:
[图片上传中...(image-606abe-1603979016399-4)]
这就完了吗?
[图片上传中...(image-ac0011-1603979016399-3)]
你可能会有疑问,虽然确实减少了代码耦合,但是使用并不简单啊。
确实,但这并没有完!!!
预定义的 Contract
大伙都看出来,新的Activity Results API
使用起来好像有点麻烦,每次都得定义 Contract。Google 肯定考虑到了这个问题的,于是,Google 预定义了很多 Contract,把你们能想到的使用场景基本上都想到了,它们都定义在类ActivityResultContracts
中,有以下这些 Contract:
StartActivityForResult()RequestMultiplePermissions()RequestPermission()TakePicturePreview()TakePicture()TakeVideo()PickContact()CreateDocument()OpenDocumentTree()OpenMultipleDocuments()OpenDocument()GetMultipleContents()GetContent()复制代码
下面分别介绍一下这些 Contract:
StartActivityForResult
: 通用的 Contract,不做任何转换,Intent 作为输入,ActivityResult 作为输出,这也是最常用的一个协定。RequestMultiplePermissions
: 用于请求一组权限RequestPermission
: 用于请求单个权限TakePicturePreview
: 调用MediaStore.ACTION_IMAGE_CAPTURE
拍照,返回值为 Bitmap 图片TakePicture
: 调用MediaStore.ACTION_IMAGE_CAPTURE
拍照,并将图片保存到给定的 Uri 地址,返回 true 表示保存成功。TakeVideo
: 调用MediaStore.ACTION_VIDEO_CAPTURE
拍摄视频,保存到给定的 Uri 地址,返回一张缩略图。PickContact
: 从通讯录 APP 获取联系人GetContent
: 提示用选择一条内容,返回一个通过ContentResolver#openInputStream(Uri)
访问原生数据的 Uri 地址(content://形式) 。默认情况下,它增加了Intent#CATEGORY_OPENABLE
, 返回可以表示流的内容。CreateDocument
: 提示用户选择一个文档,返回一个(file:/http:/content:)开头的 Uri。OpenMultipleDocuments
: 提示用户选择文档(可以选择多个),分别返回它们的 Uri,以 List 的形式。OpenDocumentTree
: 提示用户选择一个目录,并返回用户选择的作为一个 Uri 返回,应用程序可以完全管理返回目录中的文档。
上面这些预定义的 Contract 中,除了StartActivityForResult
和RequestMultiplePermissions
之外,基本都是处理的与其他 APP 交互,返回数据的场景,比如,拍照,选择图片,选择联系人,打开文档等等。使用最多的就是StartActivityForResult
和RequestMultiplePermissions
了。
有了这些预定义的 Contract, Activity 之间传递数据就简单多了,比如,前面的例子,可以简化成这样:
1\. 注册协议,获取
ActivityResultLauncher:
private val myActivityLauncher = registerForActivityResult(ActivityResultContracts.StartActivityForResult()){ activityResult ->
if(activityResult.resultCode == Activity.RESULT_OK){val result = activityResult.data?.getStringExtra("result")Toast.makeText(applicationContext,result,Toast.LENGTH_SHORT).show()textView.text = "回传数据:$result"}}复制代码
2\. 构造需要传递的数据,启动页面跳转
button.setOnClickListener {val intent = Intent(this,SecondActivity::class.java).apply {putExtra("name","Hello,技术最 TOP")}myActivityLauncher.launch(intent)}复制代码
OK,就是这么简单!!!
在比如,我们的权限,申请,请看代码:
request_permission.setOnClickListener {requestPermission.launch(permission.BLUETOOTH)}
request_multiple_permission.setOnClickListener {requestMultiplePermissions.launch(arrayOf(permission.BLUETOOTH,permission.NFC,permission.ACCESS_FINE_LOCATION))}
// 请求单个权限 private val requestPermission =registerForActivityResult(ActivityResultContracts.RequestPermission()) { isGranted ->// Do something if permission grantedif (isGranted) toast("Permission is granted")else toast("Permission is denied")}
// 请求一组权限 private val requestMultiplePermissions =registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()) { permissions : Map<String, Boolean> ->// Do something if some permissions granted or deniedpermissions.entries.forEach {// Do checking here}
}复制代码
有了这个,我们就可以抛弃所有的第三方权限请求框架,只需要将这两个 Contract 放到 BaseActivity 中,或者抽取到一个单独的类中,就能随时随地申请权限。是不是很方便!!!
[图片上传中...(image-13ff11-1603979016399-2)]
在非 A
ctivity/Fragment 的类中接收 Activity 的结果
在 Activity 和 Fragment 中,我们能直接使用registerForActivityResult
API ,那是因为ConponentActivity
和Fragment
基类实现了ActivityResultCaller
接口,在非 Activity/Fragment 中,如果我们想要接收 Activity 回传的数据,可以直接使用 ActivityResultRegistry
来实现。
比如,用一个单独的类来实现协议的注册和启动器的启动:
class MyLifecycleObserver(private val registry : ActivityResultRegistry): DefaultLifecycleObserver {lateinit var getContent : ActivityResultLauncher<String>
fun onCreate(owner: LifecycleOwner) {getContent = registry.register("key", owner, GetContent()) { uri ->// Handle the returned Uri}}
fun selectImage() {getContent("image/*")}}
class MyFragment : Fragment() {lateinit var observer : MyLifecycleObserver
override fun onCreate(savedInstanceState: Bundle?) {// ...
observer = MyLifecycleObserver(requireActivity().activityResultRegistry)lifecycle.addObserver(observer)}
评论