https://github.com/kinnerapriyap/sher-gil
Media Image picker library in kotlin for Android 🥳
https://github.com/kinnerapriyap/sher-gil
android-image-picker android-image-selector android-library image-picker-android image-picker-library kotlin
Last synced: about 1 year ago
JSON representation
Media Image picker library in kotlin for Android 🥳
- Host: GitHub
- URL: https://github.com/kinnerapriyap/sher-gil
- Owner: kinnerapriyap
- License: apache-2.0
- Created: 2020-05-24T13:45:33.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2021-07-15T13:26:06.000Z (almost 5 years ago)
- Last Synced: 2023-07-26T22:20:52.062Z (almost 3 years ago)
- Topics: android-image-picker, android-image-selector, android-library, image-picker-android, image-picker-library, kotlin
- Language: Kotlin
- Homepage:
- Size: 440 KB
- Stars: 7
- Watchers: 3
- Forks: 1
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# sher-gil
### Media picker library in kotlin for Android 🥳
[  ](https://search.maven.org/artifact/com.kinnerapriyap/sher-gil)
[](https://opensource.org/licenses/Apache-2.0)
[](https://twitter.com/kinnerapriyap)
Written in kotlin with Android architecture components, `sher-gil` aims to be a reliable library resource for media picking.
## Features
* Multiple media selection (currently only images)
* Custom MIME types
* Handles runtime permissions
* Returns media selection as `List`
* Custom theme
## Download
### Gradle
Add the dependency to your project `build.gradle` file
```
repositories {
mavenCentral()
}
dependencies {
implementation 'com.kinnerapriyap:sher-gil:$latest_version'
}
```
Latest version: [  ](https://bintray.com/kinnerapriyap/maven-android/sher-gil/_latestVersion)
## Usage
Sher-gil may be started from either an Activity or a Fragment.
```
Shergil.create(this)
.mimeTypes(MimeType.IMAGES)
.showDisallowedMimeTypes(false)
.numOfColumns(2)
.theme(R.style.Shergil)
.allowPreview(true)
.maxSelectable(Integer.MAX_VALUE)
.allowCamera(true)
.showDeviceCamera(false)
.showCameraFirst(false)
.orientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED)
.withRequestCode(REQUEST_SHERGIL)
```
#### Get result
```
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
if (resultCode == Activity.RESULT_OK && requestCode == REQUEST_SHERGIL) {
val mediaUris: List = Shergil.getMediaUris(data)
}
}
```
If you're on `API level > R`, you can use `registerForActivityResult(ActivityResultContract, ActivityResultCallback)` with the appropriate ActivityResultContract and handle the result in the callback.
**Min SDK:** sher-gil supports a minimum SDK of 21.
#### compileOptions should be applied in the `build.gradle` android closure
```
android {
...
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
```
#### Navigation safe args classpath should be added to application level build.gradle
```
buildScript {
...
dependencies {
classpath "androidx.navigation:navigation-safe-args-gradle-plugin:2.3.0"
}
}
```
Ref: [Java 8 support](https://developer.android.com/studio/write/java8-support)
## Contributing
[](code_of_conduct.md)
If you have any feedback or a suggestion for a better implementation, please don't hesitate to open an issue or a pull request.
For major changes, please open an issue first to discuss what you would like to change.
## *aha*
#### Named after
[Amrita Sher-Gil](https://artsandculture.google.com/entity/amrita-sher-gil/m09sphm?categoryId=artist&hl=en), a pre-eminent Hungarian-Indian early modernist painter who became known as the 'Indian Frida Kahlo'.
#### Inspired by
The [Matisse](https://github.com/zhihu/Matisse) library