原生能力

运行环境边界

能力	Expo Go	Development build	本地原生工程
Expo Go 已内置模块	支持	支持	支持
带原生代码的第三方库	受限	支持	支持
Config Plugin	不能改变 Expo Go	支持	支持
自定义 Swift/Kotlin	不支持	支持	支持
直接修改原生工程	不支持	可选	支持

JavaScript 依赖通常只需重新启动 Metro；增加原生库、修改权限、Config Plugin 或原生代码后，必须重新构建 development build。

bash

npx expo install package-name

安装前应确认：

Config Plugin 在 Prebuild 阶段修改 Android 和 iOS 工程。插件配置通常位于应用配置中：

json

{
  "expo": {
    "plugins": [
      [
        "expo-camera",
        {
          "cameraPermission": "允许应用使用相机"
        }
      ]
    ]
  }
}

配置变更不会由 Metro 热更新应用到已安装客户端，必须重新生成或构建原生应用。

bash

npx expo prebuild
npx expo prebuild --clean

Prebuild 根据应用配置和 Config Plugin 生成 android、ios。--clean 会删除并重新生成原生目录，只适用于原生目录可重建且没有未迁移的手工修改时。

Continuous Native Generation 模式通常不提交原生目录，配置变化通过应用配置与插件表达。若团队决定直接维护原生目录，则应提交这些文件并按普通 Android/iOS 工程管理。

应用需要自定义 Swift、Kotlin 或原生 View 时，可以创建本地 Expo Module：

bash

npx create-expo-module@latest --local

本地模块只服务当前应用；需要跨项目共享或发布到 npm 时，使用独立模块。原生模块应提供清晰的异步边界、错误类型和平台能力检测。

权限分为构建时声明和运行时请求：