再见!onActivityResult!你好,android 开发电子书阅读器
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,`registerForActivit
yResult方法的返回值是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 返回的数据
看一下效果:
这就完了吗?
你可能会有疑问,虽然确实减少了代码耦合,但是使用并不简单啊。
确实,但这并没有完!!!
预定义的 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 中,或者抽取到一个单独的类中,就能随时随地申请权限。是不是很方便!!!
在非 Activity/Fragment 的类中接收 Activity 的结果
在 Activity 和 Fragment 中,我们能直接使用registerForActivityResultAPI ,那是因为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











评论