用途:在编写或审查 Kotlin 代码时,帮助建立强类型建模、显式异步边界和符合 Android 习惯的集成方式。若代码属于 Nitro Module,需与 build-nitro-modules 配合使用,以处理生成的 spec、Promise 映射、注解和 HybridObject 约束。
主要能力:用密封接口/类、普通接口或具体类表达状态变体,避免用大量可空字段的单一 data class;让相关值在有效变体上保持非空,用可空类型表示真实缺失,优先编译期收窄而非调用方反复判空。异步方面,对天然挂起 API 和已有协程支持的 Android I/O 使用协程;简单确定性的本地工作保持同步;CPU 密集同步工作使用自有 dispatcher/scope 或 Nitro Promise.parallel;避免主线程阻塞,禁止在库代码、属性 getter/setter 或面向 JS 的入口使用 runBlocking。属性应廉价非阻塞,副作用、I/O、服务调用、权限检查等应改为方法或事件。
使用方式:编辑前先阅读本地 Kotlin 代码、生成的抽象类和公开 API 形态;先建模有效状态再实现行为;明确同步、协程或显式调度。Nitro 实现需继承生成的 Hybrid*Spec 并加 @Keep 与 @DoNotStrip;挂起或 I/O 用 Promise.async,CPU 同步用 Promise.parallel,避免手动创建 Promise。
限制与风格:类默认 final;一个文件一个顶层实现类型,扩展与转换放入独立命名文件;避免 !!、宽泛 Utils.kt 和把领域转换挂在 Int/String 等通用接收者上;不要用 delay、Thread.sleep 或重复调用掩盖竞态;锁仅作最后手段,且持锁时不得调用回调或 JS。资料未提供收费、价格、平台支持范围等具体信息。