原文 A first look at AndroidX Activity Result APIs
前言
几周前，我发表了一篇关于 AndroidX如何改变我们处理Activity和Fragment的方式 的文章，现在就来看看 AndroidX 中新引入的 Activity Result API，该 API 增加来处理 Activity 结果请求的功能，类似于我们用 SaveStateRegistry 或用 OnBackPressedDispatcher。
Android Result APIs 从 AndroidX Activity 1.2.0-alpha02 和 Fragment 1.3.0-alpha02 开始引入的。你可以使用-ktx 扩展库来使用 Kotlin 开发更简洁的代码。
自定义 Contract 数据
如果我们想要和其他的Activity交互，并且通过获取到返回的数据，通过到做法是用startActivityForResult 调用其他到Activity并且重写onActivityResult获取到返回到数据，在onActivityResult 方法需要判断返回到数据类型，因为如果你调用多个Activity返回到数据都是在这个方法中，你必须保证你启用的是正确的 Activity 并且在结束的是获取输出结果。这就是抽象类ActivityResultContract<I, O>包含两个抽象方法的原因
public abstract class ActivityResultContract<I, O> {
/** Create an intent that can be used for {@link Activity#startActivityForResult} */
public abstract @NonNull Intent createIntent(@SuppressLint("UnknownNullness") I input);
/** Convert result obtained from {@link Activity#onActivityResult} to O */
public abstract @SuppressLint("UnknownNullness") O parseResult(
int resultCode,
@Nullable Intent intent);
}
继承ActivityResultContract类重写两个方法，定义个int类型的输入参数，一个String类型的返回数据
public class MyContract extends ActivityResultContract<Integer,String> {
private String ACTION = "com.myapp.action.MY_ACTION";//指定Action
private String INPUT_INT = "input_int";//
private String OUTPUT_STRING = "output_string";
private Context context;
@NonNull
@Override
public Intent createIntent(Integer input) {
//创建一个Intent 可以给startActivityForResult使用
return new Intent(ACTION).putExtra(INPUT_INT,input);
}
@Override
public String parseResult(int resultCode, @Nullable Intent intent) {
//将从onActivityResult方法中获取的返回结果进行判断和转换成指定的对象类型
String data = null;
if (resultCode == Activity.RESULT_OK) {
data=intent.getStringExtra(OUTPUT_STRING);
}
return data;
}
}
库中预编译好的Contract类型
-
Dial：通过ACTION_DIAL发送一个tel:{number}格式的数据调用拨打电话，并返回数据结果状态（布尔值） -
TakePicture：使用Intent with ACTION_IMAGE_CAPTURE调用图像选择功能并返回位图对象， -
RequestPermission：对于请求单个运行时权限，返回一个布尔值，指示是否已授予权限， -
RequestPermissions：对于请求多个运行时权限，返回布尔值映射，指示是否授予了权限， -
StartActivityForResult：一个原始契约，它接受一个意图作为输入，并返回一个包含resultCode和从请求的活动返回的意图的结构。
如您所见，Activity Result APIs可用于处理对运行时权限的请求，因此您无需为此使用单独的API。
使用方法
在你的Activity中使用prepareCall 方法将你自定的ActivityResultContract类的对象传入，并传入一个ActivityResultCallback对象，用于处理获取到的已经转换成特定数据类型的结果
prepareCall(new MyContract(), new ActivityResultCallback<String>() {
@Override
public void onActivityResult(String result) {
//处理获取到的已经转换成特定数据类型的结果
}
});
测试
该prepareCall方法可以选择采用的实例ActivityResultRegistry。在测试中，您可以提供伪造的注册表实现，例如，分派模拟结果。官方文档中提供了一些示例。
摘要
Activity Result APIs现在可在Alpha AndroidX alpha版本中使用，因此在达到稳定状态之前可能会引入许多更改。但是，很高兴知道正在准备对以前的API进行如此重大的改进，并将在未来几个月内投入生产！
