文件可以在 https://docs.discordnet.dev/index.html 找到
Discord.Net 是一個獲得麻省理工學院許可的開源項目,其開發完全由志工完成。如果您想在經濟上支持我們的努力,請考慮:
我們的穩定版本可透過 Discord.Net 元包從 NuGet 取得:
各個元件也可以從 NuGet 安裝:
網路鉤子
文字命令和互動服務。
完整的 API 覆蓋。
API 核心。僅實現實體和準系統功能。
Nightlies 是 Discord.NET 的版本,仍處於實驗階段,尚未發布。
它們可以透過 2 個不同的來源獲得:
筆記
GitHub Packages 需要身份驗證。您可以在這裡找到更多資訊。
.NET Core 1.1 在 Win7 及更早版本上不支援 WebSocket。自 .NET Core 2.1 發布以來,此問題已修復。如果您希望在舊平台上執行機器人,建議您的專案以 .NET Core 2.1 或更高版本為目標;或者,您可以選擇安裝 Discord.Net.Providers.WS4Net 套件。
自 2022 年 7 月 19 日起,Discord 在其所有網站(包括 API)上僅支援 TLS1.2+。 .NET Framework 預設不支援此協定。如果您依賴 .NET Framework,建議將您的專案升級到net6-windows
。該框架支援 fx 引入的大多數僅限 Windows 的功能,並解決了 TLS 協定不匹配導致的啟動錯誤。
該庫通常遵守語義版本控制。軟體包以MAJOR.MINOR.PATCH
版本格式發布。
PATCH組件的增量始終表示進行了僅限內部的更改,通常是錯誤修復。這些變更不會以任何方式影響面向公眾的 API,並且始終保證與您的程式碼庫以及程式碼庫的任何預編譯依賴項向前和向後相容。
MINOR元件的增加表示對庫進行了一些添加,並且此添加與先前的版本不向後相容。但是,Discord.Net不保證少量添加的前向相容性。換句話說,我們允許在次要版本升級上進行有限的破壞性更改。
由於 Discord API 的性質,我們經常需要向實體添加屬性以支援最新的 API 變更。 Discord.Net 提供介面作為消費實體的方法;因此,向實體引入新字段在技術上是一個突破性的變化。主要版本升級通常表明對庫進行了一些重大更改,因此我們對於為庫中的每個次要添加添加主要版本猶豫不決。為了妥協,我們決定介面應僅被視為可使用的,並且您的應用程式通常不應實作介面。
對於實作介面的應用程式(例如在測試模擬中),我們對與 SemVer 的不一致表示歉意。
雖然我們永遠不會在較小的建置中破壞 API(除了介面變更之外),但我們偶爾需要透過向方法引入參數來與 Discord 匹配上游的變更來破壞 ABI。因此,次要版本增量可能需要您重新編譯程式碼,而依賴項(例如外掛程式)也可能需要在新版本上重新編譯和重新發布。當進行二進位重大變更時,該變更將在發行說明中註明。
MAJOR組件的增加表示對庫進行了重大更改;消費者應檢查發行說明以確定需要進行哪些變更。
按照 Major.Minor 發布分支。發布後,補丁將被推送到這些分支。新的 NuGet 版本將會在這些分支上標記。
開發分支,可在 MyGet 上找到。此分支是拉取請求的目標。
針對 Dev 的分支,新增功能。請隨意探索這些分支並在必要時提供回饋。
通常針對開發人員。這些分支用於使用新功能或現有功能返工來更新文件。