Getting Started with IronWord on macOS

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronWord allows .NET developers to read, create, and manipulate Word documents in C# without requiring Microsoft Office installed. While it’s typically used in Windows and Linux environments, IronWord also runs well on macOS with the right setup.

This guide walks you through installing dependencies and getting IronWord working in your macOS development environment.

Prerequisites for macOS

Before getting started with IronWord on macOS, make sure you have the following installed:

IronWord works best with .NET Core LTS versions or later .NET SDKs.

Install Native macOS Dependencies

IronWord depends on libgdiplus for graphical operations, such as rendering and processing DOCX content.

You can install this dependency using Homebrew:

brew install mono-libgdiplus

This installs the required native image rendering library. If you get errors related to System.Drawing.Common, this is usually the missing dependency.

NuGet Package Installation

IronWord works on both Apple Silicon and Intel Macs. We recommend the standard IronWord package for most users.

Install-Package IronWord

Compatibility with macOS ARM

IronWord is fully compatible with Apple Silicon chips. Developers using M1 or M2 machines can use the same IronWord NuGet package and setup instructions.

If you're using Visual Studio for Mac or JetBrains Rider, ensure you're targeting .NET 6 or higher for best compatibility.

Preguntas Frecuentes

¿Cuáles son los requisitos previos para usar IronWord en macOS?

Para usar IronWord en macOS, asegúrate de tener instalados .NET 6 o .NET 7 SDK, Homebrew y macOS 11 (Big Sur) o posterior. IronWord es compatible tanto con Macs Apple Silicon como Intel.

¿Cómo instalo las dependencias necesarias para IronWord en macOS?

Puedes instalar la dependencia nativa requerida, libgdiplus, usando Homebrew con el comando 'brew install mono-libgdiplus'. Esto ayuda con operaciones gráficas como renderización y procesamiento de contenido DOCX.

¿Es IronWord compatible con los chips Apple Silicon?

Sí, IronWord es completamente compatible con los chips Apple Silicon, como los de las máquinas M1 y M2. Puedes usar el mismo paquete NuGet de IronWord e instrucciones de configuración que para Macs Intel.

¿Qué debo hacer si encuentro errores relacionados con System.Drawing.Common?

Tales errores generalmente indican una dependencia faltante. Asegúrate de haber instalado libgdiplus usando Homebrew, ya que es necesario para operaciones gráficas en IronWord.

¿Qué entornos de desarrollo se recomiendan para usar IronWord en macOS?

IronWord se puede usar con Visual Studio para Mac y JetBrains Rider. Para la mejor compatibilidad, asegúrate de estar apuntando a .NET 6 o superior.

¿Necesito tener Microsoft Office instalado para usar IronWord?

No, IronWord te permite leer, crear y manipular documentos de Word en C# sin necesidad de tener instalado Microsoft Office en tu sistema.

¿Puede usarse IronWord en entornos distintos a macOS?

Sí, aunque esta guía se centra en macOS, IronWord también está diseñado para funcionar en entornos Windows y Linux.

¿Qué paquete NuGet debo instalar para IronWord en macOS?

Para la mayoría de los usuarios, recomendamos instalar el paquete estándar de IronWord NuGet, que es compatible con Macs Apple Silicon e Intel.

¿Qué versiones de .NET soporta IronWord en macOS?

IronWord funciona mejor con versiones LTS de .NET Core o SDKs de .NET más recientes, asegurando un rendimiento y compatibilidad óptimos.

Kye Stuart
Escritor Técnico

Kye Stuart fusiona la pasión por la codificación y la habilidad para escribir en Iron Software. Educado en Yoobee College en despliegue de software, ahora transforma conceptos tecnológicos complejos en contenido educativo claro. Kye valora el aprendizaje continuo y acepta nuevos desafíos tecnológicos.

<...
Leer más
¿Listo para empezar?
Nuget Descargas 25,807 | Versión: 2025.11 recién lanzado