The markdown parsing is broken/disabled for release notes. Sorry about that, I'm chasing the source of a crash that's been bringing this website down for the last couple of days.
- Uses [Gini Bank API Library 3.1.0](https://github.com/gini/bank-api-library-ios/releases/tag/3.1.0).
- Uses [Gini Capture SDK 3.1.1](https://github.com/gini/capture-sdk-ios/releases/tag/3.1.1).
Features and improvements:
- Allows setting a path for custom domains. For example if you need all requests to go through a proxy at `https://custom.domain.com/custom/path` you can pass `/custom/path` to the `path` parameter when setting a custom api domain:
```swift
let viewController = GiniBank.viewController(withClient: client,
configuration: configuration,
resultsDelegate: self,
api: .custom(domain: "custom.domain.com",
path: "/custom/path"),
tokenSource: CustomTokenSource()))
```
- Uses [Gini Bank API Library 1.6.0](https://github.com/gini/bank-api-library-ios/releases/tag/1.6.0)
- Uses [Gini Capture SDK 1.13.0](https://github.com/gini/capture-sdk-ios/releases/tag/1.13.0).
## Bug fixes and improvements
Added customizable background color for all helps screens (Help menu, Supported formats, Capturing tips, Open with tutorial) via dedicated `GiniBankConfiguration` options.
You can view how to customize those screens [here](https://developer.gini.net/gini-mobile-ios/GiniBankSDK/1.15.0/customization-guide.html#help-screen).
## Documentation
You can find the documentation for this version [here](https://developer.gini.net/gini-mobile-ios/GiniBankSDK/3.1.0/index.html).
## Bug fixes and improvements
- Shows a dedicated no results screen when QR code scanning did not return any payment relevant information. You can view this screen and how it's customized [here](https://developer.gini.net/gini-mobile-android/capture-sdk/sdk/3.1.0/html/customization-guide.html#no-results-screen).
- Texts on the camera screen are updated if QR code scanning is disabled. You can view the new string resources for the camera screen [here](https://developer.gini.net/gini-mobile-ios/GiniBankSDK/3.1.0/customization-guide.html#no-result-screen).
- Fixes layout issues on the camera access and camera screens when using large font sizes.
- Fixes crash when QR Code was detected and user clicks "Cancel".
- Fixes QR Code detection when QR contains parameters with whitespaces.
- Fixes layout issues on the return assistant's digital invoice edit article screen and digital invoice overview screen when using large font sizes.
## Dependencies
- Uses [Gini Bank API Library 3.0.0](https://github.com/gini/bank-api-library-ios/releases/tag/3.0.0)
- Uses [Gini Capture SDK 3.1.0](https://github.com/gini/capture-sdk-ios/releases/tag/3.1.0)
## Example app improvements:
- Adds accessibility support for the result screen
- Uses [Gini Bank API Library 1.6.0](https://github.com/gini/bank-api-library-ios/releases/tag/1.6.0).
- Uses [Gini Capture SDK 1.12.0](https://github.com/gini/capture-sdk-ios/releases/tag/1.12.0).
Features and improvements:
- Allows setting a path for custom domains. For example if you need all requests to go through a proxy at `https://custom.domain.com/custom/path` you can pass `/custom/path` to the path parameter when setting a custom api domain:
```swift
let viewController = GiniBank.viewController(withClient: client,
configuration: configuration,
resultsDelegate: self,
api: .custom(domain: "custom.domain.com",
path: "/custom/path"),
tokenSource: CustomTokenSource()))
```
In version **3.0.0** we modernized our UI and improved the UI customization options to be more flexible and simpler to use.
In addition, we also made integration faster by unifying the public API of the SDK.
- New UI
- All screens have a modern look and feel with support for dark and light modes.
- More flexibility to customize the user interface via global customization options and injection of certain UI elements to freely customize predefined areas of the UI (for example navigation bars, onboarding illustrations, or activity indicators).
- Built-in accessibility standards. For example, reading a screen aloud or increasing font sizes, or zooming into the invoices.
- New Features
- You can enable the bottom navigation bars. Functionality from the top navigation bar will be moved there and you can fully customize them via UI injection.
- You can launch the SDK for scanning payment QR codes. In this mode, the UI is optimized for QR code scanning and other features are disabled.
- Streamlined QR code scanning UI/UX. Users are presented with quick feedback about detected QR codes. If a QR code is valid the SDK will automatically extract the payment information.
- Improved UI/UX for error handling. In case of errors users will be presented with error details and they can choose between retaking the pictures or proceeding with manual entry of payment information.
- Improved UI/UX for handling empty results. If no relevant payment information could be extracted users will be shown tips on how to get better results. As with the error handling users will be able to choose between retaking the pictures or proceeding with the manual entry of payment information.
- Easier feedback sending by passing all values except the one for the amount as strings when cleaning up the SDK after the user has executed the transaction.
- Comprehensive [Migration Guide](https://developer.gini.net/gini-mobile-ios/GiniBankSDK/3.0.0/migration-to-version-3xx.html). Read how to update to version 3.0.0 and learn more about the new features.
- Uses [Gini Capture SDK 3.0.0](https://github.com/gini/capture-sdk-ios/releases/tag/3.0.0).
- Uses [Gini Bank API Library 3.0.0](https://github.com/gini/bank-api-library-ios/releases/tag/3.0.0).
- Uses [Gini Bank API Library 1.5.0](https://github.com/gini/bank-api-library-ios/releases/tag/1.5.0)
- Uses [Gini Capture SDK 1.11.1](https://github.com/gini/capture-sdk-ios/releases/tag/1.11.1).
Features and improvements:
- Fixes the camera preview's aspect ratio on the camera screen to prevent it from being stretched vertically.
- Fixes detection of EPC069-12 payment QR codes.
3.0.0-beta07
10 weeks ago
## Documentation:
- [Documentation](https://developer.gini.net/gini-mobile-ios/GiniBankSDK/3.0.0-beta06/index.html) is in progress, the full version is coming soon π
## Bug fixes and improvements:
- Add haptic feedback if a QR code scan was detected
- Add accessibility support for the top navigation bar
- Provide customization options: title or icon for the cancel, help, back, and done buttons. (Update in the documentation will follow with the next release)
- Fix number formatting for the price value on the return assistant's digital invoice overview screen
- Update UI, add accessibility support, allow the UI customization for the return assistant's digital invoice edit article screen
## Dependencies:
- Uses Gini Bank API Library [3.0.0-beta07](https://github.com/gini/bank-api-library-ios/releases/tag/3.0.0-beta07)
- Uses Gini Capture SDK [3.0.0-beta07](https://github.com/gini/capture-sdk-ios/releases/tag/3.0.0-beta07)
3.0.0-beta06
12 weeks ago
## Documentation:
- [Documentation](https://developer.gini.net/gini-mobile-ios/GiniBankSDK/3.0.0-beta06/index.html) is in progress, the full version is coming soon π
## Bug fixes and improvements:
- Remove the bottom navigation bar from the error screen and no results screen
- Update camera frame orientation in landscape mode (iPad only)
- Show an error dialog when the user imports more than 1 PDF
- Fix the bottom navigation bar color when no camera access view is shown
- Allow implement bottom navigation for the return assistant's overview screen
- Update UI for the return reasons picker
## Dependencies:
- Uses Gini Bank API Library [3.0.0-beta06](https://github.com/gini/bank-api-library-ios/releases/tag/3.0.0-beta06)
- Uses Gini Capture SDK [3.0.0-beta06](https://github.com/gini/capture-sdk-ios/releases/tag/3.0.0-beta06)
## Documentation:
- [Documentation](https://developer.gini.net/gini-mobile-ios/GiniBankSDK/3.0.0-beta05/index.html) is in progress, the full version is coming soon π
## Bug fixes and improvements:
- Improve gallery screen accessibility.
- Fix image cropping.
- Hide help button when in QR code scanning only mode.
- Update photo tips help screen layout.
- Update error screen icons.
- Fix status bar text color.
- Update UI of the return assistant's onboarding screen.
- Update UI of the return assistant's help screen.
## Dependencies:
- Uses Gini Bank API Library [3.0.0-beta05](https://github.com/gini/bank-api-library-ios/releases/tag/3.0.0-beta05)
- Uses Gini Capture SDK [3.0.0-beta05](https://github.com/gini/capture-sdk-ios/releases/tag/3.0.0-beta05)
- Uses [Gini Bank API Library 1.5.0](https://github.com/gini/bank-api-library-ios/releases/tag/1.5.0)
- Uses [Gini Capture SDK 1.11.0](https://github.com/gini/capture-sdk-ios/releases/tag/1.11.0).
Features and improvements:
- Adds `candidates` property to `AnalysisResult`. This allows retrieving the extraction candidates. To learn more about extraction candidates please visit our [API documentation](https://pay-api.gini.net/documentation/#available-extraction-candidates).
Minor breaking change:
- Affects clients who use a custom `GiniCaptureNetworkService` implementation: the `ExtractionResult` initializer has a new `candidates` parameter now. If your backend sends you the extraction candidates then please pass them to the new parameter. If not, then simply pass in an empty map `[:]`.