build: integrate Kover test coverage tool at jindong-core (#68)

* build: intergrate Kover test coverage tool

* build: generate Kover test coverage report at workflow

* Update .github/workflows/gradle.yml

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Revert "Update .github/workflows/gradle.yml"

This reverts commit 5fa08bd.

* fix: update test coverage target to jindong-core

* fix: configure tests with JUnit platform

* test: include androidHostTest scope to properly target JVM source

* docs: update README

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

Author: wisemuji

.github/workflows/gradle.yml

@@ -15,6 +15,7 @@ on:
 
 permissions:
   contents: read
+  pull-requests: write
 
 jobs:
   check:
@@ -59,3 +60,27 @@ jobs:
       uses: gradle/gradle-build-action@ce999babab2de1c4b649dc15f0ee67e6246c994f
       with:
         arguments: allTests
+    - name: Generate Kover Coverage Report
+      uses: gradle/gradle-build-action@ce999babab2de1c4b649dc15f0ee67e6246c994f
+      with:
+        arguments: :jindong-core:koverXmlReport
+    - name: Generate Kover HTML Report
+      uses: gradle/gradle-build-action@ce999babab2de1c4b649dc15f0ee67e6246c994f
+      with:
+        arguments: :jindong-core:koverHtmlReport
+    - name: Upload Coverage Report
+      uses: actions/upload-artifact@v4
+      with:
+        name: coverage-report
+        path: jindong-core/build/reports/kover/html
+    - name: Add coverage report to PR
+      id: kover
+      if: github.event_name == 'pull_request'
+      uses: mi-kas/kover-report@v1
+      with:
+        path: ${{ github.workspace }}/jindong-core/build/reports/kover/report.xml
+        token: ${{ secrets.GITHUB_TOKEN }}
+        title: Jindong Core Test Coverage Report
+        update-comment: true
+        min-coverage-overall: 0
+        min-coverage-changed-files: 0

build.gradle.kts

@@ -6,6 +6,7 @@ plugins {
     alias(libs.plugins.vanniktech.mavenPublish) apply false
     alias(libs.plugins.spotless) apply false
     alias(libs.plugins.binaryCompatibilityValidator) apply false
+    alias(libs.plugins.kover) apply false
 }
 
 subprojects {

gradle/libs.versions.toml

@@ -16,6 +16,7 @@ robolectric = "4.16"
 androidxTest = "1.7.0"
 androidxActivity = "1.12.2"
 androidxAnnotation = "1.9.1"
+kover = "0.9.4"
 
 [libraries]
 kotlin-test = { module = "org.jetbrains.kotlin:kotlin-test", version.ref = "kotlin" }
@@ -24,6 +25,7 @@ kotlinx-coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-c
 kotlinx-coroutines-test = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-test", version.ref = "coroutines" }
 kotest-framework-engine = { module = "io.kotest:kotest-framework-engine", version.ref = "kotest" }
 kotest-assertions-core = { module = "io.kotest:kotest-assertions-core", version.ref = "kotest" }
+kotest-runner-junit5 = { module = "io.kotest:kotest-runner-junit5", version.ref = "kotest" }
 robolectric = { module = "org.robolectric:robolectric", version.ref = "robolectric" }
 androidx-test-core = { module = "androidx.test:core", version.ref = "androidxTest" }
 androidx-test-runner = { module = "androidx.test:runner", version.ref = "androidxTest" }
@@ -43,3 +45,4 @@ kotest = { id = "io.kotest", version.ref = "kotest" }
 ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }
 android-application = { id = "com.android.application", version.ref = "agp" }
 composeMultiplatform = { id = "org.jetbrains.compose", version.ref = "composeMultiplatform" }
+kover = { id = "org.jetbrains.kotlinx.kover", version.ref = "kover" }

jindong-core/build.gradle.kts

@@ -22,6 +22,7 @@ plugins {
   alias(libs.plugins.kotest)
   alias(libs.plugins.ksp)
   alias(libs.plugins.binaryCompatibilityValidator)
+  alias(libs.plugins.kover)
 }
 
 apiValidation {
@@ -47,6 +48,10 @@ kotlin {
         }
       }
     }
+
+    withHostTest {
+      isIncludeAndroidResources = true
+    }
   }
   iosX64()
   iosArm64()
@@ -65,6 +70,15 @@ kotlin {
       implementation(libs.kotest.framework.engine)
       implementation(libs.kotest.assertions.core)
     }
+
+    named("androidHostTest").dependencies {
+        implementation(libs.robolectric)
+        implementation(libs.androidx.test.core)
+        implementation(libs.androidx.test.runner)
+        implementation(libs.kotest.assertions.core)
+        implementation(libs.kotlinx.coroutines.test)
+        implementation(libs.kotest.runner.junit5)
+      }
   }
 }
 
@@ -103,3 +117,20 @@ mavenPublishing {
     }
   }
 }
+
+tasks.withType<Test>().configureEach {
+  useJUnitPlatform()
+}
+
+kover {
+  reports {
+    total {
+      html {
+        onCheck = true
+      }
+      xml {
+        onCheck = true
+      }
+    }
+  }
+}

jindong-core/src/androidHostTest/README.md

@@ -0,0 +1,36 @@
+# Android Host Tests
+
+Robolectric-based Android tests that run on JVM without requiring an emulator.
+
+## Running Tests
+
+```bash
+# Run Android host tests only
+./gradlew :jindong-core:testAndroidHostTest
+
+# Run all tests (including commonTest, iosTest, etc.)
+./gradlew :jindong-core:allTests
+```
+
+> **Note**: Use `--rerun-tasks` when you need to re-run tests that Gradle considers up-to-date (e.g., after changing test configuration or debugging flaky tests).
+
+## Test Scenarios
+
+To be updated...
+
+| Category | Test | Jindong Mapping |
+|----------|------|-----------------|
+| **OneShot** | High intensity (255) | `HapticIntensity.HIGH` |
+| | Medium intensity (128) | `HapticIntensity.MEDIUM` |
+| | Low intensity (64) | `HapticIntensity.LIGHT` |
+| **Waveform** | Simple sequence | `Sequence { Haptic, Delay, Haptic }` |
+| | Complex sequence | `Repeat { Haptic, Delay }` |
+| **Edge Cases** | Minimum duration (1ms) | - |
+| | Minimum amplitude (1) | - |
+| **Control** | Cancel | `executor.cancel()` |
+
+
+## Configuration
+
+- **SDK**: API 26 (Android 8.0)
+- **Runner**: `RobolectricTestRunner`