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.

Questions Fréquemment Posées

Quelles sont les conditions préalables pour utiliser IronWord sur macOS?

Pour utiliser IronWord sur macOS, assurez-vous d'avoir installé .NET 6 ou .NET 7 SDK, Homebrew et macOS 11 (Big Sur) ou version ultérieure. IronWord est compatible avec les Mac Apple Silicon et Intel.

Comment installer les dépendances nécessaires pour IronWord sur macOS?

Vous pouvez installer la dépendance native requise, libgdiplus, en utilisant Homebrew avec la commande 'brew install mono-libgdiplus'. Cela aide pour les opérations graphiques telles que le rendu et le traitement de contenu DOCX.

IronWord est-il compatible avec les puces Apple Silicon?

Oui, IronWord est entièrement compatible avec les puces Apple Silicon, telles que celles des machines M1 et M2. Vous pouvez utiliser le même package NuGet IronWord et les instructions de configuration que pour les Macs Intel.

Que dois-je faire si je rencontre des erreurs liées à System.Drawing.Common?

De telles erreurs indiquent généralement une dépendance manquante. Assurez-vous d'avoir installé libgdiplus en utilisant Homebrew, car il est nécessaire pour les opérations graphiques dans IronWord.

Quels environnements de développement sont recommandés pour utiliser IronWord sur macOS?

IronWord peut être utilisé avec Visual Studio pour Mac et JetBrains Rider. Pour une meilleure compatibilité, assurez-vous de viser .NET 6 ou supérieur.

Ai-je besoin de Microsoft Office installé pour utiliser IronWord?

Non, IronWord vous permet de lire, créer et manipuler des documents Word en C# sans nécessiter que Microsoft Office soit installé sur votre système.

IronWord peut-il être utilisé dans des environnements autres que macOS?

Oui, bien que ce guide se concentre sur macOS, IronWord est également conçu pour fonctionner sur des environnements Windows et Linux.

Quel package NuGet dois-je installer pour IronWord sur macOS?

Pour la plupart des utilisateurs, nous recommandons d'installer le package NuGet standard IronWord, qui supporte à la fois les Macs Apple Silicon et Intel.

Quelles versions de .NET IronWord supporte-t-il sur macOS?

IronWord fonctionne mieux avec les versions LTS de .NET Core ou les derniers SDK .NET, garantissant des performances et une compatibilité optimales.

Kye Stuart
Rédacteur technique

Kye Stuart fusionne la passion du codage et l'habileté rédactionnelle chez Iron Software. Éduqué au Yoobee College en déploiement de logiciels, ils transforment maintenant des concepts technologiques complexes en contenu éducatif clair. Kye valorise l'apprentissage tout au long de la vie et relève de nouveaux dé...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 25,807 | Version : 2025.11 vient de sortir