Expo 模块 API：开始入门

创建本地 Expo 模块

导航到您的项目目录（即包含 package.json 文件的目录），然后运行以下命令。这是创建本地 Expo 模块的推荐方法。

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

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

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

注意：如果您的项目根目录中存在使用 npx expo prebuild 创建的预先存在的 ios 目录，则必须重新安装 pods：

Terminal

复制

- npx pod-install

使用本地模块

在您的应用程序中导入本地模块，例如在 App.js 或 App.tsx 或 app/(tabs)/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 模块。您现在可以开始对其进行开发。

提示：您还可以通过 应用以下配置更改 来使用绝对导入路径。

编辑模块

要在本地开发和测试您的模块，让我们使用 Android Studio 和 Xcode 来支持 Android 和 iOS。

Android

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

每次对原生代码进行更改时，您都必须重复构建步骤。

iOS

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

每次对原生代码进行更改时，您都必须重复构建步骤。

提示：如果您向模块添加新的原生文件或修改 expo-module.config.json，请使用 npx pod-install 重新安装 pods。

创建 Expo 模块

从头开始创建新的 Expo 模块，运行如下 create-expo-module 脚本。该脚本会询问您一些问题，然后生成原生 Expo 模块以及一个使用您新模块的 Android 和 iOS 示例应用程序。

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

导航到模块目录，然后运行以下命令打开 Android 和/或 iOS 示例项目：

转到 example 目录并在您的终端中启动开发服务器，以便在您编辑原生模块并在下一步构建应用程序时，所做的更改将反映在应用中：

注意： 如果您使用 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 来构建您的应用程序，您将看到屏幕上的更改。

每次对原生代码进行更改时，您都必须重复构建步骤。

提示：如果您向模块添加新的原生文件或修改 expo-module.config.json，请使用 npx pod-install 重新安装 pods。