feat: compose sdk

.github/actions/android-emulator-run/action.yml

@@ -0,0 +1,68 @@
+name: android-emulator-run
+description: Do run script after emulator boot (use cached AVD or create a new one)
+
+inputs:
+  script:
+    description: Script to run after emulator booted
+    required: true
+  arch:
+    description: Emulator arch, supported values depends on runner
+    required: true
+    default: x86_64
+  target:
+    description: Emulator target. Supported `default` or `google_apis` values
+    required: true
+    default: default
+  profile:
+    description: Emulator profile
+    required: true
+    default: Nexus 6
+  api-level:
+    description: Emulator API level
+    required: true
+    default: '28'
+  boot-options:
+    description: Emulator boot options
+    required: true
+    default: -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none
+
+runs:
+  using: "composite"
+  steps:
+  - name: Cache AVD
+    uses: actions/cache@v4
+    id: avd-cache
+    with:
+      path: |
+        ~/.android/avd/*
+        ~/.android/adb*
+      key: avd-api-${{ inputs.api-level }}-target-${{ inputs.target }}
+  - if: runner.os == 'Linux'
+    name: Enable KVM group perms
+    shell: bash
+    run: |
+      echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
+      sudo udevadm control --reload-rules
+      sudo udevadm trigger --name-match=kvm
+  - name: 'Create AVD'
+    if: steps.avd-cache.outputs.cache-hit != 'true'
+    uses: reactivecircus/android-emulator-runner@v2
+    with:
+      arch: ${{ inputs.arch }}
+      target: ${{ inputs.target }}
+      profile: ${{ inputs.profile }}
+      api-level: ${{ inputs.api-level }}
+      emulator-options: ${{ inputs.boot-options }}
+      force-avd-creation: false
+      disable-animations: false
+      script: echo "Generated AVD snapshot for caching."
+  - uses: reactivecircus/android-emulator-runner@v2
+    with:
+      arch: ${{ inputs.arch }}
+      target: ${{ inputs.target }}
+      profile: ${{ inputs.profile }}
+      api-level: ${{ inputs.api-level }}
+      emulator-options: ${{ inputs.boot-options }}
+      force-avd-creation: false
+      disable-animations: true
+      script: ${{ inputs.script }}

.github/workflows/ci.yml

@@ -41,7 +41,7 @@ jobs:
 
   build-matrix:
     name: 'Build (target:${{ matrix.target }} compile:${{ matrix.compile }} appcompat: ${{ matrix.appcompat }})'
-    needs: [ test ]
+    needs: test
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
@@ -50,16 +50,16 @@ jobs:
           - compile: 34
             target: 34
             appcompat: 1.6.1
-          - compile: 33
+          - compile: 34
             target: 33
             appcompat: 1.5.1
-          - compile: 32
+          - compile: 34
             target: 32
             appcompat: 1.4.2
-          - compile: 32
+          - compile: 34
             target: 30
             appcompat: 1.3.1
-          - compile: 30
+          - compile: 34
             target: 30
             appcompat: 1.3.1
     steps:
@@ -78,13 +78,9 @@ jobs:
 
   test-ui:
     name: 'Test UI'
-    runs-on: macos-latest
+    needs: test
+    runs-on: ubuntu-latest
     timeout-minutes: 20
-    strategy:
-      fail-fast: false
-      matrix:
-        api-level: [29]
-        target: [default]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-java@v4
@@ -94,39 +90,10 @@ jobs:
       - uses: gradle/gradle-build-action@v3
         with:
           cache-read-only: false
-      - name: 'Cache AVD'
-        uses: actions/cache@v4
-        id: avd-cache
-        with:
-          path: |
-            ~/.android/avd/*
-            ~/.android/adb*
-          key: avd-api-${{ matrix.api-level }}-target-${{ matrix.target }}
-      - name: 'Create AVD'
-        if: steps.avd-cache.outputs.cache-hit != 'true'
-        uses: reactivecircus/android-emulator-runner@v2.29.0
-        with:
-          api-level: ${{ matrix.api-level }}
-          target: ${{ matrix.target }}
-          emulator-options: -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none
-          force-avd-creation: false
-          disable-animations: false
-          arch: x86_64
-          profile: Nexus 6
-          script: echo "Generated AVD snapshot for caching."
-      - name: 'Tests'
-        uses: reactivecircus/android-emulator-runner@v2.29.0
+      - name: Run tests
+        uses: ./.github/actions/android-emulator-run
         with:
-          api-level: ${{ matrix.api-level }}
-          target: ${{ matrix.target }}
-          emulator-options: -no-snapshot-save -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none
-          force-avd-creation: false
-          disable-animations: true
-          arch: x86_64
-          profile: Nexus 6
-          script: |
-            brew install parallel
-            parallel --retries 3 ::: "./gradlew test:connectedCheck"
+          script: "parallel --retries 3 ::: './gradlew test:connectedCheck'"
       - if: failure()
         uses: actions/upload-artifact@v4
         with:
@@ -137,13 +104,9 @@ jobs:
 
   test-minified:
     name: 'Test UI Minified'
-    runs-on: macos-latest
+    needs: [ test-ui ]
+    runs-on: ubuntu-latest
     timeout-minutes: 20
-    strategy:
-      fail-fast: false
-      matrix:
-        api-level: [29]
-        target: [default]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-java@v4
@@ -153,39 +116,10 @@ jobs:
       - uses: gradle/gradle-build-action@v3
         with:
           cache-read-only: false
-      - name: 'Cache AVD'
-        uses: actions/cache@v4
-        id: avd-cache
-        with:
-          path: |
-            ~/.android/avd/*
-            ~/.android/adb*
-          key: avd-api-${{ matrix.api-level }}-target-${{ matrix.target }}
-      - name: 'Create AVD'
-        if: steps.avd-cache.outputs.cache-hit != 'true'
-        uses: reactivecircus/android-emulator-runner@v2.29.0
-        with:
-          api-level: ${{ matrix.api-level }}
-          target: ${{ matrix.target }}
-          emulator-options: -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none
-          force-avd-creation: false
-          disable-animations: false
-          arch: x86_64
-          profile: Nexus 6
-          script: echo "Generated AVD snapshot for caching."
-      - name: 'Tests'
-        uses: reactivecircus/android-emulator-runner@v2.29.0
+      - name: Run tests
+        uses: ./.github/actions/android-emulator-run
         with:
-          api-level: ${{ matrix.api-level }}
-          target: ${{ matrix.target }}
-          emulator-options: -no-snapshot-save -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none
-          force-avd-creation: false
-          disable-animations: true
-          arch: x86_64
-          profile: Nexus 6
-          script: |
-            brew install parallel
-            parallel --retries 3 ::: "./gradlew test:connectedCheck -P testingMinimizedBuild=true -P android.enableR8.fullMode=false"
+          script: "parallel --retries 3 ::: './gradlew test:connectedCheck -P testingMinimizedBuild=true -P android.enableR8.fullMode=false'"
       - if: failure()
         uses: actions/upload-artifact@v4
         with:
@@ -196,13 +130,11 @@ jobs:
 
   test-benchmark:
     name: 'Test Benchmark'
-    runs-on: macos-latest
+    needs: test
+    # ubuntu-latest fails with JNI ERROR (app bug): weak global reference table overflow (max=51200)
+    # macos-latest i.e. macos-14 https://github.com/ReactiveCircus/android-emulator-runner/issues/324
+    runs-on: macos-13
     timeout-minutes: 30
-    strategy:
-      fail-fast: false
-      matrix:
-        api-level: [29]
-        target: [default]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-java@v4
@@ -212,36 +144,18 @@ jobs:
       - uses: gradle/gradle-build-action@v3
         with:
           cache-read-only: false
-      - name: 'Cache AVD'
-        uses: actions/cache@v4
-        id: avd-cache
+      - name: Run tests
+        uses: ./.github/actions/android-emulator-run
         with:
-          path: |
-            ~/.android/avd/*
-            ~/.android/adb*
-          key: avd-api-${{ matrix.api-level }}-target-${{ matrix.target }}
-      - name: 'Create AVD'
-        if: steps.avd-cache.outputs.cache-hit != 'true'
-        uses: reactivecircus/android-emulator-runner@v2.29.0
-        with:
-          api-level: ${{ matrix.api-level }}
-          target: ${{ matrix.target }}
-          emulator-options: -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none
-          force-avd-creation: false
-          disable-animations: false
-          arch: x86_64
-          profile: Nexus 6
-          script: echo "Generated AVD snapshot for caching."
-      - uses: reactivecircus/android-emulator-runner@v2.29.0
-        with:
-          api-level: ${{ matrix.api-level }}
-          target: ${{ matrix.target }}
-          emulator-options: -no-snapshot-save -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none
-          force-avd-creation: false
-          disable-animations: true
-          arch: x86_64
-          profile: Nexus 6
+          api-level: 29
           script: ./gradlew benchmark:connectedReleaseAndroidTest
+      - if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: androidTest-benchmark-results
+          path: |
+            benchmark/build/outputs/androidTest-results
+            benchmark/build/reports/androidTests
       - name: Diff benchmark result
         id: diff-benchmark
         uses: ./.github/actions/android-benchmark-diff

.gitignore

@@ -4,7 +4,7 @@
 /sdk/gradle.properties
 /.idea
 .DS_Store
-/build
+build
 /captures
 .externalNativeBuild
 .cxx

MAINTAINERS.md

@@ -50,9 +50,9 @@ with:
    ```groovy
    dependencies {
       // ...
-      implementation "com.github.hCaptcha:hcaptcha-android-sdk:BRANCH_NAME-SNAPSHOT"
+      implementation "com.github.hCaptcha.hcaptcha-android-sdk:sdk:BRANCH_NAME-SNAPSHOT"
       // or
-      implementation "com.github.hCaptcha:hcaptcha-android-sdk:pull/PR_NUMBER/head-SNAPSHOT"
+      implementation "com.github.hCaptcha.hcaptcha-android-sdk:sdk:pull/PR_NUMBER/head-SNAPSHOT"
    }
    ```
 1. Build `example-app` for `release` variant

README.md

@@ -18,12 +18,28 @@ repositories {
 }
 // Add hCaptcha sdk dependency inside the app's build.gradle file
 dependencies {
-    <b>implementation 'com.github.hcaptcha:hcaptcha-android-sdk:x.y.z'</b>
+    // For Android View
+    <b>implementation 'com.github.hCaptcha.hcaptcha-android-sdk:sdk:x.y.z'</b>
+    // For Jetpack Compose
+    <b>implementation 'com.github.hCaptcha.hcaptcha-android-sdk:compose-sdk:x.y.z'</b>
 }
 </pre>
 
 *Note: replace `x.y.z` with one from [Release](https://github.com/hCaptcha/hcaptcha-android-sdk/releases) (e.g. `1.0.0`).*
 
+### Legacy (versions < 5.0)
+
+<pre>
+// Register JitPack Repository inside the root build.gradle file
+repositories {
+    <b>maven { url 'https://jitpack.io' }</b> 
+}
+// Add hCaptcha sdk dependency inside the app's build.gradle file
+dependencies {
+    <b>implementation 'com.github.hcaptcha:hcaptcha-android-sdk:x.y.z'</b>
+}
+</pre>
+
 ## Requirements
 
 | Platform   | Requirements                                 |

benchmark/src/androidTest/java/com/hcaptcha/sdk/HCaptchaWebViewHelperTest.java

@@ -56,7 +56,6 @@ public void onLoaded() {
                                     latch.countDown();
                                 }
                             },
-                            new TestHCaptchaStateListener(),
                             webView
                     );
                 });

build.gradle

@@ -9,6 +9,7 @@ buildscript {
         classpath 'com.android.tools.build:gradle:8.1.3'
         classpath 'androidx.benchmark:benchmark-gradle-plugin:1.2.0'
         classpath 'com.slack.keeper:keeper:0.15.0'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
     }
 }
 

compose-sdk/.gitignore

@@ -0,0 +1 @@
+/build