前言
今天在做项目的时候,遇到了需要打开文件管理中某个文件夹的需求,在网上看到一个大佬是这样写的:
private void openMusic(){
Uri uri = Uri.parse("content://com.android.externalstorage.documents/document/primary:Music");
Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
intent.addCategory(Intent.CATEGORY_OPENABLE);
intent.setType("*/*");
intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, uri);
startActivityForResult(intent, 1);
}
本想着借鉴过来直接使用,但是IDE上清晰的 startActivityForResult,让我觉得应该仔细研究一下这个方法了。
startActivityForResult用法
在以前,我们经常会遇到启动一个 Activity,并从中获取数据的需求,此外还有一些常见的场景是调用系统相机、调用相册获取照片、调用通讯录等。通常的做法就是使用 Intent 携带数据,之后将 Intent 和请求码传入 startActivityForResult
方法来启动下一个Activity
startActivityForResult(intent,1)
最终在 onActivityResult
方法中来接收返回的数据。实现 onActivityResult 方法
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if(requestCode == 1 && resultCode == Activity.RESULT_OK){
// 处理带回的数据
}
}
但是随着应用的开发 onActivityResult 回调方法难以解耦复用,后期维护困难。于是Google推出Activity Results API
Activity Results API介绍
Activity Results API 是 Google官方推荐的Activity、Fragment获取数据的方式。它有两个主要的用途:
- 取代 startActivityForResult 方法,去启动Activity并返回结果
- 取代 requestPermissions 方法,去请求运行时权限
registerForActivityResult()
在 AppCompatActivity 或者 Fragment 中使用 registerForActivityResult() 方法来代替 startActivityForResult() (Android api29中使用startActivityForResult提示已过时,应该变成registerForActivityResult)。该方法接收两个参数并返回ActivityResultLauncher。其中两个参数一个是ActivityResultContract,一个是ActivityResultCallback。最终使用 activityResultLauncher 调用launch(...)
启动目标Activity。
ActivityResultLauncher
用于启动另一个 ActivityActivityResultContract
这是一个协议类,它的两个泛型分别表示启动参数的类型和返回结果的类型。可以通过继承的方式来自定义 ActivityResultContractActivityResultCallback
是单一方法接口,内部只有 onActivityResult 这一个方法,可以接受ActivityResultContract 中定义的输出类型的对象
registerForActivityResult部分源码
ActivityResultCallback部分源码
常规用法
下面实现一个最基本的小例子,首先我在 MainActivity 的 onCreate 方法中,进行如下实现
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ActivityResultLauncher<Intent> activityResultLauncher = registerForActivityResult(
new ActivityResultContracts.StartActivityForResult(),
result -> {
if (result.getResultCode() == RESULT_OK) {
//获取返回的结果
String data = result.getData().getStringExtra("data");
Log.d(TAG, "onCreate: " + data);
Toast.makeText(this, data, Toast.LENGTH_SHORT).show();
}
});
Button button1 = findViewById(R.id.button_2);
button1.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Intent intent = new Intent(MainActivity.this, SecondActivity.class);
activityResultLauncher.launch(intent);
}
});
}
之后我在 SecondActivity 的 onCreate 方法中,进行如下实现
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_2);
Intent intent = new Intent();
intent.putExtra("data", "这是回调的数据");
setResult(RESULT_OK, intent);
finish();
}
需要注意的是:
registerForActivityResult只能在onCreate()中注册,不然在使用的时候会报异常
java.lang.IllegalStateException: LifecycleOwner com.yxf.extensions.MainActivity@f8e47f4 is attempting to register while current state is RESUMED. LifecycleOwners must call register before they are STARTED.
本文正在参加「金石计划」