SuperAPI AI 工具集

1k-cross-platform

通用与其它

查看项目

更新于 10-16 02:38

技能介绍

用途:为 OneKey 项目提供跨平台开发规范,指导如何编写平台特定代码,并说明各平台(React Native、Web、Electron 桌面、浏览器扩展)的注意事项与支持的操作系统/SDK 要求。

主要能力:

  1. 平台扩展文件:按平台使用不同后缀,.native.ts 对应 React Native(iOS/Android),.web.ts 对应 Web,.desktop.ts 对应桌面(Electron),.ext.ts 对应浏览器扩展;打包器会自动解析对应文件。
  2. 平台检测:统一使用 platformEnv,禁止直接检查(如 typeof window、process.env.REACT_APP_PLATFORM)。可用标志包括 isNative、isWeb、isDesktop、isExtension、isIOS、isAndroid、isWebEmbed。
  3. 平台特定导入与文件结构:以共享接口加各平台实现的方式组织,例如 storage 接口分别由 AsyncStorage、localStorage、ipcRenderer 实现。
  4. 平台注意事项:扩展涉及 MV3/service worker 生命周期、权限、CSP、后台脚本限制;移动端涉及 WebView 限制、原生模块、前后台状态、深链接;桌面涉及安全边界、IPC、文件系统访问;Web 涉及 CORS、存储限制、XSS 防护、包体积。
  5. 提供跨平台检查清单:使用正确文件扩展名、使用 platformEnv、公共逻辑抽取到共享文件、在所有目标平台测试。

使用方式:在 OneKey 仓库中按上述约定命名文件并导入 platformEnv;详细模式见 cross-platform.md,工具与最低平台版本见 platform-requirements.md,使用前应核对仓库文件中的版本值。

适用场景:需要在多端复用逻辑并处理平台差异的 OneKey 前端/客户端开发。

限制:资料未提供具体支持的操作系统与 SDK 版本数值、安装命令或收费信息,需查阅仓库内对应文档确认。