Misturando Versões Principais do IronPDF, IronOCR e IronBarcode
Uma pergunta comum é se você pode referenciar diferentes versões principais dos produtos Iron Software no mesmo projeto, por exemplo IronPDF v2025.x ao lado de IronOCR v2024.x e IronBarcode v2023.x. Você não pode. Combinar diferentes versões principais dos produtos Iron Software lado a lado em um único projeto não é suportado.
Por Que Falha
Cada produto Iron Software é construído em uma arquitetura interna compartilhada, e seus assemblies e dependências estão alinhados por versão em toda a suite. Cada produto assume compatibilidade apenas com outros produtos da mesma versão principal, então misturar versões pode expor vários problemas:
- Conflitos de binding de assembly
- Erros de runtime
- Comportamento inesperado
As bibliotecas são projetadas para funcionar juntas como uma suite, não como pacotes versionados de forma independente.
Solução
Use a mesma versão mensal de cada biblioteca Iron Software em um projeto. Um conjunto corretamente alinhado parece assim:
IronPDF v2025.5.x
IronOCR v2025.5.x
IronBarcode v2025.5.x
Se seu projeto já fixou versões incompatíveis e você deseja alinhá-las:
- Atualize através do NuGet: traga cada biblioteca Iron Software para a mesma versão mensal.
- Revise as alterações primeiro: verifique o changelog e qualquer diferença de API entre versões antes de atualizar, para que um aumento de versão não quebre chamadas existentes.

