anyline-tire-tread-react-native-module 0.6.0

package/LICENSE.md

@@ -0,0 +1,11 @@
+# Copyright © 2026 Anyline GmbH. All rights reserved.
+
+## License
+
+The contents of this repository are the intellectual property of Anyline GmbH.
+
+The use of the SDK and this app is subject to the most recent Master Subscription Terms of Anyline GmbH (or one of its subsidiaries), Terms of Use for the Anyline App and Anyline's Privacy Policies, available under Imprint & Legal of Anyline GmbH & Anyline Inc. | Anyline (or to a "Master Partner Agreement" if you are a partner of Anyline), and is only allowed if you have received a "Trial Access" (as defined in the Master Subscription Terms) or a license according to the Master Subscription Terms (or Master Partner Agreement).
+
+## Contact
+
+For more information about the software development kit and licensing options, please contact Anyline GmbH at [anyline.com](https://anyline.com).

package/README.md

@@ -0,0 +1,157 @@
+# Anyline Tire Tread React Native SDK
+
+[![npm version](https://img.shields.io/npm/v/anyline-tire-tread-react-native-module.svg)](https://www.npmjs.com/package/anyline-tire-tread-react-native-module)
+[![license](https://img.shields.io/npm/l/anyline-tire-tread-react-native-module.svg)](./LICENSE.md)
+
+React Native SDK for Anyline Tire Tread scanning and depth measurement.
+
+## Getting Started
+
+### Requirements
+- Stable internet connection
+- Flash capability
+- Camera functionality (required: 1080p with autofocus)
+
+#### Android
+- Android 6.0+ (Marshmallow) - API level 23+
+
+#### iOS
+- iOS 13+
+
+Reference: [Anyline Tire Tread SDK documentation](https://documentation.anyline.com/tiretreadsdk-component/latest/index.html)
+
+### Installation
+
+```sh
+yarn add anyline-tire-tread-react-native-module
+# or
+npm install anyline-tire-tread-react-native-module
+```
+
+### Android Setup
+
+Add the custom maven repository to your `build.gradle`:
+
+```gradle
+maven { url "https://europe-maven.pkg.dev/anyline-ttr-sdk/maven" }
+```
+
+### iOS Setup
+
+Run `pod install` after installing the package:
+
+```sh
+cd ios && pod install
+```
+
+## Usage
+
+### Importing
+
+```typescript
+import {
+  initialize,
+  scanWithEvents,
+  getResult,
+  getHeatMap,
+  isDeviceSupported,
+  setOrientationLock,
+  OrientationLock,
+} from 'anyline-tire-tread-react-native-module';
+```
+
+### Initialization
+
+```typescript
+try {
+  const response = await initialize('your_license_key');
+  console.log('Initialization successful:', response);
+} catch (error) {
+  console.error('Initialization failed:', error);
+}
+```
+
+### Device Compatibility Check
+
+```typescript
+const supported = await isDeviceSupported();
+if (!supported) {
+  console.warn('Device not supported');
+}
+```
+
+### Scanning
+
+Use `scanWithEvents` to start a scan and receive real-time events:
+
+```typescript
+const config = JSON.stringify(require('./assets/config/sample_config_default.json'));
+
+try {
+  const { measurementUUID, cameraDirection } = await scanWithEvents(
+    config,
+    undefined,
+    (event) => {
+      console.log('Scan event:', event);
+    }
+  );
+  console.log('Scan complete:', measurementUUID, cameraDirection);
+} catch (error) {
+  console.error('Scanning failed:', error);
+}
+```
+
+**Parameters:**
+- `config` (string): JSON configuration for the scanning activity.
+- `tireWidth` (number, optional): Tire width for improved accuracy.
+- `onEvent` (function, optional): Callback for scan events (`scanStarted`, `scanStopped`, `imageUploaded`, `distanceChanged`).
+
+**Returns:** `Promise<ScanResult>` with `measurementUUID` and `cameraDirection`.
+
+### Getting Results
+
+```typescript
+try {
+  const result = await getResult(measurementUUID);
+  console.log('Report:', result);
+} catch (error) {
+  console.error('Getting report failed:', error);
+}
+```
+
+### Getting Heatmap
+
+```typescript
+try {
+  const heatmapUrl = await getHeatMap(measurementUUID);
+  console.log('Heatmap URL:', heatmapUrl);
+} catch (error) {
+  console.error('Getting heatmap failed:', error);
+}
+```
+
+## Configuration
+
+The scanning activity is configured via a JSON object. For complete documentation:
+- [Scan Configuration](https://documentation.anyline.com/tiretreadsdk-component/latest/scan-configuration.html)
+- [Default UI Overview](https://documentation.anyline.com/tiretreadsdk-component/latest/default-ui/overview.html)
+- [Customizing the Default UI](https://documentation.anyline.com/tiretreadsdk-component/latest/default-ui/customizing.html)
+
+## Troubleshooting
+
+### Camera permissions not granted
+Ensure your app requests camera permissions before starting a scan. On Android, add `android.permission.CAMERA` to your `AndroidManifest.xml`. On iOS, add `NSCameraUsageDescription` to your `Info.plist`.
+
+### Scan fails with autofocus error
+The SDK requires a camera with autofocus capability. Devices without autofocus (e.g. some tablets) are not supported. Use `isDeviceSupported()` to check before scanning.
+
+### Network timeout during result retrieval
+The SDK requires a stable internet connection to upload frames and retrieve results. Ensure the device has connectivity and can reach `anyline.com` endpoints.
+
+## Support
+
+For issues or questions, please open a support request using the [Anyline Helpdesk](https://support.anyline.com).
+
+## License
+
+See the [LICENSE.md](./LICENSE.md) file for licensing information.

package/android/build.gradle

@@ -0,0 +1,150 @@
+buildscript {
+  def kotlin_version = rootProject.ext.has("kotlinVersion") ? rootProject.ext.get("kotlinVersion") : project.properties["AnylineTtrMobileWrapperReactNative_kotlinVersion"]
+
+  repositories {
+    google()
+    mavenCentral()
+    maven { url "https://europe-maven.pkg.dev/anyline-ttr-sdk/maven" }
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:7.2.1"
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+  }
+}
+
+plugins {
+    id 'com.android.library'
+    id 'kotlin-android'
+}
+
+allprojects {
+    repositories {
+        google()
+        mavenCentral()
+        maven { url "https://europe-maven.pkg.dev/anyline-ttr-sdk/maven" }
+        addReactNativeMavenRepo(delegate)
+    }
+}
+
+def isNewArchitectureEnabled() {
+  return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
+}
+
+if (isNewArchitectureEnabled()) {
+  apply plugin: "com.facebook.react"
+}
+
+def getExtOrDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties["AnylineTtrMobileWrapperReactNative_" + name]
+}
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["AnylineTtrMobileWrapperReactNative_" + name]).toInteger()
+}
+
+def supportsNamespace() {
+  def parsed = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize('.')
+  def major = parsed[0].toInteger()
+  def minor = parsed[1].toInteger()
+
+  return (major == 7 && minor >= 3) || major >= 8
+}
+
+def resolveReactNativeAndroidDir() {
+  if (rootProject.ext.has("reactNativeAndroidRoot")) {
+    def configuredDir = file(rootProject.ext.get("reactNativeAndroidRoot"))
+    if (configuredDir.exists()) {
+      return configuredDir
+    }
+  }
+
+  def currentDir = projectDir
+  0.upto(5) {
+    if (currentDir == null) {
+      return null
+    }
+
+    def androidDir = new File(currentDir, "node_modules/react-native/android")
+    if (androidDir.exists()) {
+      return androidDir
+    }
+
+    def legacyDir = new File(currentDir, "node_modules/react-native")
+    if (legacyDir.exists()) {
+      return legacyDir
+    }
+
+    currentDir = currentDir.parentFile
+  }
+
+  return null
+}
+
+def addReactNativeMavenRepo(RepositoryHandler repositories) {
+  def reactNativeDir = resolveReactNativeAndroidDir()
+  if (reactNativeDir != null && reactNativeDir.exists()) {
+    repositories.maven {
+      url reactNativeDir.toString()
+      name "React Native sources"
+    }
+  } else {
+    logger.warn(":${project.name}: unable to locate React Native android sources; falling back to remote repositories")
+  }
+}
+
+android {
+  if (supportsNamespace()) {
+    namespace "com.anyline.ttr.reactnative"
+
+    sourceSets {
+      main {
+        manifest.srcFile "src/main/AndroidManifestNew.xml"
+      }
+    }
+  }
+
+  packagingOptions {
+    exclude 'META-INF/LICENSE.md'
+  }
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-native:+"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
+
+  implementation "io.anyline.tiretread.sdk:shared:14.0.1"
+
+  implementation 'androidx.core:core-ktx:1.13.0'
+  implementation 'androidx.compose.ui:ui:1.6.6'
+  implementation 'androidx.compose.material:material:1.6.6'
+  implementation 'androidx.compose.ui:ui-tooling-preview:1.6.6'
+  implementation 'androidx.activity:activity-compose:1.9.0'
+  implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.8.0"
+  implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.3"
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+AnylineTtrMobileWrapperReactNative_kotlinVersion=1.9.24
+AnylineTtrMobileWrapperReactNative_minSdkVersion=23
+AnylineTtrMobileWrapperReactNative_targetSdkVersion=33
+AnylineTtrMobileWrapperReactNative_compileSdkVersion=33
+AnylineTtrMobileWrapperReactNative_ndkversion=21.4.7075529

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,22 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.anyline.ttr.reactnative">
+
+  <uses-feature
+    android:name="android.hardware.camera"
+    android:required="true" />
+  <uses-feature
+    android:name="android.hardware.camera.autofocus"
+    android:required="true" />
+  <uses-feature
+    android:name="android.hardware.camera.flash"
+    android:required="false" />
+
+  <uses-permission android:name="android.permission.CAMERA" />
+  <uses-permission android:name="android.permission.INTERNET" />
+  <uses-permission android:name="android.permission.VIBRATE" />
+
+  <application>
+    <activity android:name="com.anyline.ttr.reactnative.TTRReactNativeScanActivity" android:theme="@style/AppTheme.FullScreen"/>
+  </application>
+
+</manifest>

package/android/src/main/AndroidManifestNew.xml

@@ -0,0 +1,20 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+  <uses-feature
+    android:name="android.hardware.camera"
+    android:required="true" />
+  <uses-feature
+    android:name="android.hardware.camera.autofocus"
+    android:required="true" />
+  <uses-feature
+    android:name="android.hardware.camera.flash"
+    android:required="false" />
+
+  <uses-permission android:name="android.permission.CAMERA" />
+  <uses-permission android:name="android.permission.INTERNET" />
+  <uses-permission android:name="android.permission.VIBRATE" />
+
+  <application>
+    <activity android:name="com.anyline.ttr.reactnative.TTRReactNativeScanActivity" android:theme="@style/AppTheme.FullScreen"/>
+  </application>
+</manifest>

package/android/src/main/java/com/anyline/ttr/reactnative/CameraDirectionHelper.kt

@@ -0,0 +1,32 @@
+package com.anyline.ttr.reactnative
+
+import android.app.Activity
+import android.content.Context
+import android.os.Build
+import android.view.Surface
+
+object CameraDirectionHelper {
+
+    enum class CameraDirection {
+        LEFT, RIGHT, UNKNOWN
+    }
+
+    /**
+     * Get current camera direction based on device orientation
+     * Returns: LEFT when camera points left, RIGHT when camera points right
+     */
+    fun getCameraDirection(context: Context): CameraDirection {
+        val rotation = if (Build.VERSION.SDK_INT >= 30) {
+            context.display?.rotation
+        } else {
+            @Suppress("DEPRECATION")
+            (context as? Activity)?.windowManager?.defaultDisplay?.rotation
+        } ?: return CameraDirection.UNKNOWN
+
+        return when (rotation) {
+            Surface.ROTATION_90 -> CameraDirection.LEFT    // Camera points left
+            Surface.ROTATION_270 -> CameraDirection.RIGHT  // Camera points right
+            else -> CameraDirection.UNKNOWN                // Portrait or unknown
+        }
+    }
+}

package/android/src/main/java/com/anyline/ttr/reactnative/TTRReactNativeCallbackManager.kt

@@ -0,0 +1,30 @@
+package com.anyline.ttr.reactnative
+
+interface TTRReactNativeResultCallback {
+  fun onResultSuccess(uuid: String, cameraDirection: String?)
+  fun onResultError(errorCode: String, errorMessage: String)
+}
+
+object TTRReactNativeCallbackManager {
+  private var callback: TTRReactNativeResultCallback? = null
+  private var lastCameraDirection: String? = null
+
+  fun registerCallback(cb: TTRReactNativeResultCallback) {
+    callback = cb
+  }
+
+  fun unregisterCallback(cb: TTRReactNativeResultCallback) {
+    if (callback == cb) {
+      callback = null
+      lastCameraDirection = null
+    }
+  }
+
+  fun getCallback(): TTRReactNativeResultCallback? = callback
+
+  fun setCameraDirection(direction: String) {
+    lastCameraDirection = direction
+  }
+
+  fun getCameraDirection(): String? = lastCameraDirection
+}

package/android/src/main/java/com/anyline/ttr/reactnative/TTRReactNativeCustomComposeContainer.kt

@@ -0,0 +1,69 @@
+package com.anyline.ttr.reactnative
+
+import android.content.Context
+import android.widget.FrameLayout
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.platform.ComposeView
+import androidx.compose.ui.viewinterop.AndroidView
+import androidx.lifecycle.LifecycleOwner
+import androidx.lifecycle.ViewModelStore
+import androidx.lifecycle.ViewModelStoreOwner
+import androidx.lifecycle.setViewTreeLifecycleOwner
+import androidx.lifecycle.setViewTreeViewModelStoreOwner
+import androidx.savedstate.SavedStateRegistryOwner
+import androidx.savedstate.setViewTreeSavedStateRegistryOwner
+import io.anyline.tiretread.sdk.scanner.TireTreadScanView
+
+class TTRReactNativeCustomComposeContainer(context: Context) : FrameLayout(context) {
+  private val composeView = ComposeView(context).apply {
+    layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)
+  }
+
+  init {
+    addView(composeView)
+
+    // Ensure this container is associated with the necessary lifecycle owners
+    (context as? LifecycleOwner)?.let { owner ->
+      this.setViewTreeLifecycleOwner(owner)
+      this.setViewTreeViewModelStoreOwner(object : ViewModelStoreOwner {
+        override val viewModelStore: ViewModelStore
+          get() = ViewModelStore()
+      })
+      this.setViewTreeSavedStateRegistryOwner(owner as? SavedStateRegistryOwner)
+    }
+
+    // Set the content of your Compose view to include the TireTreadScanView
+    composeView.setContent {
+      AndroidView(
+        modifier = Modifier.fillMaxSize(),
+        factory = { ctx ->
+          // Creating an instance of TireTreadScanView
+          TireTreadScanView(ctx).apply {
+            // Initialize your view with necessary parameters
+          }
+        },
+        update = { view ->
+          // Update the view properties if needed when Compose recomposes
+        }
+      )
+    }
+  }
+}
+
+@Composable
+fun TireTreadScanViewComposeAdapter(context: Context) {
+  // Assuming TireTreadScanView can be used directly as a composable.
+  // If not, additional integration may be required.
+  AndroidView(
+    factory = { ctx ->
+      TireTreadScanView(ctx).apply {
+        // configure your view if needed
+      }
+    },
+    update = { view ->
+      // Update the view during recompositions if necessary
+    }
+  )
+}