Primeros pasos
Compatibilidad y plataformas
Elige el entorno de aplicación y los módulos nativos que necesita tu pantalla.
¿Qué versiones debo utilizar?
Parte de la plantilla oficial de Angular Native y sigue Instalación para añadir Neural Native. La biblioteca y el framework tienen versiones independientes. La tabla identifica la base documentada de la aplicación; una versión posterior del framework requiere comprobar su compatibilidad.
| Paquete o herramienta | Versión documentada | Cómo elegir |
|---|---|---|
| Neural Native | 0.1.0-beta.1 · Beta | La API de la versión beta puede cambiar antes de 1.0.0. |
| Angular Native | 0.18.2 | Mantén components, fabric, device e icons en la misma versión. Utiliza también esta versión para testing. |
| Angular | 22.2.2 | El paquete Native declara >=22.2.0 <23. Esta es la versión utilizada por los ejemplos. |
| TypeScript | 6.0.3 | Utiliza un compilador compatible con tu versión de Angular. |
| Node.js | 24.15.0 | Es el entorno de desarrollo utilizado por estos ejemplos. Consulta Requisitos para las herramientas compatibles. |
¿Sobre qué se ejecuta la aplicación nativa?
La aplicación documentada utiliza Expo 57.0.27 y su runtime React Native 0.86.3. Angular Native dirige Fabric desde Angular; escribes componentes Angular. Conserva el runtime de la plantilla Expo en lugar de cambiar su versión de React Native por separado.
Cómo renderiza las vistas Angular Native ↗ · Configuración oficial de la aplicación ↗
iOS, Android y la vista de la documentación
| Entorno | Qué preparar | Qué comprobar en tu pantalla |
|---|---|---|
| iOS | Utiliza macOS y Xcode para compilar localmente, o una aplicación compatible instalada en tu dispositivo. | Áreas seguras, teclado, texto ampliado y VoiceOver. Adapta el layout a las anchuras de iPhone y iPad. |
| Android | Utiliza un emulador o dispositivo Android y el SDK que requiere la aplicación. | Volver del sistema, teclado, texto ampliado y TalkBack. Incluye layouts de móvil y tableta. |
| Vista web | Estos ejemplos de documentación utilizan @ng-native/web 0.18.2. | El selector cambia el marco. Comprueba los gestos, el teclado y las superficies del sistema en la aplicación instalada. |
Las versiones mínimas del sistema operativo dependen de la configuración del proyecto Expo/nativo elegido. Utiliza sus requisitos al preparar una compilación. El marco de un teléfono en la documentación no selecciona una versión del sistema operativo.
¿Un componente necesita módulos nativos adicionales?
| Función | Dependencia de la aplicación | Qué hacer |
|---|---|---|
| Áreas seguras | react-native-safe-area-context | Instálalo en tu aplicación y utiliza SafeAreaProvider/SafeAreaView alrededor del contenido. Expo Go puede incluir ya el módulo nativo. |
| Iconos SVG | react-native-svg 15.15.4 | Es un peer de Neural Native. Mantén la versión documentada al reproducir esta base. |
| Selector de archivos predeterminado | expo-document-picker | El selector predeterminado de Uploader utiliza este módulo. Un NEU_FILE_PICKER personalizado permite proporcionar tu propio flujo de selección. |
npx expo install react-native-safe-area-context react-native-svg
# Add this when using the default Uploader picker
npx expo install expo-document-pickerExpo Go y una compilación de desarrollo son entornos distintos. Si Expo Go no incluye un módulo nativo, crea una compilación de desarrollo que lo contenga. Cambiar dependencias nativas requiere recompilar esa aplicación, además de actualizar el bundle JavaScript.
Tema raíz y áreas seguras · Uploader y el contrato de su selector
¿Cómo actualizo sin mezclar versiones?
- Consulta el registro de cambios de Neural Native y elige una base documentada del framework.
- Actualiza conjuntamente los paquetes @ng-native. Mantén compatibles Angular y su compilador.
- Comprueba las dependencias, ejecuta tus pruebas y revisa la aplicación instalada en iOS/Android. Recompílala si cambian módulos nativos.
npm ls @angular/core @angular/compiler @ng-native/components @ng-native/fabric @ng-native/device @ng-native/icons
npx expo install --checkSi npm indica un peer inválido o varias versiones del framework, alinea las declaraciones y reinstala antes de continuar. Evita ocultar el conflicto con --force o --legacy-peer-deps.