共用方式為


建立 NuGet 的新多平台連結庫

建立使用 PCL 或 .NET Standard 的多平台連結庫專案,表示產生的 NuGet 可以新增至任何支援目標設定檔的 .NET 專案,包括 ASP.NET 專案,或使用 WinForms、WPF 或 UWP 的桌面應用程式。

連結庫只能包含所選 PCL 或 .NET Standard 配置檔所支援的程式代碼,以及新增的任何其他 NuGet。 這適用於可完全以 .NET 基類連結庫表示的商業規則和演算法。

單一元件會建立並內建於 NuGet 套件中。

如果您稍後需要平臺特定功能, 則可以新增平臺特定專案。

建立多平台連結庫 NuGet 的步驟

  1. 選取 [ 檔案 > 新方案] (或以滑鼠右鍵按兩下現有的方案 ,然後選擇 [ 新增 > 專案]。

  2. [多平台連結庫] 區段選擇 [多平台>連結庫]:

    Screenshot shows Choose a template with Multiplatform Library selected.

  3. 輸入 [名稱] 和 [描述],併為所有平台選擇 [單一]:

    Screenshot shows values entered for Name, Description, and Implementation.

  4. 完成精靈。 方案中會建立單一連結庫專案。

  5. 以滑鼠右鍵按下新的連結庫專案,然後選取 [ 選項]。 [建>置一般] 區段允許設定目標 Framework – 選擇 .NET 可攜式 PCL 配置檔或 .NET Standard 版本:

    Choose PCL or .NET Standard for library type

  6. 此外,在 [ 項目選項 ] 視窗中,開啟 [NuGet 套件 > 元數據 ] 區段並輸入 必要的元數據 (以及任何選擇性元數據):

    Enter required metadata

  7. 以滑鼠右鍵按兩下連結庫專案,然後選擇 [建立 NuGet 套件 ](或建置或部署方案), 並將 .nupkg NuGet 套件檔案儲存在 /bin/ 資料夾中(視組態而定):

    The NuGet package file will be saved in the bin folder either Debug or Release, depending on configuration

驗證輸出

NuGet 套件也是 ZIP 檔案,因此可以檢查所產生套件的內部結構。

此螢幕快照顯示 PCL 型 NuGet 的內容 – 只包含單一 PCL 元件:

Files contained in the NuGet package

新增平臺特定程序代碼

PCL 型專案和 .NET Standard 型專案不能包含平臺特定參考(例如 iOS 或 Android 功能)。

如果現有的 PCL 專案或 .NET Standard 專案需要展開以包含平臺特定程式代碼,則可以在專案上按下滑鼠右鍵,然後選取 [新增 > 平臺實作...] 來完成:

Add platform implementation menu

您可以將一或多個平台專案新增至方案,而現有的 PCL 或 .NET Standard 連結庫可以選擇性地轉換成共用專案:

Add platform options such as iOS, Android, and Shared Project

轉換成共用項目之後,請流覽 [項目選項 > ][NuGet 套件 > 參考元件] 區段 ,並確定已選取任何必要的配置檔(讓 NuGet 繼續與先前使用的專案相容)。