permissions-ui

KO | EN

gitlite — search

#hacktoberfest #ai #machine-learning #rust #deep-learning #macos #java #nodejs #windows #cli #kubernetes #awesome-list #security #ios

(★ 64)

Background location permissions request helper

permissions-ui Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/se.warting.permissionsui/permissionsui/badge.png)](https://maven-badges.herokuapp.com/maven-central/se.warting.permissionsui/permissionsui)
[![Crowdin](https://badges.crowdin.net/permissions-ui/localized.svg)](https://crowdin.com/project/permissions-ui)

# Permission UI

A set of Android-UI components to make it easier to request permission in a user friendly way.

## Access background location 
A jetpack compose module to easy request background location permission in a intuitive way.

![happy case gif](https://raw.githubusercontent.com/warting/permissions-ui/main/screenshot/sdk12_happy_case.gif)

## How to include in your project
The library is available via MavenCentral:
```
allprojects {
    repositories {
        // ...
        mavenCentral()
    }
}
```

Add it to your module dependencies:
```
dependencies {
    implementation("se.warting.permissionsui:permissionsui:<latest_version>")
}
```

<details>
<summary>Snapshots of the development version are available in Sonatype's snapshots repository.</summary>
<p>

[![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/se.warting.permissionsui/permissionsui?server=https%3A%2F%2Foss.sonatype.org)](https://oss.sonatype.org/content/repositories/snapshots/se/warting/permissionsui/permissionsui/)

```groovy
allprojects {
    repositories {
        // ...
        maven {
            url 'https://oss.sonatype.org/content/repositories/snapshots/'
        }
    }
}
```

</p>
</details>

## How to use
All you need to do is to call `LocationInBackgroundTutorialView`:
```
LocationInBackgroundTutorialView() {
    // Permissions granted 
}
```

Example:
```
import se.warting.permissionsui.backgroundlocation.LocationInBackgroundTutorialView

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            BackgroundLocationPermissionRationaleTheme {
                Surface(color = MaterialTheme.colors.background) {
                    LocationInBackgroundTutorialView() {
                        // Permissions granted 
                    }
                }
            }
        }
    }
}
```

If you are not using compose in your app you can use `PermissionsUiContracts.RequestBackgroundLocation` See: [kotlin sample](app/src/main/java/se/warting/backgroundlocationpermissionrationale/ResultingActivity.kt) or [java sample](appjava/src/main/java/se/warting/backgroundlocationpermissionrationale/MainActivity.java)

For a full implementation see: [Full sample](app/src/main/java/se/warting/backgroundlocationpermissionrationale/MainActivity.kt)

## Notes
This Library adds the following permissions to your app: 
- android.permission.ACCESS_COARSE_LOCATION
- android.permission.ACCESS_FINE_LOCATION
- android.permission.ACCESS_BACKGROUND_LOCATION

## Samples
| SDK | Happy case | Rationale case | Worst case |
| --- | --- | --- | --- |
| 10 | ![happy case gif](https://raw.githubusercontent.com/warting/permissions-ui/main/screenshot/sdk10_happy_case.gif) | ![rationale case gif](https://raw.githubusercontent.com/warting/permissions-ui/main/screenshot/sdk10_rationale_case.gif) | ![worst case gif](https://raw.githubusercontent.com/warting/permissions-ui/main/screenshot/sdk10_worst_case.gif) |
| 12 | ![happy case gif](https://raw.githubusercontent.com/warting/permissions-ui/main/screenshot/sdk12_happy_case.gif) | ![rationale case gif](https://raw.githubusercontent.com/warting/permissions-ui/main/screenshot/sdk12_rationale_case.gif) | ![worst case gif](https://raw.githubusercontent.com/warting/permissions-ui/main/screenshot/sdk12_worst_case.gif) |

permissions-ui

permissions-ui Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

permissions-ui

permissions-ui Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README