Skip to content

Commit

Permalink
Final commit for 4.4.0
Browse files Browse the repository at this point in the history
  • Loading branch information
JumioMobileTeam committed Feb 2, 2023
1 parent 4e317c5 commit d9f52c3
Show file tree
Hide file tree
Showing 11 changed files with 8,085 additions and 785 deletions.
44 changes: 25 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Official Jumio Mobile SDK plugin for Apache Cordova

This plugin is compatible with version 4.3.0 of the Jumio SDK. If you have questions, please reach out to your Account Manager or contact [Jumio Support](#support).
This plugin is compatible with version 4.4.0 of the Jumio SDK (4.4.0 for iOS, 4.4.1 for Android). If you have questions, please reach out to your Account Manager or contact [Jumio Support](#support).

# Table of Contents
- [Compatibility](#compatibility)
Expand All @@ -15,13 +15,14 @@ This plugin is compatible with version 4.3.0 of the Jumio SDK. If you have quest
- [Configuration](#configuration)
- [Callbacks](#callbacks)
- [FAQ](#faq)
- [iOS Localization](#ios-localization)
- [Framework not found iProov.xcframework](#framework-not-found-iproovxcframework)
- [Support](#support)

## Compatibility
With this release, we only ensure compatibility with the latest Cordova versions and plugins.
At the time of this release, the following minimum versions are supported:
* Cordova: 11.0.0
* Cordova: 11.1.0
* Cordova Android: 11.0.0
* Cordova iOS: 6.2.0

Expand All @@ -32,7 +33,7 @@ cordova create MyProject com.my.project "MyProject"
cd MyProject
cordova platform add ios
cordova platform add android
cordova plugin add https://github.com/Jumio/mobile-cordova.git#v4.3.0
cordova plugin add https://github.com/Jumio/mobile-cordova.git#v4.4.0
```

## Integration
Expand Down Expand Up @@ -74,7 +75,7 @@ Jumio.start(successCallback, errorCallback);

## Customization
### Android
The JumioSDK colors can be customized by overriding the custom theme `AppThemeCustomJumio`. The styles-file for Android is automatically copied to your app by the rule in the `plugin.xml`. An example customization of all values that can be found in the [jumio-styles.xml of the plugin](src/android/res/values/jumio-styles.xml)
The JumioSDK colors can be customized by overriding the custom theme `AppThemeCustomJumio`. The styles-file for Android is automatically copied to your app by the rule in the `plugin.xml`. An example customization of all values that can be found in the [jumio-styles.xml of the plugin](src/android/res/values/jumio-styles.xml)

### iOS
JumioSDK iOS appearance can be customized to your respective needs. You can customize each color based on the device's set appearance, for either Dark mode or Light mode, or you can set a single color for both appearances. Customization is optional and not required.
Expand All @@ -83,20 +84,19 @@ You can pass the following customization options at [`Jumio.start`](demo/www/js/

| Customization key |
|:------------------------------------------------|
| iProovLineColor |
| iProovHeaderTextColor |
| iProovHeaderBackgroundColor |
| iProovPromptTextColor |
| iProovFooterBackgroundColor |
| iProovCloseButtonTintColor |
| iProovLivenessAssurancePrimaryTintColor |
| iProovLivenessAssuranceSecondaryTintColor |
| iProovGenuinePresenceAssuranceProgressBarColor |
| iProovGenuinePresenceAssuranceNotReadyTintColor |
| iProovGenuinePresenceAssuranceReadyTintColor |
| iProovAnimationForeground |
| iProovAnimationBackground |
| iProovFloatingPromptEnabled |
| iProovFilterForegroundColor |
| iProovFilterBackgroundColor |
| iProovTitleTextColor |
| iProovCloseButtonTintColor |
| iProovSurroundColor |
| iProovPromptTextColor |
| iProovPromptBackgroundColor |
| genuinePresenceAssuranceReadyOvalStrokeColor |
| genuinePresenceAssuranceNotReadyOvalStrokeColor |
| livenessAssuranceOvalStrokeColor |
| livenessAssuranceCompletedOvalStrokeColor |
| primaryButtonBackground |
| primaryButtonBackgroundPressed |
| primaryButtonBackgroundDisabled |
Expand Down Expand Up @@ -134,6 +134,11 @@ You can pass the following customization options at [`Jumio.start`](demo/www/js/
| searchBubbleBackground |
| searchBubbleForeground |
| searchBubbleListItemSelected |
| confirmationImageBackground |
| confirmationImageBackgroundBorder |
| confirmationIndicatorActive |
| confirmationIndicatorDefault |
| background |
| navigationIconColor |
| textForegroundColor |
| primaryColor |
Expand Down Expand Up @@ -216,15 +221,16 @@ This is a list of common __Android build issues__ and how to resolve them:
* Device-ready not fired after X seconds
--> The plugin definition in "YOURPROJECT/platforms/android/platform_www/plugins/cordova-plugin-jumio-mobilesdk/www" might be duplicated/corrupted due to the issue mentioned [in this Stackoverflow post](https://stackoverflow.com/questions/28017540/cordova-plugin-javascript-gets-corrupted-when-added-to-project/28264312#28264312). Please fix the duplicated `cordova.define()` call in these files as mentioned in the post.

In case there are __cocoapods adjustments__ that need to be made, please refer to your `Podfile` under `platforms/ios/Podfile`.
In case there are __iOS Localization updates__ that need to be made, please refer to your `Localizations` folder under `platforms/ios/Pods/JumioMobileSDK/Localizations` after running `pod install`.
### iOS Localization
After installing Cocoapods, please localize your iOS application using the languages provided at the following path:
`ios -> Pods -> Jumio -> Localizations -> xx.lproj`

## Framework not found iProov.xcframework
If iOS application build is failing with `ld: framework not found iProov.xcframework` or `dyld: Symbol not found: ... Referenced from: /.../Frameworks/iProov.frameworks/iProov`, please make sure the necessary post install-hook has been included in your `Podfile`:
```
post_install do |installer|
installer.pods_project.targets.each do |target|
if ['iProov', 'Socket.IO-Client-Swift', 'Starscream', 'DatadogSDK'].include? target.name
if ['iProov', 'Starscream', 'DatadogSDK', 'SwiftProtobuf'].include? target.name
target.build_configurations.each do |config|
config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
end
Expand Down
2 changes: 1 addition & 1 deletion demo/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ cordova prepare

Navigate to `platforms/ios/Podfile` and add the following:
```
dynamic_frameworks = ['Socket.IO-Client-Swift', 'Starscream', 'iProov', 'DatadogSDK']
dynamic_frameworks = ['Starscream', 'iProov', 'DatadogSDK', 'SwiftProtobuf']
# make all the other frameworks into static frameworks by overriding the static_framework? function to return true
pre_install do |installer|
Expand Down
10 changes: 5 additions & 5 deletions demo/config.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding='utf-8'?>
<widget id="com.jumio.cordova.demo" version="4.3.0" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
<widget id="com.jumio.cordova.demo" version="4.4.0" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
<name>DemoApp</name>
<description>
A sample Apache Cordova application that responds to the deviceready event.
Expand Down Expand Up @@ -34,11 +34,11 @@
<preference name="deployment-target" value="11.0" />
</platform>
<preference name="AndroidXEnabled" value="true" />
<preference name="GradlePluginKotlinEnabled" value="true" />
<preference name="GradlePluginKotlinEnabled" value="false" />
<preference name="GradlePluginKotlinCodeStyle" value="official" />
<preference name="GradlePluginKotlinVersion" value="1.7.0" />
<preference name="GradlePluginKotlinVersion" value="1.8.0" />
<preference name="android-minSdkVersion" value="21" />
<preference name="android-maxSdkVersion" value="31" />
<preference name="android-targetSdkVersion" value="31" />
<preference name="android-maxSdkVersion" value="32" />
<preference name="android-targetSdkVersion" value="32" />
<preference name="UseSwiftLanguageVersion" value="5.2" />
</widget>
Loading

0 comments on commit d9f52c3

Please sign in to comment.