再见!onActivityResult!你好 (1),太现实了
}
各种处理结果都耦合在onActivityResult
回调里,并且还得定义一堆额外的常量REQUEST_CODE
,用与判断是哪个请求的回调结果。
onActivityResult 现状?
Google 可能也意识到onActivityResult
的这些问题,在androidx.activity:activity:1.2.0-alpha02
和androidx.fragment:fragment:1.3.0-alpha02
中,已经废弃了startActivityForResult
和onActivityResult
方法。
/**
{@inheritDoc}
@deprecated use
{@link #registerForActivityResult(ActivityResultContract, ActivityResultCallback)}
passing in a {@link StartActivityForResult} object for the {@link ActivityResultContract}.*/@Override@Deprecatedpublic void startActivityForResult(@SuppressLint("UnknownNullness") Intent intent,int requestCode) {super.startActivityForResult(intent, requestCode);}
/**
{@inheritDoc}
@deprecated use
{@link #registerForActivityResult(ActivityResultContract, ActivityResultCallback)}
with the appropriate {@link ActivityResultContract} and handling the result in the
{@link ActivityResultCallback#onActivityResult(Object) callback}.*/@CallSuper@Override@Deprecatedprotected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {if (!mActivityResultRegistry.dispatchResult(requestCode, resultCode, data)) {super.onActivityResult(requestCode, resultCode, data);}}
可以看到,这两个方法都被标记为了Deprecated
,那这两个方法不推荐使用了,Google 推荐使用什么方式从 Activity 中更好的获取数据呢?答案就是 Activity Results API
Activity Results API
Activity Results API 是 Google 官方推荐的 Activity、Fragment 获取数据的方式。
Activity Results API 到底怎么用?相比onActivityResult
有哪些优势?接下来,将一一为你解答。
在介绍如何使用之前,先为大家介绍 Activity Results API 中两个重要的组件:ActivityResultContract
和ActivityResultLauncher
。
ActivityResultContract
: 协议,它定义了如何传递数据和如何处理返回的数据。ActivityResultContract
是一个抽象类,你需要继承它来创建自己的协议,每个ActivityResultContract
都需要定义输入和输出类,如果您不需要任何输入,可使用 Void(在 Kotlin 中,使用 Void? 或 Unit)作为输入类型。ActivityResultLauncher
: 启动器,调用ActivityResultLauncher
的launch
方法来启动页面跳转,作用相当于原来的startActivity()
使用 Activity Results API 在 Activity 之间传递数据
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 fu
n 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 返回的数据
看一下效果:
这就完了吗?
你可能会有疑问,虽然确实减少了代码耦合,但是使用并不简单啊。
确实,但这并没有完!!!
预定义的 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 {
评论