Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/minmao-hub/mmscan

QRCode and barcode scanning tool【轻量级的二维码以及条码扫描-> 使用iOS自带API开发】
https://github.com/minmao-hub/mmscan

barcode create-qr-code-image qrcode qrcode-generator qrcode-scanner scan scancode

Last synced: about 2 months ago
JSON representation

QRCode and barcode scanning tool【轻量级的二维码以及条码扫描-> 使用iOS自带API开发】

Host: GitHub
URL: https://github.com/minmao-hub/mmscan
Owner: MinMao-Hub
License: mit
Created: 2017-11-01T02:05:33.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2021-10-29T02:47:15.000Z (about 3 years ago)
Last Synced: 2024-10-18T22:36:32.691Z (2 months ago)
Topics: barcode, create-qr-code-image, qrcode, qrcode-generator, qrcode-scanner, scan, scancode
Language: Objective-C
Homepage:
Size: 7.2 MB
Stars: 80
Watchers: 6
Forks: 18
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        

## MMScan

[![Building](https://img.shields.io/wercker/ci/wercker/docs.svg?style=flat)](https://cocoapods.org/pods/MMScan) 

[![Building](https://img.shields.io/badge/language-Objective--C-orange.svg?style=flat)](https://cocoapods.org/pods/MMScan)

[![CocoaPods compatible](https://img.shields.io/badge/pod-v1.3.1-blue.svg?style=flat)](https://cocoapods.org/pods/MMScan) 

[![Platform](https://img.shields.io/badge/platform-ios-lightgrey.svg?style=flat)](https://github.com/MinMao-Hub/MMScan)

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](http://opensource.org/licenses/MIT)

### Introduction

`MMScan`是一个简单的二维码以及条码扫描工具，使用`Objective-C`语言开发,有一套自定义的扫描动画以及界面，还包括生成二维码以及条码【一行代码搞定】

`MMScan ` is an simple QRCode and barcode scanning tool,Contains a separate set of interfaces and a single call, as well as the generation of QRCode code and bar code, a line of code can run.

### Rquirements

* iOS 9.0+

* Xcode 9

* Xcode 8 

### Installation

#### Install with  Cocoapods

记得更新你的pod-master,命令`pod repo update master`

* `pod 'MMScan', '~> 0.0'`

* `#import  `  in you code

#### Copy code into project

[克隆代码](https://github.com/MinMao-Hub/MMScan.git)，然后将MMScanner文件夹下面的所有文件【包含资源】加入到你的项目中即可。	

Just clone and add the folder `MMScanner` to your project.

### Example

* 2021.2.19 更新, 扫描区域改变动画，切换更加丝滑，参考自CSDN大佬 [iOS 为CALayer添加可动画的属性](https://blog.csdn.net/Hello_Hwc/article/details/50522634)



	





	





	



### Usage

下面仅介绍简单的使用，具体使用见[MMScanDemo](https://github.com/MinMao-Hub/MMScan.git)

引入头文件`#import "MMScanViewController.h"`,如果是使用`cocoapods`，则需要引入`#import `

***PS:注意事项***

因为会调用到相册和相机权限，所以一定要记得在`info.plist`文件中添加必要的权限代码

```

NSCameraUsageDescription

App需要您的同意,才能访问相机

NSPhotoLibraryUsageDescription

App需要您的同意,才能访问相册

NSPhotoLibraryAddUsageDescription

App需要您的同意,才能添加图片到相册

```

#### 扫描二维码&条码

```Objective-C

MMScanViewController *scanVc = [[MMScanViewController alloc] initWithQrType:MMScanTypeAll onFinish:^(NSString *result, NSError *error) {

    if (error) {

        NSLog(@"error: %@",error);

    } else {

        NSLog(@"扫描结果：%@",result);

    }

}];

[self.navigationController pushViewController:scanVc animated:YES];

```

##### 注释

1. `QrType`

	

	有三种值：【MMScanTypeAll、MMScanTypeQrCode、MMScanTypeBarCode】

	* `MMScanTypeAll`  界面下方有个菜单，支持切换二维码和条码的扫描

	* `MMScanTypeQrCode` 单纯的二维码扫描

	* `MMScanTypeBarCode` 单纯的条码扫描

2. 回调结果

	

	回调回来的是扫描结果，如果是多张二维码，也只返回一条数据【数组中的第一条】

#### 生成二维码以及条码

```

//生成二维码

UIImage *image = [MMScanViewController createQRImageWithString:_linkTfd.text QRSize:CGSizeMake(250, 250) QRColor:[UIColor blackColor] bkColor:[UIColor colorWithRed:0.318 green:0.690 blue:0.839 alpha:1.00]];

//如果不需要设置背景色以及前景色，则使用下面代码  默认白色底黑色码

UIImage *image = [ScanViewController createQRImageWithString:_linkTfd.text QRSize:CGSizeMake(250, 250)];

//生成条形码

UIImage *image = [MMScanViewController createBarCodeImageWithString:_linkTfd.text QRSize:CGSizeMake(250, 150) QRColor:[UIColor blackColor] bkColor:[UIColor colorWithRed:0.318 green:0.690 blue:0.839 alpha:1.00]];

//如果不需要设置背景色以及前景色，则使用下面代码  默认白色底黑色码

UIImage *image = [ScanViewController createBarCodeImageWithString:_linkTfd.text barSize:CGSizeMake(250, 150)];

```

### 更多

更多自定义以及修改原有属性，[请看源码](https://github.com/MinMao-Hub/MMScan/tree/master/MMScanner)

### Update Log

> *v0.0.9* [2021.2.22]

* 修复使用Cocoapods - use_frameworks! 时bundle找不到问题

> *v0.0.8* [2021.2.19]

* 扫描切换动画，用起来更加丝滑

* 删除历史记录查看功能

> *v0.0.7* [2018.6.11]

> *v0.0.6* [2018.6.10]

* 新增历史记录查看功能

* 新增导航条小按钮自定义功能



> *v0.0.5* [2017.12.21]

* 闪光灯小按钮问题处理【扫一扫底部工具栏切换时，闪光灯会关闭，需要重置小按钮的选中状态】



> *v0.0.4* [2017.12.21]

1. 添加闪光灯小按钮 [#Issues-1](https://github.com/MinMao-Hub/MMScan/issues/1)

2. 底部toolBar适配iPhone X【只在模拟器测试过】



### Case

|案例1|案例2|案例3|

|:-:|:-:|:-:|

|
二维码生成器
|扫一扫|条码生成器|

### Contribution

You are welcome to fork and submit pull requests.

### License

MMScan is open-sourced software licensed under the MIT license.