Development of the Gini Capture SDK for iOS will be continued in new repository for Gini Capture SDK and new repository for Gini Capture SDK Pinning.
The first public version of the Gini Capture SDK as a swift package would be 1.1.0 (1.0.8 is the latest version that we released for CocoaPods).
A few breaking changes were necessary, but these are easy to fix. You can find the steps in this migration guide.
The Gini Capture SDK provides components for capturing, reviewing and analyzing photos of invoices and remittance slips.
By integrating this library into your application you can allow your users to easily take a picture of a document, review it and get analysis results from the Gini backend.
The Gini Capture SDK can be integrated in two ways, either by using the Screen API or the Component API. In the Screen API we provide pre-defined screens that can be customized in a limited way. The screen and configuration design is based on our long-lasting experience with integration in customer apps. In the Component API, we provide independent views so you can design your own application as you wish. We strongly recommend keeping in mind our UI/UX guidelines, however.
On iPhone, the Gini Capture SDK has been designed for portrait orientation. In the Screen API, orientation is automatically forced to portrait when being displayed. In case you use the Component API, you should limit the view controllers orientation hosting the Component API's views to portrait orientation. This is specifically true for the camera view.
Further documentation with installation, integration or customization guides can be found in our website.
We are providing example apps for Swift and Objective-C. These apps demonstrate how to integrate the Gini Capture SDK with the Screen API and Component API. To run the example project, clone the repo and run pod install from the Example directory first.
To inject your API credentials into the Example app, just add to the Example directory the Credentials.plist file with the following format:
- iOS 10.2+
- Xcode 10.2+
Note: In order to have better analysis results it is highly recommended to enable only devices with 8MP camera and flash. These devices would be:
- iPhones with iOS 10.2 or higher.
- iPad Pro devices (iPad Air 2 and iPad Mini 4 have 8MP camera but no flash).
Gini GmbH, hello@gini.net
The Gini Capture SDK for iOS is licensed under a Private License. See the license for more info.
Important: Always make sure to ship all license notices and permissions with your application.