[Unity 6] 安裝 NuGet 套件

2025.03.17 / Unity 引擎
NuGet 是一個開源的套件管理系統,它專門用於 C#,且擁有豐富的資源,包括大名鼎鼎的 Newtonesoft.Json 和 Microsoft.OpenApi、Serial.IO.Ports、MySQL 等常用功能。Unity 作為以 C# 設計的遊戲引擎,自然也支援 NuGet 的套件,但由於架構的關係,使用上還是受到了些限制。本文的主題是說明如何在 Unity 上快速的導入 NuGet 套件,需要使用到 OpenUPM 服務與 NuGetForUnity 工具。

新增 OpenUPM 套件庫

首先,前往 NuGetForUnity 的 OpenUPM 網頁,點擊網頁右上角的 Manual installation 按鈕。

複製下圖紅匡處的內容,並填寫至 Unity 的 Project Settings > Package Manager > Scoped Registries。

安裝 NuGetForUnity

開啟 Package Manager,切換到 My Registries 下的 package.openupm.com,選擇 NuGetForUnity 套件並安裝。

安裝需要的 NuGet 套件

安裝好 NuGetForUnity 後,即可開始安裝我們所需的 NuGet 套件。由於 Unity 引擎只支援 .NET Standard 與 .NET Framework 4,在安裝之前先前往 NuGet 網站 搜尋要安裝的套件,並確保它有支援這兩個架構。

如果發現它不支援我們要的架構,可以試著從 Versions 頁面來切換套件版本,通常版本號碼開頭為 4 或 2 的套件都可以安裝,最後請將可用的版本號碼記錄下來。

回到 Unity,從頂部選單 > NuGet > Manager NuGet Packages 開啟 NuGet 套件管理器,搜尋你想要安裝的套件,切換右邊的版本 (Versions),再點擊 Install 來安裝。

如果架構、版本都沒問題,但在使用上仍然會出錯,那極大可能的原因是這個套件有用到複雜的執行緒、過新的 C# 語法或 Mono 架構不支援的功能,簡單來說 Mono 就是為了實現跨平台而閹割過的 .NET 架構,而 Unity 又再閹割了一次,所以常有相容性問題。

可以自行嘗試解看看,如果仍然不可用,可能得放棄,又或者另外寫 .NET Console 之類的來與 Unity 通訊。

相關文章

Ted Liou

雲科碩士在讀中,專注於 Unity C#、TouchDesigner 技術,常把技術筆記分享到部落格,偶爾還直接挪用文章來當教材的研究生。