Skip to content

Commit cdb367f

Browse files
authored
Update README.md
1 parent b674fcc commit cdb367f

File tree

1 file changed

+99
-3
lines changed

1 file changed

+99
-3
lines changed

README.md

Lines changed: 99 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,102 @@
11
# QRUtils-Android
2-
QRUtils is a set of pre-built, customizable UI components for creating and reading QR codes.
32

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%"/>
54

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

Comments
 (0)