SuperAPI AI 工具集

expo-module

通用与其它

查看项目

更新于 10-16 06:45

技能介绍

用途:指导开发者用 Expo Modules API 编写 Expo 原生模块和原生视图,覆盖 Swift(iOS)、Kotlin(Android)和 TypeScript。

适用时机:创建新的原生模块或原生视图;为 Expo 应用加入原生能力(相机、传感器、系统 API);封装平台 SDK 供 React Native 使用;编写修改原生工程文件的 config plugin。

参考文档:native-module.md(模块定义 DSL,含 Name、Function、AsyncFunction、Property、Constant、Events、类型系统与共享对象);native-view.md(原生视图组件,含 View、Prop、EventDispatcher、视图生命周期与基于 ref 的函数);lifecycle.md(模块、iOS AppDelegate、Android activity/application 监听等生命周期钩子);config-plugin.md(修改 Info.plist、AndroidManifest.xml 及在原生代码中读取值);module-config.md(expo-module.config.json 字段与 autolinking 配置)。

快速开始:在现有应用中创建本地模块,应先用 create-expo-module 脚手架再改代码,以保证 podspec、build.gradle 和模块配置正确。命令:CI=1 npx create-expo-module@latest --local --name MyModule --description "My Expo module" --package expo.modules.mymodule。CI=1 跳过交互并采用所传参数。注意:非交互模式下脚手架固定生成 modules/my-module/ 目录(slug 由未定义的 customTargetPath 推导,--name 只设原生类名),重命名后需运行 cd ios && pod install,否则 iOS 构建报错。可用参数有 --name、--description、--package、--author-name、--author-email、--author-url、--repo。

脚手架会同时生成原生模块与原生视图(含 hello() 函数、PI 常量、onChange 事件、基于 WebView 的视图),完成后按需删除多余样板;若不需要 Web 平台支持,可删除 .web.ts/.web.tsx 并从 expo-module.config.json 的 platforms 中移除 "web"。仅需模块时删除视图文件及定义中的 View 块;仅需视图时删除 Function、AsyncFunction、Constant、Events 块,仅保留 Name 与 View。

发布用独立模块命令:npx create-expo-module@latest my-module。模块定义在 Swift 与 Kotlin 中结构一致,通过 Name("MyModule") 与 Function("hello") 等声明,TypeScript 侧用 requireNativeModule 绑定。expo-module.config.json 中 iOS 填类名,Android 填全限定类名。

限制:以上为公开资料所述内容,具体版本兼容性、平台差异与完整字段暂未提供。