|
1 | 1 | # QRUtils-Android |
2 | | -QRUtils is a set of pre-built, customizable UI components for creating and reading QR codes. |
3 | 2 |
|
4 | | -If you landed here **before I finished creating a README** just as awesome as this repo, star it already or you gonna miss something real cool. |
| 3 | +<img src="img/ic_logo.png" width="25%"/> |
5 | 4 |
|
6 | | -KBye -,- |
| 5 | +QRUtils is a set of pre-built, customizable UI components for creating and reading QR codes. It provides different libraries for creating, scanning and reading QR codes. Installation is easy and implementation is easier. |
| 6 | + |
| 7 | +You can expect a fully functional QR scanning activity to launch in **a single line of code** whereas a customized QR code on the device's screen in **just 3 lines of code**. This README will guide you through. Good luck! |
| 8 | + |
| 9 | +> API 14 (Android ICS 4.0) |
| 10 | +
|
| 11 | +## :mag: Table of contents |
| 12 | + |
| 13 | +1. [Modules](#modules) |
| 14 | + 1. [QRView](#qrview) |
| 15 | + 1. [QRActivity](#qractivity) |
| 16 | +1. [Installation](#installation) |
| 17 | +1. [Usage](#usage) |
| 18 | +1. [Sample App](#sample-app) |
| 19 | +1. [Contributing](#contributing) |
| 20 | + |
| 21 | +## Modules |
| 22 | + |
| 23 | +QRUtils provides separate modules for different functionalities. All the modules listed here are concerned with creating or reading QR codes. See individual instructions for each module to know what they do: |
| 24 | + |
| 25 | +## QRView |
| 26 | + |
| 27 | +QRView is a custom Android View that facilitates generation of customized QR codes in as less as **3 lines of code**. It can also generate QR codes directly from XML attributes. Forget 300 lines of code and multiple classes to generate QR bitmaps. This library is all you need. Read more about implementation and usage of QRView [here](qrview/README.md). |
| 28 | + |
| 29 | +## QRActivity |
| 30 | + |
| 31 | +QRActivity is a customizable, pre-built QR scanner activity which you can built with required parameters and launched in order to get the scanned result. Other features include flashlight toggle and file picker to read QR codes from image files. Read more about implementation and usage of QRActivity [here](aractivity/README.md). |
| 32 | + |
| 33 | +## Installation |
| 34 | + |
| 35 | +In your `app/build.gradle` file add a dependency on one of the QRUtils libraries. |
| 36 | + |
| 37 | +```groovy |
| 38 | +
|
| 39 | +dependencies { |
| 40 | +
|
| 41 | + // QRView for generating QR codes |
| 42 | + implementation 'chtgupta.qrutils:qrview:0.1.0' |
| 43 | +
|
| 44 | + // QRActivity for reading QR codes |
| 45 | + implementation 'chtgupta.qrutils:qractivity:0.1.0' |
| 46 | +} |
| 47 | +
|
| 48 | +``` |
| 49 | + |
| 50 | +## Usage |
| 51 | +To get started, see the individual instructions for each module: |
| 52 | + |
| 53 | +* [QRView](qrview/README.md) |
| 54 | +* [QRActivity](qractivity/README.md) |
| 55 | + |
| 56 | +## Sample app |
| 57 | + |
| 58 | +There is a sample app in the [`app/`](app) directory that demonstrates most |
| 59 | +of the features of QRUtils. Load the project in Android Studio and |
| 60 | +run it on your Android device to see a demonstration. |
| 61 | + |
| 62 | +If you encounter a version incompatibility error between Android Studio |
| 63 | +and Gradle while trying to run the sample app, try disabling the Instant |
| 64 | +Run feature of Android Studio. Alternatively, update Android Studio and |
| 65 | +Gradle to their latest versions. |
| 66 | + |
| 67 | +A note on importing the project using Android Studio: Using 'Project from |
| 68 | +Version Control' will not automatically link the project with Gradle |
| 69 | +(issue [#1349](https://github.com/firebase/FirebaseUI-Android/issues/1349)). |
| 70 | +When doing so and opening any `build.gradle.kts` file, an error shows up: |
| 71 | +`Project 'QRUtils-Android' isn't linked with Gradle`. To resolve this |
| 72 | +issue, please `git checkout` the project manually and import with `Import |
| 73 | +from external model`. |
| 74 | + |
| 75 | +## Contributing |
| 76 | + |
| 77 | +1. **Fork** it |
| 78 | +2. **Clone** the project to your own machine |
| 79 | +3. **Commit** changes to your own branch |
| 80 | +4. **Push** your work back up to your fork |
| 81 | +5. Submit a **Pull request** so that I can review changes |
| 82 | + |
| 83 | + |
| 84 | +## Release History |
| 85 | + |
| 86 | +* 0.1.0 |
| 87 | + * Initial release |
| 88 | + |
| 89 | +## Support |
| 90 | + |
| 91 | +* Liked my work? **Star** it to show support! |
| 92 | +* Used it in your app? Let me know and I'll include your app name, logo and link in this repository. |
| 93 | +* Want to take this to another level? Read ``CONTRIBUTING`` again! |
| 94 | + |
| 95 | + |
| 96 | +## Meta |
| 97 | + |
| 98 | +Chahat Gupta – [@chtgupta](https://chtgupta.github.io) – admin@speakapp.me |
| 99 | + |
| 100 | +Distributed under the APACHE 2.0 license. See ``LICENSE`` for more information. |
| 101 | + |
| 102 | +https://github.com/chtgupta/QRUtils-Android |
0 commit comments