# Depurando Apps iOS com Bibliotecas Nativas no Windows
Depurando um aplicativo iOS .NET MAUI a partir de uma máquina Windows falha ao carregar bibliotecas nativas de terceiros como IronOCR. O aplicativo pode ser lançado em um iPhone conectado, mas o código nativo Tesseract do qual o IronOCR depende não é implantado corretamente.
```txt
Failed to locate 'libtesseract.5'...
Access to the path ... is denied.
```
A causa é o modelo de desenvolvimento rigidamente controlado da Apple. Aplicativos iOS devem ser **assinado** com um certificado Apple Developer válido, bibliotecas nativas devem ser **compiladas para ARM64** e vinculadas através de ferramentas Apple, e aplicativos executados sob **sandboxing estrito** que restringe o acesso ao sistema de arquivos em tempo de execução. As ferramentas da Apple (`Xcode`, `codesign`, `lipo`) executam apenas em macOS, então uma máquina Windows não pode empacotar ou assinar a biblioteca nativa completamente. Quando você depura a partir do Windows, o binário Tesseract acaba faltando, sem assinatura ou bloqueado pela sandbox, produzindo os erros acima.
É por isso que a mesma base de código executa sem problemas em destinos Android ou Windows: essas plataformas carregam bibliotecas nativas sem os requisitos de assinatura da Apple, e o Tesseract agrupado do IronOCR funciona como esperado.
## Solução
### 1. Construa através de um Mac
Desenvolva diretamente no macOS, ou use a funcionalidade **Pair to Mac** do Visual Studio para descarregar as construções iOS para um Mac enquanto você codifica no Windows. Encaminhar a construção através da cadeia de ferramentas da Apple é a única maneira de a biblioteca nativa ser compilada e assinada corretamente.
### 2. Deixe o IronOCR implantar suas próprias bibliotecas
Não copie ou relocalize manualmente os arquivos de biblioteca nativa. O IronOCR lida com a implantação do Tesseract para você, e editar manualmente caminhos quebra o modelo de empacotamento iOS.
[[w:(Copiar manualmente bibliotecas nativas no iOS normalmente desencadeia os erros de acesso à sandbox acima. Deixe a implantação para o IronOCR a não ser que você compreenda completamente as regras de implantação da Apple.)]]
### 3. Teste em dispositivos reais via macOS
Execute seus testes em um iPhone físico ou um simulador iOS lançado de um Mac. Isso proporciona uma imagem precisa de como o aplicativo assinado e em sandbox se comporta, o que uma sessão de depuração no Windows não pode reproduzir.
Depurando um aplicativo iOS .NET MAUI a partir de uma máquina Windows falha ao carregar bibliotecas nativas de terceiros como IronOCR. O aplicativo pode ser lançado em um iPhone conectado, mas o código nativo Tesseract do qual o IronOCR depende não é implantado corretamente.
Failed to locate 'libtesseract.5'...Access to the path ... is denied.
Failed to locate 'libtesseract.5'...
Access to the path ... is denied.
Text
A causa é o modelo de desenvolvimento rigidamente controlado da Apple. Aplicativos iOS devem ser assinado com um certificado Apple Developer válido, bibliotecas nativas devem ser compiladas para ARM64 e vinculadas através de ferramentas Apple, e aplicativos executados sob sandboxing estrito que restringe o acesso ao sistema de arquivos em tempo de execução. As ferramentas da Apple (Xcode, codesign, lipo) executam apenas em macOS, então uma máquina Windows não pode empacotar ou assinar a biblioteca nativa completamente. Quando você depura a partir do Windows, o binário Tesseract acaba faltando, sem assinatura ou bloqueado pela sandbox, produzindo os erros acima.
É por isso que a mesma base de código executa sem problemas em destinos Android ou Windows: essas plataformas carregam bibliotecas nativas sem os requisitos de assinatura da Apple, e o Tesseract agrupado do IronOCR funciona como esperado.
Solução
1. Construa através de um Mac
Desenvolva diretamente no macOS, ou use a funcionalidade Pair to Mac do Visual Studio para descarregar as construções iOS para um Mac enquanto você codifica no Windows. Encaminhar a construção através da cadeia de ferramentas da Apple é a única maneira de a biblioteca nativa ser compilada e assinada corretamente.
2. Deixe o IronOCR implantar suas próprias bibliotecas
Não copie ou relocalize manualmente os arquivos de biblioteca nativa. O IronOCR lida com a implantação do Tesseract para você, e editar manualmente caminhos quebra o modelo de empacotamento iOS.
Aviso: Copiar manualmente bibliotecas nativas no iOS normalmente desencadeia os erros de acesso à sandbox acima. Deixe a implantação para o IronOCR a não ser que você compreenda completamente as regras de implantação da Apple.
3. Teste em dispositivos reais via macOS
Execute seus testes em um iPhone físico ou um simulador iOS lançado de um Mac. Isso proporciona uma imagem precisa de como o aplicativo assinado e em sandbox se comporta, o que uma sessão de depuração no Windows não pode reproduzir.
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
