Expo 模块 API：快速上手

创建本地 Expo 模块

🌐 Create the local Expo module

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

🌐 Navigate to your project directory (the one that contains the package.json file) and run the following command. This is the recommended way to create a local Expo module.

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

🌐 You can provide a meaningful module name in the CLI prompt. For the rest of the prompts, you can also accept the default suggestions.

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

🌐 Once you've run the command, you will see a new directory created in your project called modules. The directory structure should look like this:

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

🌐 Then, if your project doesn't have native projects generated (android and ios directories), run the following command, otherwise skip this command:

注意：如果你的项目根目录中已有一个使用 npx expo prebuild 创建的 ios 目录，你必须重新安装 pods：

Terminal

Copy

- npx pod-install

使用本地模块

🌐 Use the local module

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

🌐 Import the local module in your application, for example in App.js or App.tsx or 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>
  );
}

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

🌐 Start the development server in your terminal so that when you edit the native module and build the app in the next step, the changes will be reflected in the app:

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

🌐 Congratulations! You have created a local Expo module. You can now start working on it.

信息 提示：你也可以通过应用这些配置更改来使用绝对导入路径。

编辑模块

🌐 Edit the module

为了在本地开发和测试你的模块，我们使用 Android Studio 和 Xcode 来进行 Android 和 iOS 的开发。

🌐 To develop and test your module locally, let's use Android Studio and Xcode for Android and 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. 通过点击顶部菜单栏的 运行 'app' 按钮来构建应用，你将在屏幕上看到更改。

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

🌐 You have to repeat the build step anytime you make a change to the native code to the changes.

iOS

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

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

🌐 You have to repeat the build step anytime you make a change to the native code to the changes.

信息 提示：如果你向模块添加了新的本地文件或修改了 expo-module.config.json，请使用 npx pod-install 重新安装 pods。

创建 Expo 模块

🌐 Create the Expo module

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

🌐 To create a new Expo module from scratch, run the create-expo-module script as shown below. The script will ask you a few questions and then generate the native Expo module along with the example app for Android and iOS that uses your new module.

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

🌐 Open the module and start the development server

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

🌐 Navigate to the module directory and then open the Android and/or iOS example project by running the following commands:

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

🌐 Go to example directory and start the development server in your terminal so that when you edit the native module and build the app in the next step, the changes will be reflected in the app:

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

编辑模块

🌐 Edit the module

安卓

🌐 Android

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

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

🌐 You have to repeat the build step anytime you make a change to the native code to the changes.

iOS

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

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

🌐 You have to repeat the build step anytime you make a change to the native code to the changes.

信息 提示：如果你向模块添加了新的本地文件或修改了 expo-module.config.json，请使用 npx pod-install 重新安装 pods。