在macOS上開始使用IronWord
IronWord讓.NET開發者能夠在C#中讀取、建立和操作Word文件,而不需要安裝Microsoft Office。 雖然它通常用於Windows和Linux環境中,但IronWord在正確的設置下,在macOS上也能良好運行。
本指南將引導您安裝依賴項並讓IronWord在您的macOS開發環境中運行。
macOS的先決條件
在macOS上開始使用IronWord之前,請確保您已安裝以下項目:
- .NET 6 or .NET 7 SDK
- Homebrew (macOS封包管理工具)
- macOS 11 (Big Sur)或更高版本 (支援Apple Silicon和Intel)
IronWord最適用於.NET Core LTS版本或更新的.NET SDK。
安裝原生macOS依賴項
IronWord依賴於libgdiplus進行圖形操作,比如渲染和處理DOCX內容。
您可以使用Homebrew安裝此依賴項:
brew install mono-libgdiplus
這將安裝所需的原生影像渲染庫。 如果您收到與System.Drawing.Common相關的錯誤,通常是缺失此依賴項。
NuGet封包安裝
IronWord可在Apple Silicon和Intel Mac上運行。 我們建議大多數使用者使用標準的IronWord封包。
Install-Package IronWord
與macOS ARM的相容性
IronWord完全相容Apple Silicon晶片。 使用M1或M2機型的開發者可以使用相同的IronWord NuGet封包和設置說明。
如果您使用的是Visual Studio for Mac或JetBrains Rider,請確保您以.NET 6或更高版本為目標以獲得最佳相容性。
常見問題
在macOS上使用IronWord的先決條件有哪些?
要在macOS上使用IronWord,請確保已安裝.NET 6或.NET 7 SDK,Homebrew和macOS 11(Big Sur)或更高版本。IronWord與Apple Silicon和Intel Mac均相容。
如何在macOS上安裝IronWord所需的依賴項?
您可以使用Homebrew安裝所需的本機依賴項libgdiplus,使用命令'brew install mono-libgdiplus'。這有助於圖形操作,例如渲染和處理DOCX內容。
IronWord是否與Apple Silicon晶片相容?
是的,IronWord完全相容於Apple Silicon晶片,如M1和M2機器中的晶片。您可以使用與Intel Mac相同的IronWord NuGet包和設置指令。
如果遇到System.Drawing.Common相關錯誤,我該怎麼辦?
這類錯誤通常表明缺少某個依賴項。請確保已使用Homebrew安裝libgdiplus,因為IronWord的圖形操作需要此項。
在macOS上使用IronWord建議使用哪些開發環境?
IronWord可以搭配Visual Studio for Mac和JetBrains Rider使用。為了最好地相容性,請確保目標於.NET 6或更高版本。
使用IronWord需要安裝Microsoft Office嗎?
不,IronWord允許您在不需要在系統中安裝Microsoft Office的情況下,使用C#讀取、建立和操作Word文件。
IronWord可以在macOS之外的環境中使用嗎?
可以,儘管本指南主要針對macOS,但IronWord亦旨在於Windows和Linux環境中運行。
應該為macOS上的IronWord安裝哪個NuGet包?
對於大部分使用者,我們建議安裝標準的IronWord NuGet包,它支持Apple Silicon和Intel Mac。
IronWord在macOS上支持哪些.NET版本?
IronWord在與.NET Core LTS版本或更高的.NET SDK運行時達到最佳性能和相容性。

