Primeiros passos com o IronWord no macOS
O IronWord permite que desenvolvedores .NET leiam, criem e manipulem documentos do Word em C# sem a necessidade de instalar o Microsoft Office. Embora seja normalmente usado em ambientes Windows e Linux, o IronWord também funciona bem no macOS com a configuração correta.
Este guia orienta você na instalação das dependências e na configuração do IronWord em seu ambiente de desenvolvimento macOS.
Pré-requisitos para macOS
Antes de começar a usar o IronWord no macOS, certifique-se de ter os seguintes programas instalados:
- SDK do .NET 6 ou .NET 7
- Homebrew (gerenciador de pacotes do macOS)
- macOS 11 (Big Sur) ou posterior (compatível com Apple Silicon e Intel)
O IronWord funciona melhor com versões LTS do .NET Core ou SDKs .NET posteriores.
Instalar dependências nativas do macOS
O IronWord depende da libgdiplus para operações gráficas, como renderização e processamento de conteúdo DOCX.
Você pode instalar essa dependência usando o Homebrew:
brew install mono-libgdiplus
Isso instala a biblioteca nativa de renderização de imagens necessária. Se você receber erros relacionados a System.Drawing.Common, geralmente essa é a dependência ausente.
Instalação de Pacotes NuGet
O IronWord funciona tanto em Macs com Apple Silicon quanto em Macs com Intel. Recomendamos o pacote IronWord padrão para a maioria dos usuários.
Install-Package IronWord
Compatibilidade com macOS ARM
IronWord é totalmente compatível com chips Apple Silicon. Os desenvolvedores que usam máquinas M1 ou M2 podem usar o mesmo pacote NuGet IronWord e as mesmas instruções de instalação.
Se você estiver usando o Visual Studio para Mac ou o JetBrains Rider, certifique-se de estar usando o .NET 6 ou superior para obter a melhor compatibilidade.
Perguntas frequentes
Quais são os pré-requisitos para usar o IronWord no macOS?
Para usar o IronWord no macOS, certifique-se de ter o SDK do .NET 6 ou .NET 7, o Homebrew e o macOS 11 (Big Sur) ou posterior instalados. O IronWord é compatível com Macs com Apple Silicon e com Macs Intel.
Como faço para instalar as dependências necessárias para o IronWord no macOS?
Você pode instalar a dependência nativa necessária, libgdiplus, usando o Homebrew com o comando 'brew install mono-libgdiplus'. Isso auxilia em operações gráficas como renderização e processamento de conteúdo DOCX.
O IronWord é compatível com chips Apple Silicon?
Sim, o IronWord é totalmente compatível com chips Apple Silicon, como os encontrados em máquinas com processadores M1 e M2. Você pode usar o mesmo pacote NuGet do IronWord e as mesmas instruções de instalação que usa para Macs com processadores Intel.
O que devo fazer se encontrar erros relacionados a System.Drawing.Common?
Esses erros geralmente indicam uma dependência ausente. Certifique-se de ter instalado o libgdiplus usando o Homebrew, pois ele é necessário para operações gráficas no IronWord.
Quais ambientes de desenvolvimento são recomendados para usar o IronWord no macOS?
O IronWord pode ser usado com o Visual Studio para Mac e o JetBrains Rider. Para melhor compatibilidade, certifique-se de estar usando o .NET 6 ou superior.
Preciso ter o Microsoft Office instalado para usar o IronWord?
Não, o IronWord permite ler, criar e manipular documentos do Word em C# sem a necessidade de ter o Microsoft Office instalado no sistema.
O IronWord pode ser usado em ambientes diferentes do macOS?
Sim, embora este guia se concentre no macOS, o IronWord também foi projetado para funcionar em ambientes Windows e Linux.
Qual pacote NuGet devo instalar para o IronWord no macOS?
Para a maioria dos usuários, recomendamos a instalação do pacote NuGet padrão do IronWord, que é compatível com Macs Apple Silicon e Intel.
Quais versões do .NET o IronWord suporta no macOS?
O IronWord funciona melhor com versões LTS do .NET Core ou SDKs .NET posteriores, garantindo desempenho e compatibilidade ideais.

