Expo Modules API：概述

在大多数情况下，Expo 和 React Native 开发者不需要编写任何原生代码 — 从相机到视频、地图、触觉反馈等，已经有可用的库覆盖了广泛的使用场景。

但有时，没有任何东西能完全满足你的需求。也许你想集成一个公司要求使用、但尚未提供 React Native 库的分析服务，因此你需要基于它们的 SDK 构建一个模块。又或者你想访问某个应用所必需、但并不常用的系统功能，所以没人维护对应的库。

简要总结并转述 React Native 团队的建议：

• 如果你打算在原生模块中使用 C++，请使用 Turbo Modules，因为它能更方便地访问更底层的机制。
• 如果你追求更好的开发体验，并且愿意在模块中依赖 expo 包，那么请使用 Expo Modules API。

Expo SDK 是一个很好的起点，如果你想了解我们是如何实现这些库的。另一个很棒的资源是开源应用，例如 Bluesky。

以下这些库是我们从社区中最喜欢的一些：

• react-native-widget-extension
• burnt
• expo-video-metadata
• swiftui-react-native
• react-native-ios-context-menu
• react-native-mlkit
• react-native-passkeys
• expo-drag-drop-content-view

在你的应用中添加 Expo Modules API 对应用体积的影响可以忽略不计，可能只会增加几百 KB。在这篇博客文章中了解更多。

Expo Modules API 的性能特征与 React Native 的 Turbo Modules API 类似。两个 API 都利用了 React Native 的 JavaScript Interface（JSI），而不是使用 JSON 消息队列（“bridge”）的旧方式（了解更多关于 JSI 的信息）。

Expo Modules 和 Turbo Modules 的设计目标都不是“尽可能快”，而是在重要的地方保持高性能。例如，Expo Modules API 可以利用代码生成以及新的 native Swift / C++ 互操作来降低单个方法调用的开销。然而，这会带来一些开发体验上的挑战和额外开销，而且我们还没有遇到任何能让这种优化在真实世界中带来有意义性能提升的使用场景。实际上，执行一个原生方法主体所花费的时间，通常比方法调用本身的开销大得多。Expo Modules 和 Turbo Modules 都可以轻松地每秒执行数十万次原生方法调用，这远远超过了你在任何应用中可能遇到的需求，而方法调用的开销也不太可能成为瓶颈。

如果你在使用 Expo Modules API 时遇到任何性能瓶颈，请 提交 issue，我们很乐意与你讨论。

Expo Modules API 对 macOS 和 tvOS 提供实验性支持。更多信息请参阅 其他平台支持 教程。

请在 集成现有库 教程中了解更多。