Moving iOS and Android samples and re-structuring the repo

Author: george-bafaloukas-forgerock

.github/workflows/CI.yml

@@ -20,7 +20,7 @@ jobs:
         with:
           path: |
             node_modules
-          key: ${{ runner.os }}-npm-${{matrix.node}}-${{ hashFiles('**/package-lock.json') }}
+          key: ${{ runner.os }}-npm-${{matrix.node}}-${{ hashFiles('**/javascript/package-lock.json') }}
 
       - run: npm ci
         if: steps.cache.outputs.cache-hit != 'true'
@@ -42,7 +42,7 @@ jobs:
         with:
           path: |
             node_modules
-          key: ${{ runner.os }}-npm-${{matrix.node}}-${{ hashFiles('**/package-lock.json') }}
+          key: ${{ runner.os }}-npm-${{matrix.node}}-${{ hashFiles('**/javascript/package-lock.json') }}
 
       - run: npm ci
         if: steps.cache.outputs.cache-hit != 'true'
@@ -62,7 +62,7 @@ jobs:
         with:
           name: Playwright Results - ${{ runner.os }} - ${{ matrix.node }} - ${{ github.run_attempt }}
           path: |
-            reactjs-todo/test-results
-            reactjs-todo/playwright-report
-            angular-todo/test-results
-            angular-todo/playwright-report
+            javascript/reactjs-todo/test-results
+            javascript/reactjs-todo/playwright-report
+            javascript/angular-todo/test-results
+            javascript/angular-todo/playwright-report

.gitignore

@@ -17,3 +17,8 @@ reactjs-todo/public/*
 /playwright/.cache/
 .eslintcache
 reactjs-todo/public/*
+**/xcuserdata/
+.gradle/
+.idea/
+.vscode/
+local.properties

.husky/.gitignore

@@ -7,39 +7,33 @@
 
 ## Samples
 
-ForgeRock provides these samples to help demonstrate SDK functionality/implementation. They are provided "as is" and are not official products of ForgeRock and are not officially supported.
+Ping provides these samples to help demonstrate SDK functionality/implementation. They are provided "as is" and are not official products of Ping and are not officially supported.
 
-To try out the ForgeRock JavaScript SDK please look at one of our samples:
+### Integrate with PingOne Advanced Identity Cloud / PingAM:
 
-- [**Embedded login - `embedded-login`**](./embedded-login/README.md)
+To try out the Ping JavaScript SDK please look at one of our samples under [javascript](./javascript/)
 
-  - A barebones example of how to use the `@forgerock/javascript-sdk` in a vanilla html & javascript app with embedded login.
+To try out the Ping iOS SDK please look at one of our samples under [iOS](./iOS/)
 
-- [**Central login - `central-login`**](./central-login/README.md)
+To try out the Ping Android SDK please look at one of our samples under [android](./android/)
 
-  - A barebones example of how to use the `@forgerock/javascript-sdk` in a vanilla html & javascript app with central login.
+### Integrate with PingOne DaVinci:
 
-- [**React Todo - `reactjs-todo`**](./reactjs-todo/README.md)
-
-  - Todo application that involves authentication and authorization of a user to post Todos with the `@forgerock/javascript-sdk` in ReactJS.
-    The main branch includes many flavors of callbacks, including WebAuthN, embedded login, and social login.
-
-- [**Angular Todo - `angular-todo`**](./angular-todo/README.md)
-  - Todo application that involves authentication and authorization of a user to post Todos with the `@forgerock/javascript-sdk` in Angular.
-    The main branch includes many flavors of callbacks, including WebAuthN, embedded login, and social login.
-
-<!------------------------------------------------------------------------------------------------------------------------------------>
-<!-- DOCS - Link off to the AM-centric documentation at sdks.forgerock.com. -->
+- Samples coming soon
 
 ## Documentation
 
 Documentation for the SDKs is provided on [ForgeRock Backstage](https://backstage.forgerock.com/docs/sdks/latest/index.html), and includes topics such as:
 
 - Introducing the SDK Features
-- Preparing your server for use with the SDKS
+- Preparing your server for use with the SDKs
 - API Reference documentation
 
 ## Requirements
 
+Javascript
 - Please use a modern web browser like Chrome, Safari, or Firefox
 - Node >= 18
+
+iOS
+- Latest Xcode

.husky/pre-commit

@@ -0,0 +1,50 @@
+<p align="center">
+  <a href="https://github.com/ForgeRock/sdk-sample-apps">
+    <img src="https://cdn.forgerock.com/logo/interim/Logo-PingIdentity-ForgeRock-Hor-FullColor.svg" alt="Logo">
+  </a>
+  <hr/>
+</p>
+
+## Samples
+
+Ping provides these Android samples to help demonstrate SDK functionality/implementation. They are provided "as is" and are not official products of Ping and are not officially supported.
+
+### Integrate with PingOne Advanced Identity Cloud / PingAM:
+
+To try out the Ping Android SDK please look at one of our samples:
+
+- [**Java Authenticator - `/java-authenticator`**](./java-authenticator/)
+  
+  - This Authenticator sample app supports registration of multiple accounts and multiple different authentication methods in each account, such as push notifications and one-time passwords.
+
+- [**Java UI prototype - `/java-ui-prototype`**](./java-ui-prototype/)
+  
+  - An example Android project making full use of the Ping SDK with a prototyping UI. Allows to explore the SDK uses in detail with example calls for running Journeys, getting OAuth2.0 tokens, User Info and more. 
+  (https://backstage.forgerock.com/docs/sdks/latest/sdks/tutorials/android/index.html)
+
+- [**Java Quickstart - `/java-quickstart`**](./java-quickstart/)
+  
+  - An example Android project written in Java making use of the SDK. The sample supports the OOTB Login Journey with Username and Password. (https://backstage.forgerock.com/docs/sdks/latest/sdks/tutorials/android/index.html)
+
+- [**Kotlin Quickstart - `/kotlin-quickstart`**](./kotlin-quickstart/)
+  
+  - An example Android project written in Kotlin making use of the SDK. The sample supports the OOTB Login Journey with Username and Password. (https://backstage.forgerock.com/docs/sdks/latest/sdks/tutorials/android/index.html)
+
+- [**Kotlin UI prototype - `/kotlin-ui-prototype`**](./kotlin-ui-prototype/)
+  
+  - An example Android project making full use of the Ping SDK with a prototyping UI, written in Kotlin. Allows to explore the SDK uses in detail with example calls for running Journeys, getting OAuth2.0 tokens, User Info and more. 
+  (https://backstage.forgerock.com/docs/sdks/latest/sdks/tutorials/android/index.html)
+
+
+### Integrate with PingOne DaVinci:
+
+- Samples coming soon
+
+## Requirements
+
+Android
+- Latest Android Studio
+- Java 17+
+- Gradle 8.6+
+- Ping Advanced Identity Cloud or Ping AM 7.1 and above
+- Android API level 23+

README.md

@@ -0,0 +1,31 @@
+<p align="center">
+  <a href="https://github.com/ForgeRock/sdk-sample-apps">
+    <img src="https://cdn.forgerock.com/logo/interim/Logo-PingIdentity-ForgeRock-Hor-FullColor.svg" alt="Logo">
+  </a>
+  <hr/>
+</p>
+
+## Authenticator app sample
+
+Ping provides these Android samples to help demonstrate SDK functionality/implementation. They are provided "as is" and are not official products of Ping and are not officially supported.
+
+### Integrate with MFA capabilities on PingOne Advanced Identity Cloud / PingAM::
+
+- This Authenticator sample app supports registration of multiple accounts and multiple different authentication methods in each account, such as push notifications and one-time passwords.
+
+### Getting started
+
+To try out the ForgeRock Android SDK sample, perform these steps:
+
+- Clone this repo
+- Setup an Journey instance with OATH and/or Push nodes.
+- Open this Android project in Android Studio.
+- Add your google-services.json to the app folder.
+- On the Run menu, click Run 'app'.
+
+## Requirements
+
+- Latest version of Android Studio
+- Ping Advanced Identity Cloud or Ping AM 7.1 and above
+- Android API level 23+
+- Google Firebase project (google-services.json)

android/README.md

@@ -0,0 +1,7 @@
+*.iml
+.idea
+gen
+out
+.gradle
+build
+local.properties

android/java-authenticator/README.md

@@ -0,0 +1,88 @@
+/*
+ * Copyright (c) 2020 - 2024 ForgeRock. All rights reserved.
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+apply plugin: 'com.android.application'
+
+android {
+
+    namespace 'org.forgerock.authenticator.sample'
+    compileSdk 35
+
+    defaultConfig {
+        applicationId "org.forgerock.authenticator.sample"
+        minSdkVersion 23
+        targetSdkVersion 35
+        versionCode 1
+        versionName "1.0"
+
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
+    lintOptions {
+        abortOnError false
+    }
+    buildFeatures {
+        compose true
+        buildConfig true
+    }
+
+}
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+
+    // ForgeRock Authenticator SDK
+    implementation ('org.forgerock:forgerock-authenticator:4.5.0')
+
+    // Loading images dynamically
+    implementation 'com.squareup.picasso:picasso:2.5.2'
+
+    // FCM Notifications
+    implementation "com.google.firebase:firebase-messaging:23.1.2"
+
+    // QRCode scanner - ML Kit dependencies and CameraX
+    implementation 'com.google.mlkit:barcode-scanning:16.1.2'
+    implementation 'androidx.camera:camera-core:1.0.0'
+    implementation 'androidx.camera:camera-camera2:1.0.0'
+    implementation 'androidx.camera:camera-lifecycle:1.0.0'
+    implementation 'androidx.camera:camera-view:1.0.0-alpha25'
+
+    // QRCode scanner - Alternative library
+    implementation('com.journeyapps:zxing-android-embedded:3.3.0') { transitive = false }
+    implementation 'com.google.zxing:core:3.3.3'
+
+    // UI
+    implementation 'androidx.annotation:annotation:1.1.0'
+    implementation 'androidx.appcompat:appcompat:1.3.0'
+    implementation 'androidx.legacy:legacy-support-v4:1.0.0'
+    implementation 'com.google.android.material:material:1.1.0'
+    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
+    implementation 'androidx.recyclerview:recyclerview:1.1.0'
+    implementation 'org.jetbrains:annotations:15.0'
+
+    // Biometric
+    implementation 'androidx.biometric:biometric-ktx:1.2.0-alpha05'
+
+}
+
+apply plugin: 'com.google.gms.google-services'
+googleServices {
+    disableVersionCheck = true
+}
+

android/java-authenticator/authenticator/.gitignore

@@ -0,0 +1,40 @@
+{
+  "project_info": {
+    "project_number": "",
+    "firebase_url": "https://test-authenticator.firebaseio.com",
+    "project_id": "test-authenticator",
+    "storage_bucket": "test-authenticator.appspot.com"
+  },
+  "client": [
+    {
+      "client_info": {
+        "mobilesdk_app_id": "",
+        "android_client_info": {
+          "package_name": ""
+        }
+      },
+      "oauth_client": [
+        {
+          "client_id": "",
+          "client_type": 3
+        }
+      ],
+      "api_key": [
+        {
+          "current_key": ""
+        }
+      ],
+      "services": {
+        "appinvite_service": {
+          "other_platform_oauth_client": [
+            {
+              "client_id": "",
+              "client_type": 3
+            }
+          ]
+        }
+      }
+    }
+  ],
+  "configuration_version": "1"
+}