expo-ui-swift-ui

As instruções nesta skill se aplicam apenas ao SDK 55. Para outras versões do SDK, consulte a documentação do Expo UI SwiftUI para essa versão para obter as informações mais precisas.

Quando Usar

• Você precisa criar UI nativa para iOS no Expo usando @expo/ui/swift-ui.
• A tarefa envolve selecionar views ou modificadores SwiftUI, encapsular árvores em Host, ou incorporar componentes React Native com RNHostView.
• Você está visando o comportamento do Expo SDK 55 para integração e orientação de extensão do SwiftUI.

Instalação

npx expo install @expo/ui

Uma reconstrução nativa é necessária após a instalação (npx expo run:ios).

Instruções

• A API do Expo UI espelha a API do SwiftUI. Use o conhecimento de SwiftUI para decidir quais componentes ou modificadores usar.
• Componentes são importados de @expo/ui/swift-ui, modificadores de @expo/ui/swift-ui/modifiers.
• Ao usar um componente, obtenha sua documentação para confirmar a API - https://docs.expo.dev/versions/v55.0.0/sdk/ui/swift-ui/{component-name}/index.md
• Ao ter dúvidas sobre a API de um modificador, consulte a documentação - https://docs.expo.dev/versions/v55.0.0/sdk/ui/swift-ui/modifiers/index.md
• Toda árvore SwiftUI deve ser encapsulada em Host.
• RNHostView é especificamente para incorporar componentes RN dentro de uma árvore SwiftUI. Exemplo:

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>;

• Se um modificador ou View necessário estiver faltando no Expo UI, ele pode ser estendido através de um módulo Expo local. Veja: https://docs.expo.dev/guides/expo-ui-swift-ui/extending/index.md. Confirme com o usuário antes de estender.

Limitações

• As APIs visam o SDK 55; verifique a documentação real do Expo para essa versão e o pacote instalado antes de editar. Exemplos Android/iOS são específicos da plataforma, não intercambiáveis ou prova de comportamento em dispositivo real. O framework existente e os requisitos do usuário têm precedência.
• Reconstruções nativas instalam/executam dependências e alteram o projeto; revise o alvo de desenvolvimento pretendido primeiro. icon.xml e código do aplicativo são ativos da aplicação, não arquivos empacotados.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem faltando.