expo-ui-swift-ui

此技能中的说明仅适用于 SDK 55。对于其他 SDK 版本，请参阅相应版本的 Expo UI SwiftUI 文档，以获取最准确的信息。

适用场景

• 你需要在 Expo 中使用 @expo/ui/swift-ui 构建 iOS 原生 UI。
• 任务涉及选择 SwiftUI 视图或修饰符、使用 Host 封装视图树，或通过 RNHostView 嵌入 React Native 组件。
• 你的目标是遵循 Expo SDK 55 中 SwiftUI 集成和扩展方面的指导。

安装

npx expo install @expo/ui

安装后需要重新进行原生构建（npx expo run:ios）。

说明

• Expo UI 的 API 与 SwiftUI 的 API 相对应。请运用 SwiftUI 知识来决定使用哪些组件或修饰符。
• 从 @expo/ui/swift-ui 导入组件，从 @expo/ui/swift-ui/modifiers 导入修饰符。
• 准备使用某个组件时，请获取其文档以确认 API：https://docs.expo.dev/versions/v55.0.0/sdk/ui/swift-ui/{component-name}/index.md
• 不确定某个修饰符的 API 时，请参阅文档：https://docs.expo.dev/versions/v55.0.0/sdk/ui/swift-ui/modifiers/index.md
• 每个 SwiftUI 视图树都必须使用 Host 封装。
• RNHostView 专用于在 SwiftUI 视图树中嵌入 RN 组件。示例：

import { Host, VStack, RNHostView } from "@expo/ui/swift-ui";
import { Pressable } from "react-native";

<Host matchContents>
  <VStack>
    <RNHostView matchContents>
      {/* Pressable is a React Native component, embedded through RNHostView. */}
      <Pressable />
    </RNHostView>
  </VStack>
</Host>;

• 如果 Expo UI 缺少所需的修饰符或 View，可以通过本地 Expo 模块扩展。请参阅：https://docs.expo.dev/guides/expo-ui-swift-ui/extending/index.md。扩展前请先征得用户同意。

限制

• API 面向 SDK 55；编辑前请核对该版本的 Expo 文档和已安装的软件包。Android/iOS 示例仅适用于各自平台，不能互换，也不能作为真实设备行为的证明。现有框架和用户要求优先。
• 原生重建会安装或执行依赖项并更改项目；请先确认预期的开发目标。icon.xml 和应用代码是应用资源，并非捆绑文件。
• 请勿将输出视为针对特定环境进行验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请暂停并请求澄清。