Expo Modules API：入门

创建本地 Expo 模块

进入你的项目目录（包含 package.json 文件的目录），然后运行以下命令。这是创建本地 Expo 模块的推荐方式。

你可以在 CLI 提示中提供一个有意义的模块名称。对于其余提示，也可以直接接受默认建议。

运行命令后，你会在项目中看到一个名为 modules 的新目录被创建。目录结构应如下所示：

然后，如果你的项目还没有生成原生项目（android 和 ios 目录），请运行以下命令；否则跳过此命令：

Note: 如果你的项目根目录中已经存在一个通过 npx expo prebuild 创建的 ios 目录，你必须重新安装 pods：

Terminal

Copy

- npx pod-install

使用本地模块

在你的应用中导入本地模块，例如在 App.js、App.tsx 或 src/app/index.tsx 中：

%%placeholder-start%%...%%placeholder-end%%
import MyModule from '@/modules/my-module';

export default function HomeScreen() {
  return (
    <View style={styles.container}>
      <Text>{MyModule.hello()}</Text>
    </View>
  );
}

在终端中启动开发服务器，这样当你在下一步编辑原生模块并构建应用时，改动就会反映到应用中：

恭喜！你已经创建了一个本地 Expo 模块。现在可以开始开发它了。

Tip: 你也可以通过应用这些配置更改来使用绝对导入路径。

编辑模块

为了在本地开发和测试你的模块，我们将使用 Android Studio 和 Xcode 分别处理 Android 和 iOS。

Android

1. 在 Android Studio 中打开项目里的 android 目录（这是在第 1 步中由 npx expo prebuild 生成的）。Gradle 完成原生目录项目同步可能需要一段时间。
2. 项目同步完成后，打开 modules/my-module/android/src/main/java/expo/modules/mymodule/MyModule.kt 文件。
3. 将 hello 函数修改为返回不同的字符串，例如 "Hello world! 🌎🤖"，并保存文件。
4. 通过点击顶部菜单栏中的 Run 'app' 按钮来构建应用，你会在屏幕上看到这些更改。

每当你对原生代码做出更改时，都需要重复构建步骤以使更改生效。

iOS

1. 在终端中运行 xed ios 命令，从 Xcode 打开项目中的 ios 目录（这是在第 1 步中由 npx expo prebuild 生成的）。
2. 在 Pods > Development Pods > MyModule 下，打开 MyModule.swift 文件。
3. 将 hello 函数修改为返回不同的字符串，例如 "Hello world! 🌎🍎"，并保存文件。
4. 通过点击顶部菜单栏中的 Run 按钮，或按 ⌘ Cmd + R 来构建应用，你会在屏幕上看到这些更改。

每当你对原生代码做出更改时，都需要重复构建步骤以使更改生效。

Tip: 如果你向模块中添加了新的原生文件，或者修改了 expo-module.config.json，请使用 npx pod-install 重新安装 pods。

创建 Expo 模块

要从零创建一个新的 Expo 模块，请按如下所示运行 create-expo-module 脚本。 该脚本会向你提出几个问题，然后生成原生 Expo 模块，以及适用于 Android 和 iOS、并使用你新模块的示例应用。

打开模块并启动开发服务器

进入模块目录，然后通过运行以下命令打开 Android 和/或 iOS 示例项目：

进入 example 目录并在终端中启动开发服务器，这样当你在下一步编辑原生模块并构建应用时，改动就会反映到应用中：

Note: 如果你使用的是 Windows，你可以通过在 Android Studio 中打开 android 目录来打开示例项目，但无法打开 iOS 项目文件。

编辑模块

Android

1. 打开 my-module/android/src/main/java/expo/modules/mymodule/MyModule.kt 文件。
2. 将 hello 函数修改为返回不同的字符串，例如 "Hello world! 🌎🤖"，并保存文件。
3. 通过点击顶部菜单栏中的 Run 'app' 按钮来构建应用，你会在屏幕上看到这些更改。

每当你对原生代码做出更改时，都需要重复构建步骤以使更改生效。

iOS

1. 在 Pods > Development Pods > MyModule 下，打开 MyModule.swift 文件。
2. 将 hello 函数修改为返回不同的字符串，例如 "Hello world! 🌎🍎"，并保存文件。
3. 通过点击顶部菜单栏中的 Run 按钮，或按 ⌘ Cmd + R 来构建应用，你会在屏幕上看到这些更改。

每当你对原生代码做出更改时，都需要重复构建步骤以使更改生效。

Tip: 如果你向模块中添加了新的原生文件，或者修改了 expo-module.config.json，请使用 npx pod-install 重新安装 pods。