• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    迪恩网络公众号

WeTransfer/WeScan: Document Scanning Made Easy for iOS

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称:

WeTransfer/WeScan

开源软件地址:

https://github.com/WeTransfer/WeScan

开源编程语言:

Swift 99.5%

开源软件介绍:

WeScan

WeScan makes it easy to add scanning functionalities to your iOS app! It's modelled after UIImagePickerController, which makes it a breeze to use.

Features

  • Fast and lightweight
  • Live scanning of documents
  • Edit detected rectangle
  • Auto scan and flash support
  • Support for both PDF and UIImage
  • Translated to English, Chinese, Italian, Portuguese, and French
  • Batch scanning

Demo

Requirements

  • Swift 5.0
  • iOS 10.0+

Installation

Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler. It is in early development, but WeScan does support its use on supported platforms.

Once you have your Swift package set up, adding WeScan as a dependency is as easy as adding it to the dependencies value of your Package.swift.

dependencies: [
    .package(url: "https://github.com/WeTransfer/WeScan.git", .upToNextMajor(from: "1.7.0"))
]

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

To integrate WeScan into your Xcode project using Carthage, specify it in your Cartfile:

github "WeTransfer/WeScan" >= 0.9

Run carthage update to build the framework and drag the built WeScan.framework into your Xcode project.

Manually

Just download the project, and drag and drop the "WeScan" folder in your project.

Simply add the WeScan framework in the project's Embedded Binaries and Linked Frameworks and Libraries.

Usage

Swift

  1. In order to make the framework available, add import WeScan at the top of the Swift source file

  2. In the Info.plist, add the NSCameraUsageDescription key and set the appropriate value in which you have to inform the user of the reason to allow the camera permission

  3. Make sure that your view controller conforms to the ImageScannerControllerDelegate protocol:

class YourViewController: UIViewController, ImageScannerControllerDelegate {
    // YourViewController code here
}
  1. Implement the delegate functions inside your view controller:
func imageScannerController(_ scanner: ImageScannerController, didFailWithError error: Error) {
    // You are responsible for carefully handling the error
    print(error)
}

func imageScannerController(_ scanner: ImageScannerController, didFinishScanningWithResults results: ImageScannerResults) {
    // The user successfully scanned an image, which is available in the ImageScannerResults
    // You are responsible for dismissing the ImageScannerController
    scanner.dismiss(animated: true)
}

func imageScannerControllerDidCancel(_ scanner: ImageScannerController) {
    // The user tapped 'Cancel' on the scanner
    // You are responsible for dismissing the ImageScannerController
    scanner.dismiss(animated: true)
}
  1. Finally, create and present a ImageScannerController instance somewhere within your view controller:
let scannerViewController = ImageScannerController()
scannerViewController.imageScannerDelegate = self
present(scannerViewController, animated: true)

Objective-C

  1. Create a dummy swift class in your project. When Xcode asks if you'd like to create a bridging header, press 'Create Bridging Header'
  2. In the new header, add the Objective-C class (#import myClass.h) where you want to use WeScan
  3. In your class, import the header (import <yourProjectName.swift.h>)
  4. Drag and drop the WeScan folder to add it to your project
  5. In your class, add @Class ImageScannerController;

Example Implementation

ImageScannerController *scannerViewController = [[ImageScannerController alloc] init];
[self presentViewController:scannerViewController animated:YES completion:nil];

Contributing

As the creators, and maintainers of this project, we're glad to invite contributors to help us stay up to date. Please take a moment to review the contributing document in order to make the contribution process easy and effective for everyone involved.

  • If you found a bug, open an issue.
  • If you have a feature request, open an issue.
  • If you want to contribute, submit a pull request.

License

WeScan is available under the MIT license. See the LICENSE file for more info.




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap