在现有库中集成

添加 expo-modules-core 本机依赖

在您的 build.gradle 和 podspec 文件中将 expo-modules-core 添加为依赖项：

// ...
dependencies {
  // ...
  implementation project(':expo-modules-core')
}

# ...
Pod::Spec.new do |s|
  # ...
  s.dependency 'ExpoModulesCore'
end

将 Expo 包添加为依赖项

在您的 package.json 中将 expo 包添加为对等依赖 — 我们推荐使用 * 作为版本范围，以避免在用户的 node_modules 目录中造成任何重复的包。

您的库还需要依赖于 expo-modules-core，但仅作为开发依赖 — 它已经由依赖于您库的项目中的 expo 包提供，版本与项目中使用的特定 SDK 兼容。

{
  %%placeholder-start%%... %%placeholder-end%%
  "devDependencies": {
    "expo-modules-core": "^X.Y.Z"
  },
  "peerDependencies": {
    "expo": "*"
  },
  "peerDependenciesMeta": {
    "expo": {
      "optional": true
    }
  }
}

创建本机模块

根据下面的模板创建 Kotlin 和 Swift 文件：

package my.module.package

import expo.modules.kotlin.modules.Module
import expo.modules.kotlin.modules.ModuleDefinition

class MyModule : Module() {
  override fun definition() = ModuleDefinition {
    // 定义组件在此处
  }
}

import ExpoModulesCore

public class MyModule: Module {
  public func definition() -> ModuleDefinition {
    // 定义组件在此处
  }
}

然后，将您的类添加到 expo-module.config.json 文件的 Android 和/或 iOS modules 中。Expo 自动链接将自动将这些类链接为用户项目中的本机模块。

{
  "ios": {
    "modules": ["MyModule"]
  },
  "android": {
    "modules": ["my.module.package.MyModule"]
  }
}

如果您在工作区中已经有一个示例应用，请确保模块正确链接。

• 在 Android 中，本机模块类将在构建之前作为 Gradle 构建任务的一部分自动链接。
• 在 iOS 中，您需要运行 pod install 来链接新类。

这些模块类现在可以通过 expo-modules-core 包中的 requireNativeModule 函数从 JavaScript 代码访问。我们建议创建一个单独的文件，导出本机模块以简化操作。

import { requireNativeModule } from 'expo-modules-core';

export default requireNativeModule('MyModule');