Added:

- new setOnYotiButtonClickListener method. Changelog file
- gradle plugin for closing and publication of the repo on OSSRH (maven central)
Modified:
- Deprecating setOnYotiScenarioListener method
- Using newest version of base-commons-ui that adds space between the image and the text of the Yoti button
- Sorting out issues in the gradle files.
- Small changes in the Readme file
Removed:
- Retrieve profile section from the README file

Author: cquemin

CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+
+## [0.0.6] - 2018-04-10
+### Added
+- setOnYotiButtonClickListener method
+- Changelog file
+
+### Changed
+- Deprecating setOnYotiScenarioListener method
+- Using newest version of base-commons-ui that adds space between the image and the text of the Yoti button
+- Sorting out issues in the gradle files.
+- Small changes in the Readme file
+
+### Removed
+- Retrieve profile section from the README file
+
+## [0.0.5] - 2015-12-03
+### Added
+- Sample app where callback is handled manually
+- License file
+
+### Changed
+- "Yoti not installed" scenario can now be dealt with by the user
+

README.md

@@ -20,7 +20,7 @@ This repo contains the tools and step by step instructions so that your users ca
 ## Requirements
 
 * You will need to have the Yoti app on your phone
-* You will need to ensure the minimum version of your android is 2.2.3 or above.
+* You will need to ensure the minimum version of your android is 4.0.3 or above.
 
 
 ## Installing the SDK
@@ -40,7 +40,7 @@ For more information please follow our developer page instructions located [here
 
 Make sure you have mavenCentral repository added in your allProjects entry in your root build.gradle:
 
-```javascript
+```gradle
 allprojects {
     repositories {
         mavenCentral()
@@ -50,15 +50,20 @@ allprojects {
 
 Please start by adding dependencies in the "build.grade" file inside your application module directory:
 
-```javascript
+```gradle
 dependencies {
-    compile(group: 'com.yoti.mobile.android.sdk', name: 'yoti-button-sdk', version: '0.0.5', ext: 'aar'){
-        transitive = true
-    }
-    ...
+    compile(com.yoti.mobile.android.sdk:yoti-button-sdk:0.0.6)
+}
+```
+OR if you are using a recent version of gradle (>= 3.x):
+```gradle
+dependencies {
+    implementation(com.yoti.mobile.android.sdk:yoti-button-sdk:0.0.6)
 }
 ```
 
+[See this code in one of our sample apps](./sample-app/build.gradle)
+
 After syncing, go to your layout file where you wish the Yoti button to appear add the below config:
 
 ```xml
@@ -70,7 +75,7 @@ android:layout_width="wrap_content"
 android:text="My Yoti Button"
 yoti:useCaseId="YOUR_USE_CASE_ID"/>
 ```
-
+[See this code in one of our sample apps](./sample-app/src/main/res/layout/activity_main.xml)
 
 The client end of the integration is now complete.
 
@@ -86,6 +91,7 @@ Add the below configuration to your manifest:
     </intent-filter>
 </receiver>
 ```
+[See this code in one of our sample apps](./sample-app/src/main/AndroidManifest.xml)
 
 Adding this broadcast receiver class, this acts as a listener for Yoti to get the callback URL from the Yoti app. Please note there are two call back options:
 
@@ -102,7 +108,7 @@ To be able to listen to those actions you will need to:
 The AbstractYotiBroadcastReceiver will handle the logic regarding those actions, that's why your BroadcastReceiver will have to extend it. The first action defined (MY_CALLBACK_ACTION) will be used by the Yoti app to give you the result of the attributes sharing with your app.
 We have included both config below :
 
-```javascript
+```java
  @Override
     public boolean onCallbackReceived(String useCaseId, String callbackRoot, String token, String fullUrl) {
         // triggered by MY_CALLBACK_ACTION
@@ -127,12 +133,14 @@ We have included both config below :
     }
 }
 ```
+[See this code in one of our sample apps](./sample-app/src/main/java/com/yoti/mobile/android/sdk/sampleapp/ShareAttributesResultBroadcastReceiver.java)
+
 
 You will now need to specify your Client SDK ID and Scenario ID ready from your application dashboard.
 The SDK can be initialised like this:
 
 
-```javascript
+```java
 Scenario scenario = null;
 try {
     scenario = new Scenario.Builder()
@@ -149,17 +157,38 @@ try {
 YotiSDK.addScenario(scenario);
 ```
 
+[See this code in one of our sample apps](./sample-app/src/main/java/com/yoti/mobile/android/sdk/sampleapp/MainActivity.java)
+
+In order to set a listener for the events on the Yoti button you can specify one this way:
+
+```java
+yotiSDKButton.setOnYotiButtonListener(new YotiSDKButton.OnYotiButtonClickListener() {
+    @Override
+    public void onStartScenario() {
+        yotiSDKButton.setVisibility(View.GONE);
+        progress.setVisibility(View.VISIBLE);
+        message.setText(null); 
+    }
+
+    @Override
+    public void onStartScenarioError(YotiSDKException cause){
+        yotiSDKButton.setVisibility(View.VISIBLE);
+        progress.setVisibility(View.GONE);
+        message.setText(R.string.loc_error_unknown); }
+    });
+```
+
 
 You can activate a verbose mode for the SDK by using this method :
-```javascript
+```java
 YotiSDK.enableSDKLogging(true);
 ```
 
 If the Yoti app is not installed in the user's phone by default the SDK will send and intent to
 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.
 
-```javascript
+```java
         yotiSDKButton.setOnYotiAppNotInstalledListener(new YotiSDKButton.OnYotiAppNotInstalledListener() {
             @Override
             public void onYotiAppNotInstalledError(YotiSDKNoYotiAppException cause) {
@@ -168,65 +197,6 @@ Alternatively, an error listener can be set up so you can deal with this situati
         });
 ```
 
-## Profile Retrieval
-
-Once the profile has been retrieved, you can present that data in the app.
-
-To get the profile details you could do something like this:
-
-```javascript
-Gson g = new GsonBuilder().create();
-        Profile profile = g.fromJson(new String(response), Profile.class);
-
-        Intent intent = new Intent(this, ProfileActivity.class);
-        intent.putExtra(NAME_EXTRA, profile.getGivenNames() + " " + profile.getFamilyName());
-        intent.putExtra(EMAIL_EXTRA, profile.getEmailAddress());
-        intent.putExtra(IMAGE_EXTRA, profile.getSelfie());
-        intent.putExtra(DOB_EXTRA, profile.getDateOfBirth());
-        intent.putExtra(ADDRESS_EXTRA, profile.getPostalAddress());
-        intent.putExtra(MOBILE_EXTRA, profile.getMobNum());
-        intent.putExtra(GENDER_EXTRA, profile.getGender());
-        startActivity(intent);
-```
-
-And then display that data as you would normally do:
-
-```javascript
-     @Override
-     protected void onCreate(Bundle savedInstanceState) {
-         super.onCreate(savedInstanceState);
-         setContentView(R.layout.activity_profile);
-
-         ImageView profile = findViewById(R.id.img_profile);
-         TextView nameTextView = findViewById(R.id.text_view_name);
-         TextView emailTextView = findViewById(R.id.text_view_email);
-         TextView addressTextView = findViewById(R.id.text_view_address);
-         TextView mobileTextView = findViewById(R.id.text_view_mobile);
-         TextView genderTextView = findViewById(R.id.text_view_gender);
-         TextView dobTextView = findViewById(R.id.text_view_dob);
-         TextView nationalityTextView = findViewById(R.id.text_view_nationality);
-
-         String imageString = getIntent().getStringExtra("image");
-         byte[] decodedString = Base64.decode(imageString.substring(imageString.indexOf(",") + 1), Base64.DEFAULT);
-         Bitmap decodedByte = BitmapFactory.decodeByteArray(decodedString, 0, decodedString.length);
-         profile.setImageBitmap(decodedByte);
-         
-         nameTextView.setText(getIntent().getStringExtra("name"));
-         emailTextView.setText(getIntent().getStringExtra("email"));
-         addressTextView.setText(getIntent().getStringExtra("address"));
-         mobileTextView.setText(getIntent().getStringExtra("mobile"));
-         genderTextView.setText(getIntent().getStringExtra("gender"));
-         dobTextView.setText(getIntent().getStringExtra("dob"));
-         nationalityTextView.setText(getIntent().getStringExtra("nationality"));
-     }
-}
-```
-
-## Handling Users
-
-The Web SDK will handle the user storage. When you retrieve the user profile, you receive a user ID generated by Yoti exclusively for your application. This means that if the same individual logs into another app, Yoti will assign her/him a different ID. You can use this ID to verify whether (for your application) the retrieved profile identifies a new or an existing user. Please see relevant github pages for more information.
-
-
 ## Running the Example
 
 In this repository we provide two sample apps.

build.gradle

@@ -4,26 +4,25 @@ buildscript {
     repositories {
         jcenter()
         google()
+        mavenCentral()
     }
     dependencies {
         classpath 'com.android.tools.build:gradle:3.0.1'
-
-        // NOTE: Do not place your application dependencies here; they belong
-        // in the individual module build.gradle files
+        classpath "io.codearte.gradle.nexus:gradle-nexus-staging-plugin:0.11.0"
     }
 }
 
+apply plugin: 'io.codearte.nexus-staging'
+
+
 allprojects {
     repositories {
         mavenCentral()
         jcenter()
-//        maven { url lkRepoRelease }
-//        maven { url lkRepoSnapshot }
         google()
     }
 
     ext {
-
         // Android config
         androidBuildToolsVersion = project.ext.buildToolsVersion
         androidMinSdkVersion = minSdkVersionVersion.toInteger()
@@ -35,90 +34,5 @@ allprojects {
         // Testing
         libJunit = "junit:junit:${libJunitVersion}"
         libMockito = "org.mockito:mockito-all:${libMockitoVersion}"
-
-        updatePomClosure = { MavenPublication publication, String flavor, String buildType, buildTask ->
-            String flavorAsSuffix = (flavor == null ? "" : "-" + flavor);
-            String aarName = "yoti-sdk-" + flavorAsSuffix + "-" + buildType;
-
-            publication.groupId "com.yoti.mobile.android.sdk"
-            publication.artifact source: "$buildDir/outputs/aar/" + aarName + ".aar", builtBy: buildTask
-            publication.artifactId = "button-sdk" + flavorAsSuffix
-            publication.version = currentVersion + (buildType.equalsIgnoreCase("debug") ? "-SNAPSHOT" : "")
-
-            publication.pom.withXml {
-                def dependenciesNode = asNode().appendNode('dependencies')
-
-                Set<String> used = new HashSet<>();
-                configurations.each {
-
-                    def configuration = it.name.toLowerCase()
-
-                    if (configuration.contains("compile") && !configuration.contains("test") && !it.empty) {
-
-                        def dependencies = it.allDependencies.iterator()
-
-                        while (dependencies.hasNext()) {
-
-                            def dependency = dependencies.next();
-
-                            if (dependency.group) {
-
-                                def artifactId = dependency.name;
-                                def dependencyVersion = dependency.version;
-
-                                // For yoti specific dependency, it must either start with buildType or Contain Flavour and
-                                if (((flavor != null && !configuration.contains(flavor)
-                                        && !configuration.startsWith(buildType))
-                                        || !configuration.contains(buildType))
-                                        && dependency.group.startsWith("com.yoti")) {
-                                    continue;
-                                }
-
-                                // For yoti specific Project Dependencies add the build suffix to dependency version depending on buildType of dependency configuration.
-                                if (dependency instanceof ProjectDependency) {
-                                    def depConf = ((ProjectDependency) dependency).projectConfiguration.name;
-                                    if (depConf.toLowerCase().contains("debug")) {
-                                        dependencyVersion += "-SNAPSHOT"
-                                    }
-                                    println(depConf);
-                                }
-
-                                // For yoti specific dependencies add the environment name to the artifactId
-                                if (dependency.group.contains("com.yoti.mobile.android.core") ||
-                                        dependency.group.contains("com.yoti.mobile.android.app")) {
-
-                                    if (configuration.contains("prep")) {
-                                        artifactId = dependency.name + "-prep"
-
-                                    } else if (configuration.contains("prod")) {
-                                        artifactId = dependency.name + "-prod"
-
-                                    } else if (configuration.contains("staging")) {
-                                        artifactId = dependency.name + "-staging"
-                                    }
-                                }
-
-                                def fullArtefact = dependency.group + ":" + artifactId + ":" + dependencyVersion;
-                                println("artficat-LOG:: " + fullArtefact)
-
-                                if (!used.contains(fullArtefact)) {
-                                    used.add(fullArtefact)
-
-                                    def dependencyNode = dependenciesNode.appendNode('dependency')
-                                    dependencyNode.appendNode('groupId', dependency.group)
-                                    dependencyNode.appendNode('artifactId', artifactId)
-                                    dependencyNode.appendNode('version', dependencyVersion)
-                                    dependencyNode.appendNode('scope', 'compile')
-                                }
-                            }
-                        }
-                    }
-                }
-            }
-        }
     }
 }
-
-task clean(type: Delete) {
-    delete rootProject.buildDir
-}

gradle.properties

@@ -26,26 +26,31 @@ minSdkVersionVersion=15
 targetSdkVersion=25
 compileSdkVersion=25
 
-yotiCommonUIVersion=0.0.3
+yotiCommonUIVersion=0.0.5
 supportLibraryVersion=25.3.1
 
 libJunitVersion=4.12
 libMockitoVersion=1.10.19
 
-currentVersion=0.0.5
-currentVersionCode=000005
+currentVersion=0.0.6
+currentVersionCode=000006
 currentAppName=Mobile Button SDK
 artefactName=yoti-button-sdk
 
 # OSSRH repositories
 ossrhSnapshotRepository=https://oss.sonatype.org/content/repositories/snapshots
 ossrhRepository=https://oss.sonatype.org/service/local/staging/deploy/maven2/
 
+# Empty sonatype username and password so we can assemble locally
+# To publish define these in your global gradle properties with the correct values or use -P in the command line
+sonatypeUsername
+sonatypePassword
+
 # POM configuration
 pomGroup=com.yoti.mobile.android.sdk
 pomName=Yoti Button SDK
 pomPackaging=aar
-pomDescription=Button SDK that allows a 3rd party app to trigger Yoti as support app
+pomDescription=Button SDK that allws 3rd party to trigger Yoti as support app
 pomUrl=https://github.com/getyoti/android-sdk-button.git
 
 pomScmUrl=scm:https://github.com/getyoti/android-sdk-button.git
@@ -55,9 +60,9 @@ pomScmDevConnection=https://github.com/getyoti/android-sdk-button.git
 pomLicenseName=Yoti License
 pomLicenseUrl=https://github.com/getyoti/java/LICENSE.txt
 
-pomDeveloperNames=Adrien Violet,Cyrille Quemin, Eduardo Gomez
-pomDeveloperIds=AdrienVioletYoti,cquemin,eduardoyoti
+pomDeveloperNames=Adrien Violet,Cyrille Quemin
+pomDeveloperIds=AdrienVioletYoti,cquemin
 
 #name of thask that will generate extra artifact to archives
 #artifactsToArchive=generateDebugJavadocJar,generateDebugSourcesJar
-artifactsToArchive=generateReleaseJavadocJar,generateReleaseSourcesJar
+artifactsToArchive=generateReleaseJavadocJar,generateReleaseSourcesJar

gradle/wrapper/gradle-wrapper.properties

@@ -1,4 +1,4 @@
-#Tue Jan 30 14:55:41 GMT 2018
+#Thu Apr 26 16:21:18 BST 2018
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME