A look at tbruyelle/RxPermissions: 10.4k stars on GitHub, written primarily in Java, tracked under the Mobile category. Android runtime permissions powered by RxJava2
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
final RxPermissions rxPermissions = new RxPermissions(this); // where this is an Activity or Fragment instance
NOTE:new RxPermissions(this) the this parameter can be a FragmentActivity or a Fragment. If you are using RxPermissions inside of a fragment you should pass the fragment instance(new RxPermissions(this)) as constructor parameter rather than new RxPermissions(fragment.getActivity()) or you could face a java.lang.IllegalStateException: FragmentManager is already executing transactions.
Example : request the CAMERA permission (with Retrolambda for brevity, but not required)
// Must be done during an initialization phase like onCreate
rxPermissions
.request(Manifest.permission.CAMERA)
.subscribe(granted -> {
if (granted) { // Always true pre-M
// I can control the camera now
} else {
// Oups permission denied
}
});
If you need to trigger the permission request from a specific event, you need to setup your event
as an observable inside an initialization phase.
You can use JakeWharton/RxBinding to turn your view to
an observable (not included in the library).
Example :
// Must be done during an initialization phase like onCreate
RxView.clicks(findViewById(R.id.enableCamera))
.compose(rxPermissions.ensure(Manifest.permission.CAMERA))
.subscribe(granted -> {
// R.id.enableCamera has been clicked
});
If multiple permissions at the same time, the result is combined :
rxPermissions
.request(Manifest.permission.CAMERA,
Manifest.permission.READ_PHONE_STATE)
.subscribe(granted -> {
if (granted) {
// All requested permissions are granted
} else {
// At least one permission is denied
}
});
You can also observe a detailed result with requestEach or ensureEach :
rxPermissions
.requestEach(Manifest.permission.CAMERA,
Manifest.permission.READ_PHONE_STATE)
.subscribe(permission -> { // will emit 2 Permission objects
if (permission.granted) {
// `permission.name` is granted !
} else if (permission.shouldShowRequestPermissionRationale) {
// Denied permission without ask never again
} else {
// Denied permission with ask never again
// Need to go to the settings
}
});
You can also get combined detailed result with requestEachCombined or ensureEachCombined :
rxPermissions
.requestEachCombined(Manifest.permission.CAMERA,
Manifest.permission.READ_PHONE_STATE)
.subscribe(permission -> { // will emit 1 Permission object
if (permission.granted) {
// All permissions are granted !
} else if (permission.shouldShowRequestPermissionRationale)
// At least one denied permission without ask never again
} else {
// At least one denied permission with ask never again
// Need to go to the settings
}
});
Look at the sample app for more.
Important read
As mentioned above, because your app may be restarted during the permission request, the request
must be done during an initialization phase. This may be Activity.onCreate, or
View.onFinishInflate, but not pausing methods like onResume, because you'll potentially create an infinite request loop, as your requesting activity is paused by the framework during the permission request.
If not, and if your app is restarted during the permission request (because of a configuration
change for instance), the user's answer will never be emitted to the subscriber.
You can find more details about that here.
Status
This library is still beta, so contributions are welcome.
I'm currently using it in production since months without issue.
Benefits
Avoid worrying about the framework version. If the sdk is pre-M, the observer will automatically
receive a granted result.
Prevents you to split your code between the permission request and the result handling.
Currently without this library you have to request the permission in one place and handle the result
in Activity.onRequestPermissionsResult().
All what RX provides about transformation, filter, chaining...
License
Copyright (C) 2015 Thomas Bruyelle
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Does tbruyelle/RxPermissions have a project website?
No homepage URL was recorded for tbruyelle/RxPermissions in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How active is development on tbruyelle/RxPermissions?
The most recent commit recorded on tbruyelle/RxPermissions was 4.5 years ago, based on the GitHub push timestamp. The repository has 1.4k forks — one of the better signals of community interest.
Is tbruyelle/RxPermissions open source?
Yes — tbruyelle/RxPermissions ships under the Apache-2.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/tbruyelle/RxPermissions.
What license does tbruyelle/RxPermissions use?
tbruyelle/RxPermissions is released under the Apache-2.0 license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
What topics is tbruyelle/RxPermissions associated with?
GitHub's repository topics for tbruyelle/RxPermissions: "android", "android-permissions", "rxjava". TopGit's editorial category is Mobile.
Where do I read more about tbruyelle/RxPermissions?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/tbruyelle/RxPermissions is the definitive source.
Read full README in the tab above.
Want a second opinion on RxPermissions?
Ask an AI that can read this page — one click and you get its take on RxPermissions.