# Depuración de Aplicaciones iOS con Bibliotecas Nativas en Windows
Depurar una aplicación iOS .NET MAUI desde una máquina Windows no puede cargar bibliotecas de terceros nativas como IronOCR. La aplicación puede lanzarse en un iPhone conectado, pero el código nativo Tesseract del que depende IronOCR no se despliega correctamente.
```txt
Failed to locate 'libtesseract.5'...
Access to the path ... is denied.
```
La causa es el modelo de desarrollo estrictamente controlado de Apple. Las aplicaciones iOS deben estar **firmadas** con un certificado válido de desarrollador de Apple, las bibliotecas nativas deben estar **compiladas para ARM64** y vinculadas a través de las cadenas de herramientas de Apple, y las aplicaciones se ejecutan bajo **estricto aislamiento** que restringe el acceso al sistema de archivos en tiempo de ejecución. Las herramientas de Apple (`Xcode`, `codesign`, `lipo`) solo funcionan en macOS, por lo que una máquina con Windows no puede empaquetar o firmar completamente la biblioteca nativa. Cuando depura desde Windows, el binario Tesseract termina faltante, sin firmar o bloqueado por el sandbox, produciendo los errores antes mencionados.
Es por eso que el mismo código funciona sin problemas en objetivos Android o Windows: esas plataformas cargan bibliotecas nativas sin los requisitos de firma de Apple, y Tesseract empaquetado de IronOCR funciona como se espera.
## Solución
### 1. Compilar a través de un Mac
Desarrolle directamente en macOS, o utilice la función **Pair to Mac** de Visual Studio para transferir las construcciones de iOS a un Mac mientras codifica en Windows. Enrutar la compilación a través de la cadena de herramientas de Apple es la única forma en que la biblioteca nativa se compila y se firma correctamente.
### 2. Deje que IronOCR despliegue sus propias bibliotecas
No copie ni reubique manualmente los archivos de biblioteca nativos. IronOCR maneja la implementación de Tesseract por usted, y editar rutas manualmente rompe el modelo de empaquetamiento de iOS.
[[w:(Copiar manualmente bibliotecas nativas en iOS típicamente desencadena los errores de acceso al sandbox mencionados anteriormente. Deje la implementación a IronOCR a menos que entienda completamente las reglas de implementación de Apple.)]]
### 3. Pruebe en dispositivos reales a través de macOS
Ejecute sus pruebas en un iPhone físico o en un simulador iOS lanzado desde un Mac. Eso da una imagen precisa de cómo se comporta la aplicación firmada y protegida por sandbox, lo cual una sesión de depuración de Windows no puede reproducir.
Depurar una aplicación iOS .NET MAUI desde una máquina Windows no puede cargar bibliotecas de terceros nativas como IronOCR. La aplicación puede lanzarse en un iPhone conectado, pero el código nativo Tesseract del que depende IronOCR no se despliega correctamente.
Failed to locate 'libtesseract.5'...Access to the path ... is denied.
Failed to locate 'libtesseract.5'...
Access to the path ... is denied.
Text
La causa es el modelo de desarrollo estrictamente controlado de Apple. Las aplicaciones iOS deben estar firmadas con un certificado válido de desarrollador de Apple, las bibliotecas nativas deben estar compiladas para ARM64 y vinculadas a través de las cadenas de herramientas de Apple, y las aplicaciones se ejecutan bajo estricto aislamiento que restringe el acceso al sistema de archivos en tiempo de ejecución. Las herramientas de Apple (Xcode, codesign, lipo) solo funcionan en macOS, por lo que una máquina con Windows no puede empaquetar o firmar completamente la biblioteca nativa. Cuando depura desde Windows, el binario Tesseract termina faltante, sin firmar o bloqueado por el sandbox, produciendo los errores antes mencionados.
Es por eso que el mismo código funciona sin problemas en objetivos Android o Windows: esas plataformas cargan bibliotecas nativas sin los requisitos de firma de Apple, y Tesseract empaquetado de IronOCR funciona como se espera.
Solución
1. Compilar a través de un Mac
Desarrolle directamente en macOS, o utilice la función Pair to Mac de Visual Studio para transferir las construcciones de iOS a un Mac mientras codifica en Windows. Enrutar la compilación a través de la cadena de herramientas de Apple es la única forma en que la biblioteca nativa se compila y se firma correctamente.
2. Deje que IronOCR despliegue sus propias bibliotecas
No copie ni reubique manualmente los archivos de biblioteca nativos. IronOCR maneja la implementación de Tesseract por usted, y editar rutas manualmente rompe el modelo de empaquetamiento de iOS.
Advertencia: Copiar manualmente bibliotecas nativas en iOS típicamente desencadena los errores de acceso al sandbox mencionados anteriormente. Deje la implementación a IronOCR a menos que entienda completamente las reglas de implementación de Apple.
3. Pruebe en dispositivos reales a través de macOS
Ejecute sus pruebas en un iPhone físico o en un simulador iOS lanzado desde un Mac. Eso da una imagen precisa de cómo se comporta la aplicación firmada y protegida por sandbox, lo cual una sesión de depuración de Windows no puede reproducir.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.
