@goliapkg/smix

中文文档
25.1.0发布于 2026/11/11Apache-2.0 OR MITTypeScriptES Module零依赖近 30 天下载 3385

Playwright-shape iOS模拟器 / Android仿真器 UI自动化SDK用于回放原生+博览会 + Detox-兼容TypeScript测试跑取.

中文使用文档
文档目录6 节
  1. 今天有什么用吗
  2. 安装
  3. 选择器
  4. 届会周期
  5. 期望 失败
  6. 许可证

@goliapkg/ smix (英语)

类型脚本类型和主机侧构件 组合 - AI-原生UI自动化,用于 iOS模拟器和Android模拟器.

现场驾驶贯穿了美洲狮外加. 这个包裹也一样 输入 API 表面为 Swift / Kotlin / Rust SDK ; Smix.launchApp, (中文(简体) ), App.tap, (中文(简体) ), App.fill,其余通过呼叫驱动设备 @goliapkg/smix-node。 。 。 . Smix.launchApp 装入每个平台的添加 自动( 通过) loadNodeDriver);加通由每三层所建 在 CI 中预建矩阵,其 npm 发布在后面的版本中——您 也可以注入一个 NodeDriver 明确用于测试或海关运输. 三块地还抛出 SmixNotImplementedError 在运输途中: App.screenshot 财务报告和审定财务报表 App.openUrl 需要一条跑道 App.launchFresh 需要主机侧状态清除 。 驱动一个设备没有 今天的加词,请使用 smix 国 际 或者说 斯威夫特 克特林 斯德 SDK.

今天有什么用吗

  • 选择器 DSL —— 完整的选择语言, 编码到精确 JSON铁丝网塑造出Rust核解.
  • 届会周期 —— 说 Session.open 编号 : stillValid 编号 : relaunchApp 编号 : renewActivation 编号 : close 对阵一个正在运行的混音跑者,超过HTTP.
  • ExpectationFailure ——解析并制作Smix的AI可读 失败 JSON.
  • A11yNode ——打入的可访问性-树木模型 flatten 编号 : findById 编号 : rectCenter 帮助工作 smix tree --json 输出.

安装

bun add -D @goliapkg/smix
# OR
npm install -D @goliapkg/smix

仅测试目标: 保留在内 devDependencies,从来没有捆绑成一个 生产 RN / Expo app.

选择器

import { Selector, literal, regex } from '@goliapkg/smix'

Selector.id('btn-login')
Selector.text(literal('Sign In'))
Selector.text(regex('^Sub', 'i'))
Selector.label('Settings')
Selector.role('button', literal('Submit'))
Selector.localizedText({ en: 'Submit', ja: '送信' })

// Fluent modifier chaining (returns a new Selector)
Selector.id('btn').below(Selector.text(literal('Address'))).nth(0)
Selector.role('button').near(Selector.text(literal('Confirm')))

线接JSON(未标记 + 平面- 字节与 Rust 相同) smix-selector:

{"id": "btn-login", "below": {"text": "Address"}, "nth": 0}

届会周期

import { HttpSimRuntime, Session } from '@goliapkg/smix'

const runtime = new HttpSimRuntime('http://127.0.0.1:22087')
const session = await Session.open(runtime, 'com.example.app')
await session.relaunchApp()
await session.close()

HttpSimRuntime 还揭露 resolver 编号 : labelsResolver,哪个 解决选择者通过跑者 提供电话的树JSON /select/resolve 路线.

期望 失败

import { ExpectationFailure } from '@goliapkg/smix'

try {
  // a driving call, once the native transport lands
} catch (e) {
  if (e instanceof ExpectationFailure) {
    e.code            // 'ELEMENT_NOT_FOUND' | 'AMBIGUOUS' | 'TIMEOUT' | ...
    e.visibleElements // A11yNode[] — context for AI diagnosis
    e.suggestions     // string[]
    e.toJson()        // single-line JSON for agent consumption
  }
}

许可证

Apache-2.0 或 MIT(双重,由您选择).

版本与发布记录

@goliapkg/smix 共发布 90 个版本,首次发布于 2026/06/30;过去 12 个月发布了 90 个版本。

版本发布日期距今
25.1.0latest2026/11/116 天前
25.0.02026/11/106 天前
24.0.02026/11/088 天前
23.5.02026/11/0710 天前
23.4.02026/11/0511 天前
23.0.02026/11/0313 天前

其他发布通道:ship-preflight → 6.2.0。

关于 @goliapkg/smix 的常见问题

@goliapkg/smix 是什么?

Playwright-shape iOS模拟器 / Android仿真器 UI自动化SDK用于回放原生+博览会 + Detox-兼容TypeScript测试跑取.

如何安装 @goliapkg/smix?

在项目目录运行 npm install @goliapkg/smix,或使用 pnpm add / yarn add / bun add。

@goliapkg/smix 支持 TypeScript 吗?

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

@goliapkg/smix 支持 ESM 还是 CommonJS?

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

@goliapkg/smix 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@goliapkg/smix 可以商用吗?

@goliapkg/smix 使用 Apache-2.0 OR MIT 许可。可在 Apache-2.0、MIT 中任选其一遵守。选择 Apache-2.0 时,宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@goliapkg/smix 的下载量有多少?

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

@goliapkg/smix 还在维护吗?

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