@g9tm/lynxcontrols-native

中文文档
1.7.3发布于 2026/11/16MITTypeScriptES Module近 30 天下载 1994

Android和iOS平台层:G9SqliteModule和G9HostModule本土模块(Autolink)及其JS适配器.

中文使用文档
文档目录3 节
  1. 如何运作
  2. 版式
  3. 图标

@g9tm/ lynxcontrols- 本地化

G9的Android和iOS平台层:三个Lynx本地模块和一个元素(<g9-video>,链接到主机 Lynx 自动链接 从 node_modules加上他们的JS适配器.

模块JS 适配器Android (科特林语)iOS(目标-C)
G9SqliteModulecreateNativeSqliteDriver()自动读取 BundledSQLiteDriver 2.7.1 国家系统 sqlite3 (iOS 15+,每会话序列排队, sqlite3_interrupt(中文(简体) )
G9HostModulecreateNativeHostServices()SharedPreferences, (中文(简体) ), moveTaskToBack, (中文(简体) ), InputMethodManager杂乱无章, appDataDirectory() =: filesDirNSUserDefaults 套间, resignFirstResponder, (中文(简体) ), UIImpactFeedbackGenerator安全区域设置, appDataDirectory() =: Library
G9SpeechModulecreateNativeSpeechToText() → services.speech (投入实地)SpeechRecognizer (主线程,部分结果),通过主机活动询问的麦克风 ActivityResultRegistrySFSpeechRecognizer 结束 AVAudioEngine; 在主机上注册 LynxConfig; 信息.plist (帮助) NSMicrophoneUsageDescription + 键 NSSpeechRecognitionUsageDescription
<g9-video> 元素createNativeMediaProvider() (单位:千美元)@g9tm/lynxcontrols-native/media(中文(简体) )G9VideoUI: 媒体 3 Exoplayer 1.8.0入a TextureView (不透明工作逐渐消失);登记 G9VideoBehaviors.create()G9VideoUI数字 : AVQueuePlayer + 键 AVPlayerLooper 在一个 AVPlayerLayer; 自登记员(LYNX_REGISTER_UI(中文(简体) )
import { createG9Sqlite, singleFileDatabaseLocator } from '@g9tm/lynxcontrols-sqlite';
import { createNativeHostServices, createNativeSqliteDriver } from '@g9tm/lynxcontrols-native';

const { host, preferences, appDataDirectory } = createNativeHostServices();
const root = await appDataDirectory(); // MAUI FileSystem.AppDataDirectory: the MAUI app's database stays found
const db = createG9Sqlite({ driver: createNativeSqliteDriver(), locator: singleFileDatabaseLocator(`${root}/g9.db`), /* … */ });
// <G9Provider services={{ clock, host, preferences }}>

如何运作

  • 拼写 (单位:千美元)services.speech马里 IG9SpeechToText) (中文(简体) ). createNativeSpeechToText() 返回时 null 地点 G9SpeechModule 没有链接,所以田地隐藏他们的麦克风。 本土化的一次会话; 适配器 编号会话、路线 g9:speech 全球活动{"session","text"},临时假设) 请将中止转换为 cancel(session) 并解决每一个 listen 一次( e)recognized 编号 : no-match 编号 : cancelled 编号 : denied; 识别错误用 G9Error) (中文(简体) ). Android: 列表合并 RECORD_AUDIO 财务报告和审定财务报表 页:1 RecognitionService 查询 Android 11+ 需要查看识别器;和roidx.活性只编译(每个主机) 有; 主办活动不是 ActivityResultRegistryOwner 获得当前权限状态, 绝不 快速). isAvailable(locale) 在Android上是“一个识别器存在” (向一个地方询问需要广播一些识别器从不) 答案; 不支持的语言结尾为 no-match和 SFSpeechRecognizer(locale).isAvailable (原始内容存档于2018-03-31). On iOS.

  • 视频 (室内木马) services.media) (中文(简体) ). <g9-video> 道具 : src, (中文(简体) ), paused, (中文(简体) ), loop, (中文(简体) ), muted, (中文(简体) ), start-seconds, (中文(简体) ), near-end-seconds, (中文(简体) ), object-fit; 事件 ready, (中文(简体) ), nearend, (中文(简体) ), looped, (中文(简体) ), error。提供方的 播放器使用反应道具( 无 UI 方法调用) 使其卸载 dispose(),释放土著 游戏机. resolve() 地图捆绑资产与 G9HostModule.assetUri (单位:千美元)not-found 当应用程序没有运送 存档). 近端/出站和起站点规则是无站台核心 video/core/G9VideoCore.kt 财务报告和审定财务报表 ios/src/core/G9VideoCore.m,在JVM和Linux测试.

  • 合约. 司机通过共享合同 @g9tm/lynxcontrols-sqlite/contract/cases.json (27起案件):通过联合核查团 克特林核心npm run test:android-jvm在联署材料中,通过模块协议(第2条)src/native.test.ts) (中文(简体) ).

  • 丝线. 每个开放数据库有一个单行道执行器,并排出队列(256;溢出) busy) (中文(简体) ). 答复 这是信封 { ok, value | error }这样 G9SqliteError 字段( r)code, (中文(简体) ), sqliteCode, (中文(简体) ), sql, (中文(简体) ), completedStatements在桥上幸存下来.

  • 撤销. 在JS排队时,有批次流产,但从未达到原地密码.

    • 中止运行中的批量呼叫 interrupt(session)。 。 。 .
    • iOS: (英语) sqlite3_interrupt 停止语句, 批次失败 interrupted。 。 。 .
    • Android:Androidx连接没有中断,因此语句结束(capabilities().interrupt === false) (中文(简体) ).
  • 运输 (单位:千美元)plan/specs/06 第6条. columnar (默认) : 单元格标记、 浮点64 数字和 Blob 字节作为 ArrayBuffers, 文本为字符串. rows: 有标记的单元格。 选择方式 createNativeSqliteDriver({ transport })。 。 。 . contract/transport-golden.json 针入字节:克特林编码器写出,JS解码器测试读出.

  • 价值. 安全整数作为数字交叉,其他为 { int64 },BLOBs作为ArrayBuffer。 NUL 在文本中, , NaN 财务报告和审定财务报表 undefined 以 misuse就像每个司机一样.

版式

types/platform-native-module.d.ts   codegen input (`npm run codegen` → generated/, android/…/generated, ios/src/generated;
                                    then scripts/android-bridge-types.mjs --fix gives the Android specs the parameter
                                    types Lynx's bridge accepts — never run the bare generator)
scripts/android-bridge-types.mjs    `--fix` after codegen; without it, the check (`npm run check:android-types`)
android/src/main/java/com/g9lynx/g9native/
  sqlite/core/      pure Kotlin: G9SqliteCore, G9SqliteService (executors), G9SqliteTransport, values/errors
  sqlite/androidx/  AndroidxSqlEngine (BundledSQLiteDriver)
  host/core/        G9PreferencesCore
  G9SqliteModule.kt, G9HostModule.kt, G9SpeechModule.kt, G9Bridge.kt   Lynx modules (kapt + lynx-processor →
                    LynxLibraryProviderImpl)
android/src/test/   JVM tests: contract runner, core, service, transport golden, preferences
ios/src/core/       portable Objective-C (Foundation + sqlite3): G9SqliteCore, G9SqliteTransport, G9PreferencesCore
ios/src/            G9SqliteModule.m, G9HostModule.m, G9SpeechModule.m (dispatch queues, UIKit, Speech); register them
                    on the host's LynxConfig
ios/Tests/          G9NativeTestSuite (XCTest on a simulator; Linux harness in Tests/linux)
jvm/                JVM-only Gradle build of the core + tests (no Android SDK needed)
android-check/      cloud compile check of module + reference host against the published Lynx 4.1.0 classes (Media3,
                    androidx.sqlite and androidx.activity as compile-only stubs under stubs/), and
                    LynxBridgeSignatureTest: every @LynxMethod through Lynx's own LynxMethodWrapper

Android 软件包是 com.g9lynx.g9native没有 com.g9lynx.native数字 : native 在爪哇语中是一个保留词,所以 生成的 Java 规格无法在此名称下编译 .

本地标识符是内部的,没有遵循 npm 重命名 @g9tm/lynxcontrols-native (第D12号决定): android 软件包 com.g9lynx.g9native,iOS舱 g9lynx-native,模块类 G9SqliteModule 财务报告和审定财务报表 G9HostModule优先商店 g9lynx.preferences 保留他们的名字, 所以主机和存储的数据不是 受到影响。 被套接地的版本跟随了被套接地的版本(=被套接地的G9MAUI Controls版本).

图标

命令证明什么
npm run test:android-jvmKotlin核心:第27/27号合同,涉及两种运输(JDBC引擎),单元测试,JaCoCo门(线路为95%,分行为85%)
gradle -p packages/native/jvm check -Pg9.bundled=true和机器人一样 BundledSQLiteDriver (需要谷歌马文)
npm run check:android-module根据 Lynx 4.1.0 编辑模块和主机,并生成自动链接提供者
npm run test:ios-corelinux上的iOS核心(clang + GNUstep):合同27/27×2,与克特林的金字节-同名,中断,ARC语法
npm run bench:transportJS 解码费用 columnar 对 rows

主机集成 : docs/integration/android.md 财务报告和审定财务报表 docs/integration/ios.md (参考主机 : apps/android-host, (中文(简体) ), apps/ios-host) (中文(简体) ).

版本与发布记录

@g9tm/lynxcontrols-native 共发布 15 个版本,首次发布于 2026/10/07;过去 12 个月发布了 15 个版本。

版本发布日期距今
1.7.3latest2026/11/16今天
1.7.22026/11/132 天前
1.7.12026/11/133 天前
1.7.02026/11/133 天前
1.6.12026/11/123 天前
1.6.02026/11/123 天前

关于 @g9tm/lynxcontrols-native 的常见问题

@g9tm/lynxcontrols-native 是什么?

Android和iOS平台层:G9SqliteModule和G9HostModule本土模块(Autolink)及其JS适配器.

如何安装 @g9tm/lynxcontrols-native?

在项目目录运行 npm install @g9tm/lynxcontrols-native,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@lynx-js/react(>=0.129.1 <0.130.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@g9tm/lynxcontrols-native 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@g9tm/lynxcontrols-native 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@g9tm/lynxcontrols-native 可以商用吗?

@g9tm/lynxcontrols-native 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@g9tm/lynxcontrols-native 的下载量有多少?

根据 npm 官方下载统计,@g9tm/lynxcontrols-native 在 2026/10/16 – 2026/11/14 这 30 天内被下载 1,994 次,日均约 66 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@g9tm/lynxcontrols-native 还在维护吗?

最新版本 1.7.3 发布于 2026/11/16(今天);至今共发布 15 个版本,其中过去 12 个月发布了 15 个;首次发布于 2026/10/07。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。