Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/afollestad/inline-activity-result
Receive Activity results inline, without any boilerplate. Optional coroutines and RxJava support.
https://github.com/afollestad/inline-activity-result
activity-results android androidx coroutines intent kotlin rxjava
Last synced: 5 days ago
JSON representation
Receive Activity results inline, without any boilerplate. Optional coroutines and RxJava support.
- Host: GitHub
- URL: https://github.com/afollestad/inline-activity-result
- Owner: afollestad
- License: apache-2.0
- Archived: true
- Created: 2019-04-24T20:27:45.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-02-21T05:17:52.000Z (over 3 years ago)
- Last Synced: 2024-07-24T05:44:40.430Z (3 months ago)
- Topics: activity-results, android, androidx, coroutines, intent, kotlin, rxjava
- Language: Kotlin
- Homepage: https://af.codes
- Size: 182 KB
- Stars: 316
- Watchers: 6
- Forks: 15
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
- awesome-android - Inline Activity Results
README
## Inline Activity Result
[](https://github.com/afollestad/inline-activity-result/actions?query=workflow%3A%22Android+CI%22)
[](https://www.codacy.com/app/drummeraidan_50/inline-activity-result?utm_source=github.com&utm_medium=referral&utm_content=afollestad/inline-activity-result&utm_campaign=Badge_Grade)
[](https://opensource.org/licenses/Apache-2.0)
---
## Table of Contents
1. [Core](#core)
1. [Gradle Dependency](#gradle-dependency)
2. [Usage](#usage)
2. [Coroutines](#coroutines)
1. [Gradle Dependency](#gradle-dependency-1)
2. [Usage](#usage-1)
3. [RxJava](#rxjava)
1. [Gradle Dependency](#gradle-dependency-2)
2. [Usage](#usage-2)
---
## Core
### Gradle Dependency
[  ](https://repo1.maven.org/maven2/com/afollestad/inline-activity-result/core)
```gradle
dependencies {
...
implementation 'com.afollestad.inline-activity-result:core:0.2.0'
}
```
### Usage
You call `startActivityForResult`, providing the Activity to launch as the generic type. You
receive the result in a callback *without* having to override `onActivityResult`. And, you don't
have to worry about `requestCode` or `resultCode`.
```kotlin
class NewActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val extras = Bundle()
.putString("some_extra", "Hello, World!")
startActivityForResult(extras) { success, data ->
if (success) {
toast("Got successful result: $data")
}
}
}
}
```
---
There are multiple variants `startActivityForResult` you can use for different use cases. *All of
them allow you to pass an optional `requestCode` parameter, but this should generally be unnecessary.*
First, the simplest you can get is just a generic type and the callback.
```kotlin
startActivityForResult { success, data ->
// Do something
}
```
Second, you can provide a `Bundle` of extras to the destination Activity:
```kotlin
val extras = Bundle()
.putString("some_extra", "Hello, World!")
startActivityForResult(extras) { success, data ->
// Do something
}
```
And finally, you can use a full intent. In this variant you do not provide a generic parameter.
```kotlin
val intent = Intent(Intent.ACTION_VIEW)
.setData("content://some-uri".toUri())
startActivityForResult(intent) { success, data ->
// Do something
}
```
---
## Coroutines
### Gradle Dependency
[  ](https://repo1.maven.org/maven2/com/afollestad/inline-activity-result/coroutines)
```gradle
dependencies {
...
implementation 'com.afollestad.inline-activity-result:coroutines:0.2.0'
}
```
### Usage
You can use Kotlin coroutines to get rid of the callback. It of course is a suspend function so it
must be called within a coroutine scope.
Instead of `startActivityForResult`, you can use `startActivityAwaitResult`:
```kotlin
val result: ActivityResult = startActivityAwaitResult()
// use result...
```
---
## RxJava
### Gradle Dependency
[  ](https://repo1.maven.org/maven2/com/afollestad/inline-activity-result/rxjava)
```gradle
dependencies {
...
implementation 'com.afollestad.inline-activity-result:rxjava:0.2.0'
}
```
### Usage
You can use RxJava to integrate the Activity launch and result into your streams.
Instead of `startActivityForResult`, you can use `startActivityEmitResult`:
```kotlin
val disposable = startActivityEmitResult()
.subscribe { result ->
// use result...
}
// make sure you dispose of the subscription when your Activity/Fragment goes away
disposable.dispose()
```