# @g9tm/lynxcontrols-native 中文文档

规范地址：https://npmcn.com/package/%40g9tm/lynxcontrols-native/

版本：1\.7\.3
npm 元数据更新时间：2026-11-15T21:59:56.197Z
中文译文更新时间：2026-11-15T23:40:30.558Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40g9tm/lynxcontrols-native
原文对照：https://npmcn.com/package/%40g9tm/lynxcontrols-native/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：335 kB，86 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：@lynx-js/react \>=0\.129\.1 \<0\.130\.0
- 首次发布：2026-10-06T18:29:13.475Z
- 最新版本发布：2026-11-15T21:59:56.044Z
- 近 30 天下载量：1994（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

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

## 安装

```sh
npm install @g9tm/lynxcontrols-native
```

也可以使用：`pnpm add @g9tm/lynxcontrols-native`、`yarn add @g9tm/lynxcontrols-native`、`bun add @g9tm/lynxcontrols-native`

## README

# @g9tm/ lynxcontrols- 本地化

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

| 模块 | JS 适配器 | Android (科特林语) | iOS(目标-C) |
| --- | --- | --- | --- |
| `G9SqliteModule` | `createNativeSqliteDriver()` | 自动读取 `BundledSQLiteDriver` 2.7.1 国家 | 系统 `sqlite3` (iOS 15+,每会话序列排队, `sqlite3_interrupt`(中文(简体) ) |
| `G9HostModule` | `createNativeHostServices()` | `SharedPreferences`, (中文(简体) ), `moveTaskToBack`, (中文(简体) ), `InputMethodManager`杂乱无章, `appDataDirectory()` =: `filesDir` | `NSUserDefaults` 套间, `resignFirstResponder`, (中文(简体) ), `UIImpactFeedbackGenerator`安全区域设置, `appDataDirectory()` =: `Library` |
| `G9SpeechModule` | `createNativeSpeechToText()` → `services.speech` (投入实地) | `SpeechRecognizer` (主线程,部分结果),通过主机活动询问的麦克风 `ActivityResultRegistry` | `SFSpeechRecognizer` 结束 `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`(中文(简体) ) |

```ts
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`就像每个司机一样.
    

## 版式

```text
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-jvm` | Kotlin核心:第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-core` | linux上的iOS核心(clang + GNUstep):合同27/27×2,与克特林的金字节-同名,中断,ARC语法 |
| `npm run bench:transport` | JS 解码费用 `columnar` 对 `rows` |

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

## 常见问题

### @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 和提交记录判断。

