avaloniaui項目離線開發全攻略:ide安裝、模板應用與nuget私有化部署一站式解決

avaloniaui項目離線開發全攻略:ide安裝、模板應用與nuget私有化部署一站式解決

本文將指導您如何在本地網絡環境中成功安裝並配置avaloniaui所需的工具和模板。

最后更新 2024/6/28 下午10:26
沙漠尽头的狼
预计阅读 6 分钟
分类
Avalonia UI
标签
.NET C# Avalonia UI NuGet

1. 引言

在網絡受限或完全離線的環境中開發.net項目(本文示例為avalonia ui項目),可能會遇到一些挑戰。本文將為您提供一套完整的離線開發解決方案,包括ide的安裝、avalonia ui模板的配置、私有化nuget服務的部署以及nuget包的製作和上傳等。

2. ide安裝指南

visual studio 2022安裝

visual studio 2022是微軟推出的最新ide,支持avalonia ui項目的開發。以下是詳細的離線安裝步驟:

  • 离线安装包制作:首先,根据网友 VS2022离线安装包 的指南,制作Visual Studio 2022的离线安装包。
  • Avalonia UI扩展安装:安装Visual Studio后,通过 Visual Studio Marketplace 下载并安装Avalonia for Visual Studio 2022扩展。

  • 安裝過程中遇到失敗

根据微信群内@rabbitism的解答(感谢@daidai_cn的帮助),我们可以通过解压该扩展文件,删除下图框选的Extension.vsext文件后再进行安装:

正常安裝了:

jetbrains rider安裝

JetBrains Rider IDE在2020.3版本中开始内置支持Avalonia XAML,包括对Avalonia特定XAML功能和自定义代码检查的一流支持。

离线安装包下载地址:下载 Rider:跨平台 .NET IDE (jetbrains.com)

3. 安裝avalonia ui模板

在线安装请参考文档 Avalonia Docs,离线安装请点击 Avalonia.Templates 下载:

安装方式同上图.NET CLI命令脚本:

dotnet new install avalonia.templates.11.0.10.1.nupkg

現在,無論是在visual studio還是jetbrains rider中,您都可以使用avalonia ui模板來創建新項目了。

vs 2022中avalonia ui模板:

rider中使用模板:

4. 私有化部署nuget服務

創建好項目後,程式也是無法正常運行的,默認模板依賴avalonia ui的一些nuget包,需要在線安裝,可以直接把相關庫拷貝到內網,但一個一個拷貝、引用還是很麻煩。

为了方便团队内部成员之间共享和管理NuGet包,您可以考虑部署私有NuGet服务。本文推荐使用BaGet作为轻量级的NuGet服务器,参考该BaGet项目说明

  1. 安装 .NET Core 3.1 SDK,该程序能支持的.NET最新版本,有兴趣可以Clone修改成.NET 8\9(PR中有惊喜,网友有PR升级分支);
  2. 下载最新版的Release压缩包 Releases · loic-sharma/BaGet
  3. 运行服务dotnet BaGet.dll
  4. 浏览器打开http://localhost:5000访问:

ok,這就算部署完成了。

5. nuget包製作(可略)

网上教程较多,可简单配置库的工程文件支持NuGet包生成,参考CodeWF.EventBus

<Project>
	<PropertyGroup>
		<Company>https://codewf.com</Company>
		<Authors>沙漠尽头的狼</Authors>
		<Owners>https://codewf.com</Owners>
		<AssemblyVersion>$(Version)</AssemblyVersion>
		<FileVersion>$(Version)</FileVersion>
		<Version>$(Version)</Version>
		<Description>通过 CodeWF.EventBus 提供的 事件总线,我们可以很轻松的实现 CQRS 模式。根据业务需求,我们可以创建并维护读模型,将读操作和写操作进行分离,从而提高应用程序的可扩展性和性能。可在各种模板项目使用:WPF、Winform、AvaloniaUI、ASP.NET Core等。The CodeWF.EventBus allows us to easily implement the CQRS mode. According to business requirements, we can create and maintain a read model to separate read and write operations, thereby improving the scalability and performance of the application. Can be used in various template projects: WPF, Winform, AvaloniaUI, ASP. NET Core, etc.</Description>
		<ApplicationIcon>Resources\logo.ico</ApplicationIcon>
		<GeneratePackageOnBuild>True</GeneratePackageOnBuild>
		<Title>$(AssemblyName)</Title>
		<Copyright>Copyright © https://codewf.com 2024</Copyright>
		<AssemblyName>$(AssemblyName)</AssemblyName>
		<RootNamespace>$(AssemblyName)</RootNamespace>
		<PackageId>$(AssemblyName)</PackageId>
		<PackageTags>C# EventBus; WPF; Winform; AvaloniaUI,ASP.NET Core;</PackageTags>
		<PackageIcon>logo.png</PackageIcon>
		<PackageProjectUrl>https://github.com/dotnet9/CodeWF.EventBus</PackageProjectUrl>
		<RepositoryUrl>https://github.com/dotnet9/CodeWF.EventBus</RepositoryUrl>
	</PropertyGroup>
	<ItemGroup>
		<None Include="Resources\logo.png">
			<Pack>True</Pack>
			<PackagePath>\</PackagePath>
		</None>
	</ItemGroup>
</Project>

生成庫工程時就會生成相應的nuget文件,這裡是已經發布的nuget包地址:https://www.nuget.org/packages/CodeWF.EventBus

6. nuget包上傳

可以上传自己制作的NuGet包,也可以上传从 NuGet官网 或第三方获得的NuGet包。

我们打开自己部署的NuGet首页http://localhost:5000:

点击Upload a package,切换到NuGet包上传命令说明:

我们以.NET CLI上传NuGet包举例,首先准备NuGet文件,比如从NuGet官网搜索下载Avalonia UI的基础包:

下載好以後,在當前下載目錄打開cmd命令行輸入:

dotnet nuget push -s http://localhost:5000/v3/index.json avalonia.11.1.0-rc1.nupkg

上面提示NuGet服务配置了密钥,我们为了简单,先停止NuGet服务,打开它的配置文件appsettings.json,清空ApiKey节点值,再运行NuGet服务:

再執行上傳命令,現在成功了:

nuget首頁也能搜索到了:

7. ide配置nuget源

复制前面NuGet上传页面图中红色字体的URL地址:http://localhost:5000/v3/index.json, 在VS中配置NuGet搜索地址:

剩下的就和平時安裝包一致了。

小知识:个人临时开发可将上面的源配置为本地NuGet目录路径。

8. 總結

本文居間了如何在本地網絡環境中成功安裝並配置avaloniaui所需的開發工具和模板,以及如何部署私有nuget服務並製作及上傳nuget包以便團隊內部成員之間共享和管理nuget包。

希望這些信息能對您的avaloniaui項目開發有所幫助。如有其他問題,歡迎隨時向我提問。

Keep Exploring

延伸阅读

更多文章