An awesome QR code generator for Android.
Clone or download
Latest commit bca53a3 May 2, 2017
Failed to load latest commit information.
.idea Minor fixes; May 2, 2017
app Minor fixes; May 2, 2017
art Updated readme; updated sample app's launcher icon; Apr 27, 2017
gradle/wrapper Initial Apr 27, 2017
library Minor fixes; May 2, 2017
.gitignore Updated readme; updated sample app's launcher icon; Apr 27, 2017
LICENSE Updated readme; Apr 27, 2017 Updated readme; May 2, 2017
build.gradle Initial Apr 27, 2017 Initial Apr 27, 2017
gradlew Initial Apr 27, 2017
gradlew.bat Initial Apr 27, 2017
settings.gradle First version Apr 27, 2017


An awesome(simple) QR code generator for Android.

一个优雅的(不起眼的) QR 二维码生成器

Get sample APK, 下载演示 APK

Google Play Store

Examples, 样例

Try to scan these QR codes below with your smart phone.

Example 1 Example 2 Example 3

Add dependency, 添加依赖项

Add below lines in build.gradle of your project:

allprojects {
	repositories {
		maven { url '' }

Then, add below lines in build.gradle of your app module:

dependencies {
        compile 'com.github.SumiMakito:AwesomeQRCode:1.0.0'

Quick start, 快速上手

Bitmap qrCode = AwesomeQRCode.create("Makito loves Kafuu Chino.", 800, 20, 0.3f, Color.BLACK, Color.WHITE, backgroundBitmap, true, true);

Parameters, 参数

public static Bitmap create(
        String contents,        // Contents to encode. 欲编码的内容
        int size,               // Width as well as the height of the output QR code, includes margin. 尺寸, 长宽一致
        int margin,             // Margin to add around the QR code. 二维码边缘的外边距
        float dataDotScale,     // Scale the data blocks and makes them appear smaller. 数据点缩小比例 (0 < scale < 1.0f)
        int colorDark,          // Color of blocks. Will be OVERRIDE by autoColor. (BYTE_DTA, BYTE_POS, BYTE_AGN, BYTE_TMG) 实点的颜色
        int colorLight,         // Color of empty space. Will be OVERRIDE by autoColor. (BYTE_EPT) 空白点的颜色
        Bitmap backgroundImage, // The background image to embed in the QR code. If null, no background image will be embedded. 欲嵌入的背景图
        boolean whiteMargin,    // If true, background image will not be drawn on the margin area. Default is true. 若为 true, 则背景图将不会绘制到外边距区域
        boolean autoColor,      // If true, colorDark will be set to the dominant color of backgroundImage. Default is true. 若为 true, 则将从背景图取主要颜色作为实点颜色
        boolean binarize,       // If true, background images will be binarized. Default is false. 若为 true, 背景图像将被二值化处理
        int binarizeThreshold   // Threshold value used while binarizing background images. Default is 128. 0 < threshold < 255. 控制背景图像二值化的阈值
) throws IllegalArgumentException { ... }

Changelog, 更新日志


Now background images can be binarized as you like.


Initial release.

Alternatives on other platforms/in other languages. 其他平台或语言下的对等项目

EFQRCode written in Swift

EFQRCode is a tool to generate QRCode image or recognize QRCode from image, in Swift.

AwesomeQRCode is inspired by EFQRCode by EyreFree.

If your application is in need of generating pretty QR codes in Swift, take a look at EFQRCode. It should help.

Awesome-qr.js written in JavaScript, 支持 JavaScript 的 Awesome-qr.js

Redirect to Awesome-qr.js

Would you like to buy me a cup of cappuccino? 要请我喝一杯卡布奇诺吗?

PayPal Alipay
PayPal Alipay

Copyright & License, 版权信息与授权协议

Copyright © 2017 Sumi Makito

Licensed under Apache License 2.0 License.

Copyright 2017 Sumi Makito

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

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.