集成到现有库中

添加 expo-modules-core 原生依赖

¥Add the expo-modules-core native dependency

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

¥Add expo-modules-core as a dependency in your build.gradle and podspec files:

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

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

将 Expo 包添加到依赖中

¥Add Expo packages to dependencies

在你的 package.json 中添加 expo 包作为对等依赖 — 我们建议使用 * 作为版本范围，以免在用户的 node_modules 目录中导致任何重复的包。

¥Add expo package as a peer dependency in your package.json — we recommend using * as a version range so as not to cause any duplicated packages in user's node_modules directory.

你的库也需要依赖 expo-modules-core，但仅作为开发依赖 — 它已在项目中提供，具体取决于你的库，由 expo 包提供，其核心版本与项目中使用的特定 SDK 兼容。

¥Your library also needs to depend on expo-modules-core but only as a dev dependency — it's already provided in the projects depending on your library by the expo package with the version of core that is compatible with the specific SDK used in the project.

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

创建原生模块

¥Create a native module

从以下模板创建 Kotlin 和 Swift 文件：

¥Create Kotlin and Swift files from the templates below:

package my.module.package

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

class MyModule : Module() {
override fun definition() = ModuleDefinition {
// Definition components go here
}
}

import ExpoModulesCore

public class MyModule: Module {
public func definition() -> ModuleDefinition {
// Definition components go here
}
}

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

¥Then, add your classes to Android and/or iOS modules in the expo-module.config.json file. Expo Autolinking will automatically link these classes as native modules in the user's project.

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

如果你的工作区中已有示例应用，请确保模块已正确链接。

¥If you already have an example app in your workspace, ensure that the module is linked correctly.

• 在 Android 上，作为 Gradle 构建任务的一部分，原生模块类将在构建之前自动链接。

  ¥On Android the native module class will be linked automatically before building, as part of the Gradle build task.

• 在 iOS 上，你需要运行 pod install 来链接新类。

  ¥On iOS you need to run pod install to link the new class.

现在可以使用 expo-modules-core 包中的 requireNativeModule 函数从 JavaScript 代码访问这些模块类。为了简单起见，我们建议创建一个导出原生模块的单独文件。

¥These module classes are now accessible from the JavaScript code using the requireNativeModule function from the expo-modules-core package. We recommend creating a separate file that exports the native module for simplicity.

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

export default requireNativeModule('MyModule');