📚
Handle Path Oz
Android library written in Kotlin, but can be used in Java too. Built to handle a single or multiple Uri (paths) received through Intents.
When you retrieve a Uri through an intent, its path is defined in relation to the File Chooser used, which does not represent the actual path of the file, making it impossible to work with it. This library aims to retrieve the real path of any file in a simple way, and then it is possible to use it for its proper purpose.
Compatible with API version from 16.
💞
Support us
We are developing this structure in the open source community without financial planning. If you like this project and would like to help us, make a donation:
📝
Content
- Sample application
- Config
- Getting start
- Projects using this library
- Main features
- Built with
- Contributing
- License
📱
Sample application
🌱
Download release
You can download the sample application with the latest release here.
🌱
Install by GooglePlay
Check the Sample App on GooglePlay
🛠️
Config
First check the latest version.
Gradle
In build.gradle(Module:app) within dependencies, implement:
implementation 'com.github.onimur:handle-path-oz:1.0.7'
Maven
<dependency>
<groupId>com.github.onimur</groupId>
<artifactId>handle-path-oz</artifactId>
<version>1.0.7</version>
<type>pom</type>
</dependency>
Ivy
<dependency org='com.github.onimur' name='handle-path-oz' rev='1.0.7'>
<artifact name='handle-path-oz' ext='pom' ></artifact>
</dependency>
💡
Getting start
Working with Multiple uri
The next steps are for working with multiple uri as well as for a single uri.
🎲
Kotlin
You can check in the wikipage, click here.
🎲
Java
You can check in the wikipage, click here.
Working with Single uri
The next steps only serve to work with a single uri.
🎲
Kotlin
You can check in the wikipage, click here.
🎲
Java
You can check in the wikipage, click here.
🚀
Projects using this library
Here's a wikipage list of projects.
If you've used this library, please let me know! Nothing makes me happier than seeing someone else take my work and go wild with it.
🔍
Main features
- Kotlin Coroutines/Flow
- Parse Uri
- Multiple tasks in parallel
📐
Built with
🧩
Contributing
This project is open-source, so feel free to fork, or to share your ideas and changes to improve the project, check with more details below.
-
💬 Contributing - 👮🏼 Code of conduct
-
😷 Support
📃
License
Copyright (c) 2020, HandlePathOz.
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.