前言
nuget 是 .net 的常用包管理器,目前已經內置到 Visual Studio 2012 以后的版本,大多數 .net 包都托管在 nuget.org,包括 .net core 框架基礎包,得益于 .net core 的模塊化設計,很多非核心包都可以進行一定程度的獨立升級,
制作并上傳 nuget 包也同時成為為 .net 生態做貢獻的重要途經,因為 VS 2019 專案的 csproj 檔案支持大量與 nuget 打包相關的配置,所以大多數時候常規的 nuget 包都可以直接用 VS 制作,nuget.org 也只需要上傳生成的包檔案即可,十分方便,
正文
說明
在此以我上傳到 nuget.org 的包 CoreDX.vJoy.Wrapper 為例進行說明,這個包是一個虛擬游戲手柄驅動的 C# SDK 包裝,對應 .net core 3.0+ 平臺,如果要使用,需要先安裝 vJoy 軟體,下載地址:http://vjoystick.sourceforge.net/site/index.php/download-a-install/download,叫 vJoy 的軟體有好幾個,要注意,有些是用來做鍵盤映射模擬手柄的用戶軟體,這個是面向開發者的純編程控制的虛擬手柄,想做鍵盤映射得自己寫軟體,
基礎操作
1、新建類別庫專案,取名,然后一路下一步完成新建專案,
2、打開 csproj 檔案,調整類別庫的目標框架,一般情況下盡量使用 netstandard 框架,并盡量降低依賴版本保證兼容性,現在一般是 2.0 居多,早期版本的標準 API 缺失比較嚴重,也可以右鍵專案屬性進行調整,只不過自由度不如直接編輯專案檔案,不過,這些都不是重點,重點是如何同時支持多個框架,這個只能直接編輯專案檔案,找到 <TargetFramework>netstandard2.0</TargetFramework>,把 TargetFramework 改成 TargetFrameworks,并用分號隔開不同的框架名,比如我的專案中就是這樣:<TargetFrameworks>netcoreapp3.0;netcoreapp3.1</TargetFrameworks>,netcoreapp 也是可以輸出為類別庫的哦,在不同框架使用不同代碼實作功能時可以使用條件編譯宏解決,例如:#if NETCOREAPP3_1 xxx代碼 #endif #if NET461 xxx代碼 #endif,然后愉快地寫代碼,
3、右鍵專案屬性,找到打包選項卡,編輯 nuget 包資訊,比如包名、版本、作者、許可證、說明、著作權等等資訊,還有很多只能直接改專案檔案,大多數都可以在 <PropertyGroup> 節點下輸入 <Package,然后跳出來的智能提示就是能用的 nuget 包資訊節點,其中如果要上傳到 nuget.org,包名必須存在且不能與已有包重名;版本每次上傳都必須修改且只能更大;許可證必須指定,比如我的:<PackageLicenseExpression>MIT</PackageLicenseExpression> 指定了使用 MIT 許可證授權,
4、專案右鍵打包,注意如果是要上傳的正式版包,需要切換到發行模式再打包,
5、在瀏覽器打開 www.nuget.org,右上角登錄賬號,可以使用微軟賬號或 Github 賬號登錄,在頂部導航欄找到 Upload,上傳,包一般生成到 bin 檔案夾,上傳完成后會做一些校驗并展示預覽資訊,確認無誤后到底部點發布,等待網站進行安全檢查和索引創建,一般5到30分鐘,就可以在網站和 VS 中找到了,
擴展操作
像我的包,動態參考了 x86 和 x64 程式集,這些參考是在程式運行時動態加載的,也就是說 nuget 打包工具是不認識的,這些動態參考就不會被打包,等其他人安裝包就會出錯,檔案缺失,如果我要把這些檔案一起打包,需要編輯專案檔案,就像這樣:
<ItemGroup> <Content Include="x64\*.dll" Pack="true" PackageCopyToOutput="true" PackagePath="x64"> <CopyToOutputDirectory>Always</CopyToOutputDirectory> </Content> <Content Include="x86\*.dll" Pack="true" PackageCopyToOutput="true" PackagePath="x86"> <CopyToOutputDirectory>Always</CopyToOutputDirectory> </Content> <Content Include="CoreDX.vJoy.Wrapper.targets" Pack="true" PackageCopyToOutput="true" PackagePath="build/"> <CopyToOutputDirectory>Never</CopyToOutputDirectory> </Content> </ItemGroup>
其中 Pack="true" 表示要將 include 的檔案一起打包,PackageCopyToOutput="true" 表示要輸出到指定位置, PackagePath 表示把檔案輸出到包的指定檔案夾,因為 nuget 包實際上就是個 zip 壓縮檔案,
其中 .targets 是個特殊檔案,必須打包到 build 檔案夾才有用,如果不打包這個檔案,其他人安裝包后就會發現依然報錯,雖然包中確實有檔案,但并不會復制到專案中,targets 檔案就是負責告訴專案要怎么處理打包進去的額外檔案的,是個 xml 檔案,自己手動新建一個 xml 檔案修改擴展名就行,內容像這樣:
<?xml version="1.0" encoding="utf-8"?> <Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003"> <ItemGroup> <None Include="$(MSBuildThisFileDirectory)\..\x86\vJoyInterface.dll"> <Link>x86\vJoyInterface.dll</Link> <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory> </None> <None Include="$(MSBuildThisFileDirectory)\..\x86\vJoyInterfaceWrap.dll"> <Link>x86\vJoyInterfaceWrap.dll</Link> <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory> </None> <None Include="$(MSBuildThisFileDirectory)\..\x64\vJoyInterface.dll"> <Link>x64\vJoyInterface.dll</Link> <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory> </None> <None Include="$(MSBuildThisFileDirectory)\..\x64\vJoyInterfaceWrap.dll"> <Link>x64\vJoyInterfaceWrap.dll</Link> <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory> </None> </ItemGroup> </Project>
有了這個檔案,其他人安裝包后,專案會自動讀取這個檔案并把這些檔案參考到專案,確保其他人使用正常,
結語
本來這個東西只是自己寫著玩的,結果突發奇想去 nuget 找了一下發現沒有完善好用的類似的包,我就想要不上傳一個去 nuget 吧,結果就被這個動態參考的 dll 給坑了,打包以后這些 dll 沒有參考進來,百度找了半天也沒找到解決方案,也懶得搞梯子去谷歌,就直接去 GitHub 找了類似的開源專案原始碼研究他們是怎么搞的,試了半天才搞定,寫下這篇文章記錄下心路歷程,
這篇文章也算是.Net Core 為 x86 和 x64 程式集撰寫 AnyCPU 包裝的續集,
轉載請完整保留以下內容并在顯眼位置標注,未經授權洗掉以下內容進行轉載盜用的,保留追究法律責任的權利!
本文地址:https://www.cnblogs.com/coredx/p/12578978.html
完整源代碼:Github
里面有各種小東西,這只是其中之一,不嫌棄的話可以Star一下,
轉載請註明出處,本文鏈接:https://www.uj5u.com/net/50960.html
標籤:.NET Core
