Evil

适用于 iOS 和 macOS 的 Swift 光学字符识别。

---

图片来自于网络，侵删

需求

• iOS 11.0+ / macOS 10.13+
• Xcode 9.2+
• Swift 4.0+

安装

基本用法

Evil 使用 Vision 框架进行文字识别，因此你需要导入特定的MLModel到你的Xcode工程。例如识别身份证导入识别身份证的model，识别银行卡导入识别银行卡的model。

以下是目前已经训练好的模型

• ChineseIDCard ==> 🇨🇳中国二代身份证号码识别

如何导入

首先从上面的地址下载或者自己训练得到模型文件(*.mlmodel)，然后作为resource资源加入项目。但是模型文件size一般都比较大因此Evil还支持另外一种方式即：运行时从指定的服务器下载对应的模型。

1. 获取对应的模型文件并重名命名为[name].mlmodel [name]可通过以下方法获取print(Recognizer.chineseIDCard.name)
2. 将模型文件上传至自己的服务器或者CDN并获取下载链接
3. 在info.plist 中配置下载链接如下

初始化

lazy var evil = try? Evil(recognizer: .chineseIDCard)

或者 手动指定下载路径

let downloadURL = URL(string: "https://****/ChineseIDCard.mlmodel")!
let chineseIDCard = Recognizer.custom(name: "ChineseIDCard", model: downloadURL, needComplie: true, processor: Recognizer.cropChineseIDCardNumberArea)
let evil = try? Evil(recognizer: chineseIDCard)

或者直接将模型文件拖入 xcode 项目

let url = Bundle.main.url(forResource: "ChineseIDCard", withExtension: "mlmodelc")!
let evil = try? Evil(contentsOf: url, name: "ChineseIDCard")

注意Extension 为mlmodelc而不是mlmodel因为xcode会自动编译mlmodel文件，并且生成对应的class. 所以请务必注意Model文件不要和现有的class重名。

开始识别

let image: Recognizable = .....
let result = evil?.recognize(image)
print(result)

训练模型

参考Tools 目录下PrepareBot项目
参考博文掘金

交流讨论

1.github issue (推荐)
2.qq 群：641256202

LICENSE

 MIT

Copyright 2018 - 2019 Kevin.Gong aoxianglele#icloud.com

Evil 快速上手指南

Evil 是一个基于 Swift 的 OCR（光学字符识别）库，专为 iOS 和 macOS 设计，利用 Apple Vision 框架和 Core ML 模型实现高精度文字识别（如身份证、银行卡等）。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：iOS 11.0+ / macOS 10.13+
• 开发工具：Xcode 9.2+
• 语言版本：Swift 4.0+
• 依赖框架：Vision, CoreML

安装步骤

你可以通过 CocoaPods 或 Carthage 进行安装，也可以直接手动集成。

方式一：CocoaPods（推荐）

在项目的 Podfile 中添加：

pod 'Evil'

然后终端执行：

pod install

方式二：Carthage

在 Cartfile 中添加：

github "evilgix/Evil"

然后终端执行：

carthage update --platform iOS

方式三：手动集成

直接将源码拖入项目，或参考官方 Installation 文档。

基本使用

Evil 的核心逻辑是加载特定的 .mlmodel 模型文件进行识别。以下以中国二代身份证识别为例。

1. 获取模型文件

你需要下载预训练好的模型文件。

• 国内加速下载：中国二代身份证号码识别模型 (ChineseIDCard.mlmodel)

2. 集成模型（三种方式任选其一）

方案 A：运行时动态下载（推荐，减小包体积）

1. 将模型上传至你的服务器或 CDN。
2. 在 Info.plist 中配置模型名称与下载链接的映射（参考 README 中的 evil-download.png 格式）。
3. 代码初始化：

lazy var evil = try? Evil(recognizer: .chineseIDCard)

或者手动指定下载路径：

let downloadURL = URL(string: "https://****/ChineseIDCard.mlmodel")!
let chineseIDCard = Recognizer.custom(name: "ChineseIDCard", model: downloadURL, needComplie: true, processor: Recognizer.cropChineseIDCardNumberArea)
let evil = try? Evil(recognizer: chineseIDCard)

方案 B：本地资源集成

1. 将下载的 ChineseIDCard.mlmodel 拖入 Xcode 项目（确保加入 Target）。
2. Xcode 会自动将其编译为 .mlmodelc 格式。
3. 代码初始化：

// 注意：extension 使用 .mlmodelc，因为 Xcode 已自动编译
let url = Bundle.main.url(forResource: "ChineseIDCard", withExtension: "mlmodelc")!
let evil = try? Evil(contentsOf: url, name: "ChineseIDCard")

注意：Model 文件名不要与项目中现有的 Class 名冲突。

3. 开始识别

准备好图片对象（需符合 Recognizable 协议），调用识别方法：

let image: Recognizable = ..... // 替换为你的 UIImage 或 CGImage
let result = evil?.recognize(image)
print(result)

识别结果将包含提取出的文字信息。