@unif/react-native-hms-scan 0.1.0 → 0.2.0

package/README.md

@@ -1,11 +1,14 @@
 # @unif/react-native-hms-scan
 
-华为 **HMS 统一扫码服务**（HUAWEI Scan Kit）的 React Native 封装，新架构（TurboModule + Fabric）。聚焦两件事：
+[![npm](https://img.shields.io/npm/v/@unif/react-native-hms-scan.svg?color=cb3837&logo=npm)](https://www.npmjs.com/package/@unif/react-native-hms-scan)
+[![CI](https://github.com/unif-design/react-native-hms-scan/actions/workflows/ci.yml/badge.svg)](https://github.com/unif-design/react-native-hms-scan/actions/workflows/ci.yml)
+[![License](https://img.shields.io/npm/l/@unif/react-native-hms-scan.svg?color=blue)](https://github.com/unif-design/react-native-hms-scan/blob/main/LICENSE)
+[![Docs](https://img.shields.io/badge/docs-unif--design.github.io-orange.svg)](https://unif-design.github.io/react-native-hms-scan/)
 
-- **定制视图扫码** —— 底层 headless `<HmsScanView>` 相机组件，外加按设计稿做好的成品 `<Scanner>` 扫一扫页（聚焦款，浅色）。
-- **图片识别** —— `decodeImage(uri)` 从本地图片解码条码 / 二维码。
+华为 **HMS 统一扫码**（HUAWEI Scan Kit）的 React Native 封装（新架构）：定制视图扫码（成品页 `<Scanner>` / headless `<HmsScanView>`）+ 图片识别（`decodeImage`）。Android 用 Scan SDK-Plus（内置引擎，**不依赖 HMS Core APK**，非华为机型可用），iOS 用 ScanKitFrameWork；两端均无需 AppGallery Connect / API Key。
 
-> Android 用 **Scan SDK-Plus**（内置引擎，**不依赖设备安装 HMS Core APK**，非华为机型可用）；iOS 用 CocoaPods 的 **ScanKitFrameWork**。两端**都不需要 AppGallery Connect / agconnect 配置 / API Key**。
+> 📖 **完整文档**（安装 · 平台配置 · API · 平台差异 · 故障排查）：
+> **https://unif-design.github.io/react-native-hms-scan/**
 
 ## 安装
 
@@ -14,44 +17,10 @@ yarn add @unif/react-native-hms-scan react-native-svg
 cd ios && pod install
 ```
 
-`react-native-svg` 是 peer 依赖（`<Scanner>` 的图标用它绘制）。本库为 New Architecture 库，宿主需开启新架构。
-
-### Android
-
-库的 gradle 已自带华为 maven 仓库与 `com.huawei.hms:scanplus` 依赖，**无需改宿主 gradle**。只需在宿主 `AndroidManifest.xml` 声明权限：
-
-```xml
-<uses-permission android:name="android.permission.CAMERA" />
-<uses-feature android:name="android.hardware.camera" android:required="false" />
-<!-- 仅当用 decodeImage 解相册图时需要 -->
-<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />          <!-- API 33+ -->
-<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
-    android:maxSdkVersion="32" />
-```
-
-- minSdkVersion ≥ 24。
-- **不需要** `agconnect-services.json` / agconnect 插件 / API Key。
-
-### iOS
-
-`pod install` 会自动拉取 `ScanKitFrameWork`。在宿主 `Info.plist` 加：
-
-```xml
-<key>NSCameraUsageDescription</key>
-<string>用于扫描商品条码与门店二维码</string>
-<!-- 仅当用 decodeImage 解相册图时需要 -->
-<key>NSPhotoLibraryUsageDescription</key>
-<string>用于从相册选取图片识别条码</string>
-```
-
-- 最低 iOS 版本随宿主 RN 工程。
-- `ScanKitFrameWork` 是 **arm64-only 静态库**：podspec 已对 Apple 芯片模拟器排掉 arm64（模拟器走 x86_64），**真机 arm64 不受影响**；建议在真机调试扫码。
-- **不需要** AppGallery Connect / API Key。
+本库为新架构（TurboModule + Fabric）库，宿主需开启新架构。Android 权限、iOS `ScanKitFrameWork`（arm64-only 静态库，模拟器排除 / 建议真机）等见[文档站 · 安装](https://unif-design.github.io/react-native-hms-scan/docs/getting-started/installation)。
 
 ## 用法
 
-### 1) 成品扫一扫页 `<Scanner>`（推荐）
-
 ```tsx
 import { Scanner, type ScanResult, type ScanProduct } from '@unif/react-native-hms-scan';
 
@@ -60,89 +29,19 @@ function ScanScreen({ navigation }) {
     <Scanner
       title="扫一扫"
       onClose={() => navigation.goBack()}
-      // 扫到条码后解析商品（你的业务：查接口/本地库）。返回 null = 未识别。
       resolveProduct={async (r: ScanResult): Promise<ScanProduct | null> => {
         const p = await api.lookupByBarcode(r.value);
-        return p && {
-          name: p.name, brand: p.brand, price: `¥${p.price}`,
-          spec: p.spec, stockShort: p.stockText, barcode: r.value,
-        };
-      }}
-      // 点"确认"：把结果带回上一级
-      onConfirm={(product, result) => {
-        navigation.navigate('Order', { barcode: result.value, product });
-      }}
-      // 点"相册"：用你自己的图片选择器返回本地 uri
-      pickImage={async () => {
-        const res = await launchImageLibrary({ mediaType: 'photo' });
-        return res.assets?.[0]?.uri ?? null;
+        return p
+          ? { name: p.name, brand: p.brand, price: `¥${p.price}`, barcode: r.value }
+          : null;
       }}
+      onConfirm={(product, result) => navigation.navigate('Order', { product })}
     />
   );
 }
 ```
 
-`<Scanner>` 内部状态：取景 → 识别中 → 识别成功（浮层确认卡）/ 未识别（重试弹层）/ 无权限（去设置）。单次扫一个，确认后带回上一级。手电筒 / 相册在底部工具栏。
-
-> 安全区：默认 `topInset=54 / bottomInset=34`。若用 `react-native-safe-area-context`，把 `insets.top/bottom` 传进来更精准。
-
-### 2) 底层 headless 组件 `<HmsScanView>`
-
-完全自定义 UI 时，只用相机预览 + 结果事件，自己画取景框：
-
-```tsx
-import { HmsScanView, type ScanResult } from '@unif/react-native-hms-scan';
-
-<HmsScanView
-  style={{ flex: 1 }}
-  formats={['QR_CODE', 'EAN_13']}   // 不传 = 全部码制
-  torch={torchOn}                   // Android 可控；iOS 为尽力而为
-  paused={paused}                   // 命中后想停在结果时置 true
-  onScanResult={(results: ScanResult[]) => {
-    const code = results[0]?.value;
-  }}
-  onScanError={(e) => console.warn(e.code, e.message)}
-/>
-```
-
-### 3) 图片识别 `decodeImage`
-
-```tsx
-import { decodeImage } from '@unif/react-native-hms-scan';
-
-const results = await decodeImage('file:///path/photo.jpg', { formats: ['QR_CODE'] });
-// results: ScanResult[]（可能为空）。只吃本地 uri，远程图请先下载。
-```
-
-### 4) 相机权限
-
-```tsx
-import { getCameraPermissionStatus, requestCameraPermission } from '@unif/react-native-hms-scan';
-const status = await requestCameraPermission(); // 'granted' | 'denied' | 'blocked' | 'undetermined'
-```
-
-## 平台差异（务必知悉）
-
-| 能力 | Android (`RemoteView`) | iOS (`HmsCustomScanViewController`) |
-| --- | --- | --- |
-| 手电筒 `torch` | ✅ 可编程控制 | ⚠️ HMS 无公开手电 API；本库走 `AVCaptureDevice` **尽力而为**，不保证 |
-| 变焦 | ❌ 仅内部自动 | ❌ 仅内部自动 |
-| 暗光提示 `onTorchStatus.available` | ✅ 上报 | ❌ 不上报 |
-
-## 测试（Jest）
-
-消费者在测试里可用内置 mock 替换本库（避免加载原生）：
-
-```ts
-jest.mock('@unif/react-native-hms-scan', () =>
-  require('@unif/react-native-hms-scan/mock')
-);
-// decodeImage / 权限方法是 jest.fn；<HmsScanView>/<Scanner> 渲染为 null。
-```
-
-## 类型一览
-
-`BarcodeFormat`（QR_CODE / EAN_13 / … / UNKNOWN）、`BarcodeContentType`、`ScanResult { value, format, contentType?, cornerPoints? }`、`ScanProduct`、`CameraPermissionStatus`、`HmsScanError`。
+headless `<HmsScanView>`、图片识别 `decodeImage`、权限、平台差异 —— 见[文档站](https://unif-design.github.io/react-native-hms-scan/)。
 
 ## 许可
 

package/ReactNativeHmsScan.podspec

@@ -16,14 +16,22 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
   s.private_header_files = "ios/**/*.h"
 
+  # hms-scan 自己用 AVFoundation(摄像头权限 + torch);UIKit / Foundation 显式声明保险。
+  # 之前 podspec 缺这个 —— 被 EXCLUDED_ARCHS 排掉模拟器 arm64 编译掩盖了;现在去掉
+  # EXCLUDED_ARCHS(xcframework 已补 arm64-sim 切片)、arm64 模拟器真编译就暴露了缺链接。
+  s.frameworks = "AVFoundation", "UIKit", "Foundation"
+
   # 华为 HUAWEI Scan Kit（iOS 自包含，无需 AppGallery Connect / API Key）。
   # 提供 HmsCustomScanViewController（定制视图）与 HmsBitMap（图片识别）。
-  s.dependency "ScanKitFrameWork", "~> 1.1.2"
-
-  # ScanKitFrameWork 是 arm64-only 的静态 framework，不含模拟器 arm64 切片。
-  # 在 Apple 芯片上排掉模拟器 arm64（模拟器走 x86_64 / Rosetta），真机 arm64 不受影响。
-  s.pod_target_xcconfig  = { "EXCLUDED_ARCHS[sdk=iphonesimulator*]" => "arm64" }
-  s.user_target_xcconfig = { "EXCLUDED_ARCHS[sdk=iphonesimulator*]" => "arm64" }
+  #
+  # 华为官方 ScanKitFrameWork 1.1.2 是老式 fat framework（arm64 真机 + x86_64 Intel 模拟器），
+  # 不含 arm64-simulator 切片 → Apple Silicon 模拟器会链接失败（旧版只能 EXCLUDED_ARCHS 排掉、
+  # 导致模拟器 / CI 编不过）。这里改为:prepare_command 用 Apple 官方 vtool 把真机 arm64
+  # 改写成 simulator 平台、补出 arm64-sim，打成 xcframework（device 片 / simulator 片分目录）。
+  # 详见 scripts/prepare-scankit-xcframework.sh。产物 ios/vendor/ 不入 git，pod install 时按需生成。
+  s.prepare_command     = "bash scripts/prepare-scankit-xcframework.sh"
+  s.vendored_frameworks = "ios/vendor/ScanKitFrameWork.xcframework"
+  s.resources           = "ios/vendor/ScanKitFrameWorkBundle.bundle"
 
   # 接入 New Architecture（Fabric 组件 + TurboModule）的 codegen 依赖。
   install_modules_dependencies(s)

package/android/src/main/java/com/unif/reactnativehmsscan/HmsScanModule.kt

@@ -23,9 +23,9 @@ import java.io.InputStream
  *   - decodeImage(): decode a local image into a ScanResult[] JSON string.
  *   - getCameraPermissionStatus() / requestCameraPermission(): camera permission.
  */
-class HmsScanModule(reactContext: ReactApplicationContext) :
-  NativeHmsScanSpec(reactContext) {
-
+class HmsScanModule(
+  reactContext: ReactApplicationContext,
+) : NativeHmsScanSpec(reactContext) {
   override fun getName(): String = NAME
 
   // ── decodeImage ──────────────────────────────────────────────────────────
@@ -36,7 +36,11 @@ class HmsScanModule(reactContext: ReactApplicationContext) :
    * (photo mode), and resolves the ScanResult[] JSON. Never rejects on "no code
    * found" — it resolves an empty array, matching the JS contract.
    */
-  override fun decodeImage(uri: String, formatsCsv: String, promise: Promise) {
+  override fun decodeImage(
+    uri: String,
+    formatsCsv: String,
+    promise: Promise,
+  ) {
     val bitmap = loadBitmap(uri)
     if (bitmap == null) {
       promise.reject(E_IMAGE_LOAD_FAILED, "Failed to load image from uri: $uri")
@@ -67,8 +71,8 @@ class HmsScanModule(reactContext: ReactApplicationContext) :
   }
 
   /** Resolve a uri/path to a decoded [Bitmap], or null on any failure. */
-  private fun loadBitmap(uri: String): Bitmap? {
-    return try {
+  private fun loadBitmap(uri: String): Bitmap? =
+    try {
       val parsed = Uri.parse(uri)
       val scheme = parsed.scheme?.lowercase()
       when (scheme) {
@@ -82,11 +86,13 @@ class HmsScanModule(reactContext: ReactApplicationContext) :
             stream?.close()
           }
         }
+
         null -> {
           // No scheme -> treat as an absolute filesystem path.
           val path = parsed.path ?: uri
           decodeFile(path)
         }
+
         else -> {
           // Unsupported scheme (e.g. http/https): JS contract forbids remote URLs.
           null
@@ -95,7 +101,6 @@ class HmsScanModule(reactContext: ReactApplicationContext) :
     } catch (e: Throwable) {
       null
     }
-  }
 
   private fun decodeFile(path: String): Bitmap? {
     val file = File(path)
@@ -137,43 +142,48 @@ class HmsScanModule(reactContext: ReactApplicationContext) :
       // current (not-granted) state rather than hanging the promise.
       promise.reject(
         E_NO_ACTIVITY,
-        "Cannot request camera permission: no current PermissionAwareActivity"
+        "Cannot request camera permission: no current PermissionAwareActivity",
       )
       return
     }
 
     val permissionAwareActivity = activity as PermissionAwareActivity
-    val listener = PermissionListener { requestCode, _, grantResults ->
-      if (requestCode != CAMERA_PERMISSION_REQUEST_CODE) {
-        return@PermissionListener false
-      }
-      val granted = grantResults.isNotEmpty() &&
-        grantResults[0] == PackageManager.PERMISSION_GRANTED
-      val status = when {
-        granted -> GRANTED
-        // After a denial: rationale==true means the user can be asked again;
-        // rationale==false means "don't ask again" (blocked).
-        ActivityCompat.shouldShowRequestPermissionRationale(
-          activity,
-          Manifest.permission.CAMERA
-        ) -> DENIED
-        else -> BLOCKED
+    val listener =
+      PermissionListener { requestCode, _, grantResults ->
+        if (requestCode != CAMERA_PERMISSION_REQUEST_CODE) {
+          return@PermissionListener false
+        }
+        val granted =
+          grantResults.isNotEmpty() &&
+            grantResults[0] == PackageManager.PERMISSION_GRANTED
+        val status =
+          when {
+            granted -> GRANTED
+
+            // After a denial: rationale==true means the user can be asked again;
+            // rationale==false means "don't ask again" (blocked).
+            ActivityCompat.shouldShowRequestPermissionRationale(
+              activity,
+              Manifest.permission.CAMERA,
+            ) -> DENIED
+
+            else -> BLOCKED
+          }
+        promise.resolve(status)
+        true
       }
-      promise.resolve(status)
-      true
-    }
 
     permissionAwareActivity.requestPermissions(
       arrayOf(Manifest.permission.CAMERA),
       CAMERA_PERMISSION_REQUEST_CODE,
-      listener
+      listener,
     )
   }
 
   private fun hasCameraPermission(): Boolean =
     ContextCompat.checkSelfPermission(
       reactApplicationContext,
-      Manifest.permission.CAMERA
+      Manifest.permission.CAMERA,
     ) == PackageManager.PERMISSION_GRANTED
 
   companion object {

package/android/src/main/java/com/unif/reactnativehmsscan/HmsScanResultMapper.kt

@@ -16,7 +16,6 @@ import org.json.JSONObject
  * ```
  */
 internal object HmsScanResultMapper {
-
   /**
    * Serialize an array of [HmsScan] into the ScanResult[] JSON string. The element
    * type is nullable because the HMS APIs (decodeWithBitmap / OnResultCallback)
@@ -37,7 +36,10 @@ internal object HmsScanResultMapper {
     return array.toString()
   }
 
-  private fun toJsonObject(scan: HmsScan, value: String): JSONObject {
+  private fun toJsonObject(
+    scan: HmsScan,
+    value: String,
+  ): JSONObject {
     val obj = JSONObject()
     obj.put("value", value)
     obj.put("format", mapScanType(scan.getScanType()))
@@ -53,7 +55,7 @@ internal object HmsScanResultMapper {
           JSONObject().apply {
             put("x", point.x)
             put("y", point.y)
-          }
+          },
         )
       }
       if (points.length() > 0) {
@@ -65,23 +67,24 @@ internal object HmsScanResultMapper {
   }
 
   /** HmsScan.getScanType() (barcode symbology) -> unified BarcodeFormat string. */
-  fun mapScanType(scanType: Int): String = when (scanType) {
-    HmsScan.QRCODE_SCAN_TYPE -> "QR_CODE"
-    HmsScan.AZTEC_SCAN_TYPE -> "AZTEC"
-    HmsScan.DATAMATRIX_SCAN_TYPE -> "DATA_MATRIX"
-    HmsScan.PDF417_SCAN_TYPE -> "PDF417"
-    HmsScan.CODABAR_SCAN_TYPE -> "CODABAR"
-    HmsScan.CODE39_SCAN_TYPE -> "CODE_39"
-    HmsScan.CODE93_SCAN_TYPE -> "CODE_93"
-    HmsScan.CODE128_SCAN_TYPE -> "CODE_128"
-    HmsScan.EAN8_SCAN_TYPE -> "EAN_8"
-    HmsScan.EAN13_SCAN_TYPE -> "EAN_13"
-    HmsScan.UPCCODE_A_SCAN_TYPE -> "UPC_A"
-    HmsScan.UPCCODE_E_SCAN_TYPE -> "UPC_E"
-    HmsScan.ITF14_SCAN_TYPE -> "ITF14"
-    HmsScan.MULTI_FUNCTIONAL_SCAN_TYPE -> "MULTI_FUNCTIONAL"
-    else -> "UNKNOWN"
-  }
+  fun mapScanType(scanType: Int): String =
+    when (scanType) {
+      HmsScan.QRCODE_SCAN_TYPE -> "QR_CODE"
+      HmsScan.AZTEC_SCAN_TYPE -> "AZTEC"
+      HmsScan.DATAMATRIX_SCAN_TYPE -> "DATA_MATRIX"
+      HmsScan.PDF417_SCAN_TYPE -> "PDF417"
+      HmsScan.CODABAR_SCAN_TYPE -> "CODABAR"
+      HmsScan.CODE39_SCAN_TYPE -> "CODE_39"
+      HmsScan.CODE93_SCAN_TYPE -> "CODE_93"
+      HmsScan.CODE128_SCAN_TYPE -> "CODE_128"
+      HmsScan.EAN8_SCAN_TYPE -> "EAN_8"
+      HmsScan.EAN13_SCAN_TYPE -> "EAN_13"
+      HmsScan.UPCCODE_A_SCAN_TYPE -> "UPC_A"
+      HmsScan.UPCCODE_E_SCAN_TYPE -> "UPC_E"
+      HmsScan.ITF14_SCAN_TYPE -> "ITF14"
+      HmsScan.MULTI_FUNCTIONAL_SCAN_TYPE -> "MULTI_FUNCTIONAL"
+      else -> "UNKNOWN"
+    }
 
   /**
    * Resolve a comma-separated formats CSV into the int varargs for
@@ -92,33 +95,35 @@ internal object HmsScanResultMapper {
    */
   fun parseFormatsCsv(formatsCsv: String?): IntArray? {
     if (formatsCsv.isNullOrBlank()) return null
-    val types = formatsCsv
-      .split(",")
-      .map { it.trim() }
-      .filter { it.isNotEmpty() }
-      .mapNotNull { mapFormatString(it) }
-      .distinct()
+    val types =
+      formatsCsv
+        .split(",")
+        .map { it.trim() }
+        .filter { it.isNotEmpty() }
+        .mapNotNull { mapFormatString(it) }
+        .distinct()
     return if (types.isEmpty()) null else types.toIntArray()
   }
 
   /** Unified BarcodeFormat string -> HmsScan.*_SCAN_TYPE (null when unknown). */
-  private fun mapFormatString(format: String): Int? = when (format) {
-    "QR_CODE" -> HmsScan.QRCODE_SCAN_TYPE
-    "AZTEC" -> HmsScan.AZTEC_SCAN_TYPE
-    "DATA_MATRIX" -> HmsScan.DATAMATRIX_SCAN_TYPE
-    "PDF417" -> HmsScan.PDF417_SCAN_TYPE
-    "CODABAR" -> HmsScan.CODABAR_SCAN_TYPE
-    "CODE_39" -> HmsScan.CODE39_SCAN_TYPE
-    "CODE_93" -> HmsScan.CODE93_SCAN_TYPE
-    "CODE_128" -> HmsScan.CODE128_SCAN_TYPE
-    "EAN_8" -> HmsScan.EAN8_SCAN_TYPE
-    "EAN_13" -> HmsScan.EAN13_SCAN_TYPE
-    "UPC_A" -> HmsScan.UPCCODE_A_SCAN_TYPE
-    "UPC_E" -> HmsScan.UPCCODE_E_SCAN_TYPE
-    "ITF14" -> HmsScan.ITF14_SCAN_TYPE
-    "MULTI_FUNCTIONAL" -> HmsScan.MULTI_FUNCTIONAL_SCAN_TYPE
-    else -> null
-  }
+  private fun mapFormatString(format: String): Int? =
+    when (format) {
+      "QR_CODE" -> HmsScan.QRCODE_SCAN_TYPE
+      "AZTEC" -> HmsScan.AZTEC_SCAN_TYPE
+      "DATA_MATRIX" -> HmsScan.DATAMATRIX_SCAN_TYPE
+      "PDF417" -> HmsScan.PDF417_SCAN_TYPE
+      "CODABAR" -> HmsScan.CODABAR_SCAN_TYPE
+      "CODE_39" -> HmsScan.CODE39_SCAN_TYPE
+      "CODE_93" -> HmsScan.CODE93_SCAN_TYPE
+      "CODE_128" -> HmsScan.CODE128_SCAN_TYPE
+      "EAN_8" -> HmsScan.EAN8_SCAN_TYPE
+      "EAN_13" -> HmsScan.EAN13_SCAN_TYPE
+      "UPC_A" -> HmsScan.UPCCODE_A_SCAN_TYPE
+      "UPC_E" -> HmsScan.UPCCODE_E_SCAN_TYPE
+      "ITF14" -> HmsScan.ITF14_SCAN_TYPE
+      "MULTI_FUNCTIONAL" -> HmsScan.MULTI_FUNCTIONAL_SCAN_TYPE
+      else -> null
+    }
 
   /**
    * HmsScan.getScanTypeForm() (content semantic) -> unified BarcodeContentType
@@ -127,19 +132,20 @@ internal object HmsScanResultMapper {
    * Uses the named HmsScan.*_FORM constants (public static final ints) rather than
    * hard-coded numbers so the mapping stays correct across SDK versions.
    */
-  private fun mapContentType(form: Int): String = when (form) {
-    HmsScan.URL_FORM -> "URL"
-    HmsScan.EMAIL_CONTENT_FORM -> "EMAIL"
-    HmsScan.TEL_PHONE_NUMBER_FORM -> "PHONE"
-    HmsScan.SMS_FORM -> "SMS"
-    HmsScan.WIFI_CONNECT_INFO_FORM -> "WIFI"
-    HmsScan.CONTACT_DETAIL_FORM -> "CONTACT"
-    HmsScan.EVENT_INFO_FORM -> "EVENT"
-    HmsScan.LOCATION_COORDINATE_FORM -> "LOCATION"
-    HmsScan.DRIVER_INFO_FORM -> "DRIVER"
-    HmsScan.ISBN_NUMBER_FORM -> "ISBN"
-    HmsScan.ARTICLE_NUMBER_FORM -> "ARTICLE"
-    HmsScan.PURE_TEXT_FORM -> "TEXT"
-    else -> "OTHER"
-  }
+  private fun mapContentType(form: Int): String =
+    when (form) {
+      HmsScan.URL_FORM -> "URL"
+      HmsScan.EMAIL_CONTENT_FORM -> "EMAIL"
+      HmsScan.TEL_PHONE_NUMBER_FORM -> "PHONE"
+      HmsScan.SMS_FORM -> "SMS"
+      HmsScan.WIFI_CONNECT_INFO_FORM -> "WIFI"
+      HmsScan.CONTACT_DETAIL_FORM -> "CONTACT"
+      HmsScan.EVENT_INFO_FORM -> "EVENT"
+      HmsScan.LOCATION_COORDINATE_FORM -> "LOCATION"
+      HmsScan.DRIVER_INFO_FORM -> "DRIVER"
+      HmsScan.ISBN_NUMBER_FORM -> "ISBN"
+      HmsScan.ARTICLE_NUMBER_FORM -> "ARTICLE"
+      HmsScan.PURE_TEXT_FORM -> "TEXT"
+      else -> "OTHER"
+    }
 }

package/android/src/main/java/com/unif/reactnativehmsscan/HmsScanView.kt

@@ -26,9 +26,10 @@ import com.huawei.hms.ml.scan.HmsScan
  * forwarded both from the View attach/detach callbacks and from the host
  * Activity's lifecycle via [LifecycleEventListener].
  */
-class HmsScanView(context: Context) :
-  FrameLayout(context), LifecycleEventListener {
-
+class HmsScanView(
+  context: Context,
+) : FrameLayout(context),
+  LifecycleEventListener {
   private val themedReactContext: ThemedReactContext = context as ThemedReactContext
 
   private var remoteView: RemoteView? = null
@@ -117,15 +118,17 @@ class HmsScanView(context: Context) :
     if (activity == null) {
       emitError(
         "E_CAMERA_INIT",
-        "Cannot start camera: no host Activity available for RemoteView"
+        "Cannot start camera: no host Activity available for RemoteView",
       )
       return
     }
 
     try {
-      val builder = RemoteView.Builder()
-        .setContext(activity)
-        .setContinuouslyScan(continuous)
+      val builder =
+        RemoteView
+          .Builder()
+          .setContext(activity)
+          .setContinuouslyScan(continuous)
 
       val types = HmsScanResultMapper.parseFormatsCsv(formatsCsv)
       if (types != null && types.isNotEmpty()) {
@@ -140,14 +143,14 @@ class HmsScanView(context: Context) :
 
       view.setOnResultCallback(OnResultCallback { result -> onScanResult(result) })
       view.setOnLightVisibleCallback(
-        OnLightVisibleCallBack { visible -> onTorchVisible(visible) }
+        OnLightVisibleCallBack { visible -> onTorchVisible(visible) },
       )
 
       // onCreate must run after build() and before addView (per HMS docs/demo).
       view.onCreate(Bundle())
       addView(
         view,
-        LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)
+        LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT),
       )
 
       remoteView = view
@@ -220,38 +223,63 @@ class HmsScanView(context: Context) :
     val json = HmsScanResultMapper.toJson(result)
     // toJson skips value-less hits; avoid emitting an empty "[]" event.
     if (json == "[]") return
-    emitEvent("topScanResult", Arguments.createMap().apply {
-      putString("resultsJson", json)
-    })
+    emitEvent(
+      "topScanResult",
+      Arguments.createMap().apply {
+        putString("resultsJson", json)
+      },
+    )
   }
 
   private fun onTorchVisible(visible: Boolean) {
     // Keep our cached torch flag in sync with the actual hardware state.
     val on = remoteView?.lightStatus ?: torch
     torch = on
-    emitEvent("topTorchStatus", Arguments.createMap().apply {
-      putBoolean("available", visible)
-      putBoolean("on", on)
-    })
+    emitEvent(
+      "topTorchStatus",
+      Arguments.createMap().apply {
+        putBoolean("available", visible)
+        putBoolean("on", on)
+      },
+    )
   }
 
-  private fun emitError(code: String, message: String) {
-    emitEvent("topScanError", Arguments.createMap().apply {
-      putString("code", code)
-      putString("message", message)
-    })
+  private fun emitError(
+    code: String,
+    message: String,
+  ) {
+    emitEvent(
+      "topScanError",
+      Arguments.createMap().apply {
+        putString("code", code)
+        putString("message", message)
+      },
+    )
   }
 
   // ── Fabric event dispatch ──────────────────────────────────────────────────
 
-  private fun emitEvent(eventName: String, payload: WritableMap) {
+  private fun emitEvent(
+    eventName: String,
+    payload: WritableMap,
+  ) {
     val reactTag = id
     val dispatcher =
       UIManagerHelper.getEventDispatcherForReactTag(themedReactContext, reactTag)
     val surfaceId = themedReactContext.surfaceId
-    dispatcher?.dispatchEvent(object : Event<Event<*>>(surfaceId, reactTag) {
-      override fun getEventName(): String = eventName
-      override fun getEventData(): WritableMap = payload
-    })
+    dispatcher?.dispatchEvent(ScanEvent(surfaceId, reactTag, eventName, payload))
+  }
+
+  // RN 0.85 的 Event<T : Event<T>> 是自递归泛型(CRTP),必须用命名子类 Event<Self>;
+  // 匿名 object : Event<Event<*>> 不满足该 bound(0.85 起加严,旧版 bound 宽松能编)。
+  private class ScanEvent(
+    surfaceId: Int,
+    viewTag: Int,
+    private val name: String,
+    private val data: WritableMap,
+  ) : Event<ScanEvent>(surfaceId, viewTag) {
+    override fun getEventName(): String = name
+
+    override fun getEventData(): WritableMap = data
   }
 }