📚 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
  • Multiple uri
    • Kotlin
    • Java
  • Single uri
    • Kotlin
    • Java
• 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

• Android Studio 4.0

🧩 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.

• Apache License 2.0