Merge pull request #21 from getyoti/YM-23299

[YM-23299] - Allowing theme to be applied to the YotiSDKButton

Author: ChethanYoti

CHANGELOG.md

@@ -1,6 +1,14 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [1.3.0] - 2021-07-20
+### Added
+- Added attribute buttonTheme to the YotiSDKButton for applying the theme.
+- Added OnAppNotInstalledListener for listening to app not installed status.
+
+### Changed
+- Deprecated the OnYotiAppNotInstalledListener
+
 ## [1.2.0] - 2020-03-26
 ### Changed
 Move some SDK configuration to gradle. This allows for creating skinned SDKs with different backends,

README.md

@@ -75,8 +75,18 @@ android:id="@+id/my_id"
 android:layout_height="wrap_content"
 android:layout_width="wrap_content"
 android:text="My Yoti Button"
-yoti:useCaseId="YOUR_USE_CASE_ID"/>
+yoti:useCaseId="YOUR_USE_CASE_ID"
+yoti:buttonTheme="<Theme_Yoti | Theme_EasyId | Theme_Partnership>"/>
 ```
+
+In case ```yoti:buttonTheme``` is not provided, then ```Theme_Partnership``` is considered as a default theme.
+ 
+When the theme is applied as ```Theme_Yoti``` or ```Theme_Partnership```
+* User can share attribute either through Yoti or EasyId app
+
+When the theme is applied as ```Theme_EasyId```
+* User can share attribute only through EasyId app
+
 [See this code in one of our sample apps](./sample-app/src/main/res/layout/activity_main.xml)
 
 Alternatively, you can set the button's useCaseId with:
@@ -198,7 +208,7 @@ yotiSDKButton.setOnYotiButtonListener(new YotiSDKButton.OnYotiButtonClickListene
 There is also a listener that you can set to be notified when the intent has been sent to the Yoti app.
 When this happens you would probably want to restore your state.
 
-
+Attention: This listener is now deprecated.
 ```java
         yotiSDKButton.setOnYotiCalledListener(new YotiSDKButton.OnYotiCalledListener() {
             @Override
@@ -207,6 +217,16 @@ When this happens you would probably want to restore your state.
             }
         }); 
 ```
+Please use the below listener to get notified when the intent has been sent to app based on the specified theme:
+```java
+        yotiSDKButton.setOnAppCalledListener(new YotiSDKButton.OnAppCalledListener() {
+            @Override
+            public void onAppCalled() {
+                // Restore the original state
+            }
+        }); 
+```
+
 [See this code in one of our sample apps](./sample-app/src/main/java/com/yoti/mobile/android/sdk/sampleapp/MainActivity.java)
 
 You can activate a verbose mode for the SDK by using this method :
@@ -218,6 +238,7 @@ If the Yoti app is not installed in the user's phone by default the SDK will sen
 open a website that invites the user to download the Yoti app.
 Alternatively, an error listener can be set up so you can deal with this situation by yourself.
 
+Attention: This listener is now deprecated.
 ```java
         yotiSDKButton.setOnYotiAppNotInstalledListener(new YotiSDKButton.OnYotiAppNotInstalledListener() {
             @Override
@@ -226,6 +247,17 @@ Alternatively, an error listener can be set up so you can deal with this situati
             }
         });
 ```
+Please use the below listener to determine whether the Yoti/EasyId app is not installed:
+```java
+        mYotiSDKButton.setOnAppNotInstalledListener(new OnAppNotInstalledListener() {
+            @Override
+            public void onAppNotInstalled(final YotiSDKAppNotInstalledException cause, final String appURL) {
+                // The exception will provide info on which app is not installed
+                // appURL is the app's play store URL, launch the browser intent to allow user to download the app and proceed
+            }
+        });
+```
+[See this code in one of our sample apps](./sample-app/src/main/java/com/yoti/mobile/android/sdk/sampleapp/MainActivity.java)
 
 ## Running the Example
 

gradle.properties

@@ -21,11 +21,11 @@
 #org.gradle.daemon=true
 
 
-minSdkVersionVersion=15
+minSdkVersionVersion=21
 targetSdkVersion=28
 compileSdkVersion=28
 
-yotiCommonUIVersion=0.0.5
+uiWidgetsVersion=1.9.0
 supportLibraryVersion=1.0.2
 
 libJunitVersion=4.12
@@ -35,17 +35,30 @@ currentAppName=Mobile Button SDK
 
 #Environment
 yotiAppPackage=com.yoti.mobile.android.live
+easyIdAppPackage=com.postofficeid.mobile.android.live
 yotiAppMinVersion=1622
 yotiBackendUrl=https://api.yoti.com
 yotiBackendPort=443
 
+#app url
+yotiAppUrl=https://play.google.com/store/apps/details?id=com.yoti.mobile.android.live
+easyIdAppUrl=https://play.google.com/store/apps/details?id=com.postofficeid.mobile.android.live
+partnershipAppUrl=https://code.yoti.com/
+
+#deeplink host url
+appHostUrl=code.yoti.com
+
+#app scheme
+yotiAppScheme=yoti://
+easyIDScheme=easyid://
+
 # Publication
 pomId=yoti-button-sdk
 pomGroup=com.yoti.mobile.android.sdk
 pomPackaging=aar
-pomVersion=1.2.1
+pomVersion=1.3.0
 pomDescription=Button SDK that allows 3rd party to trigger Yoti as support app
-currentVersionCode=000009
+currentVersionCode=000010
 
 pomLicenseName=MIT
 pomLicenseUrl=https://github.com/getyoti/android-sdk-button/blob/master/LICENSE.md

sample-app-2/build.gradle

@@ -21,12 +21,16 @@ android {
         }
     }
 
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
 }
 
 dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
     implementation parent.ext.libAndroidSupport
-    testImplementation 'junit:junit:4.12'
-    implementation("com.yoti.mobile.android.sdk:yoti-button-sdk:1.1.0")
+    //implementation("com.yoti.mobile.android.sdk:yoti-button-sdk:1.1.0")
+    implementation project(path: ':yoti-sdk')
     implementation 'com.google.code.gson:gson:2.8.5'
 }

sample-app-2/src/main/AndroidManifest.xml

@@ -15,7 +15,8 @@
 
         <activity
             android:name="com.yoti.mobile.android.sampleapp2.MainActivity"
-            android:launchMode="singleInstance">
+            android:launchMode="singleInstance"
+            android:theme="@style/SampleAppFullScreenTheme">
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />
 

sample-app-2/src/main/java/com/yoti/mobile/android/sampleapp2/MainActivity.java

@@ -33,7 +33,7 @@ protected void onCreate(Bundle savedInstanceState) {
 
         processExtraData(getIntent());
 
-        yotiSDKButton.setOnYotiScenarioListener(new YotiSDKButton.OnYotiButtonClickListener() {
+        yotiSDKButton.setOnYotiButtonClickListener(new YotiSDKButton.OnYotiButtonClickListener() {
             @Override
             public void onStartScenario() {
                 yotiSDKButton.setVisibility(View.GONE);

sample-app-2/src/main/res/layout/activity_main.xml

@@ -15,7 +15,6 @@
         android:layout_centerVertical="true"
         android:layout_centerInParent="true"
         android:gravity="center"
-        android:text="    Use Yoti"
         yoti:useCaseId="yoti_btn_1" />
 
     <TextView

sample-app-2/src/main/res/values-night/styles.xml

@@ -0,0 +1,7 @@
+<resources>
+
+    <style name="SampleAppFullScreenTheme" parent="AppTheme">
+        <item name="android:background">@android:color/black</item>
+    </style>
+
+</resources>

sample-app-2/src/main/res/values/styles.xml

@@ -1,11 +1,15 @@
 <resources>
 
     <!-- Base application theme. -->
-    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
+    <style name="AppTheme" parent="Theme.MaterialComponents.DayNight">
         <!-- Customize your theme here. -->
         <item name="colorPrimary">@color/colorPrimary</item>
         <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
         <item name="colorAccent">@color/colorAccent</item>
     </style>
 
+    <style name="SampleAppFullScreenTheme" parent="AppTheme">
+        <item name="android:background">@android:color/white</item>
+    </style>
+
 </resources>

sample-app-3/build.gradle

@@ -11,6 +11,11 @@ android {
         versionName "1.0"
     }
 
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+
     signingConfigs {
         debug {
             storeFile file('debug.keystore')