编程语言
首页 > 编程语言> > 你听我说-HandyControl源码编译

你听我说-HandyControl源码编译

作者:互联网

很荣幸小伙伴能看到这篇文章,这里是HandyControl在github上的传送门,同时附送一份基础的官方控件使用说明文档-github或者使用说明文档-码云,官方文档首页也是源码编译的基础引导,此文章算是对此的细化和补充

如果没有阅读HandyControl新手引导-CSDN或者HandyControl新手引导-博客园

话不多说,开始进行本篇博客的重点,通过源码编译HandyControl官方案例

blog-hbh-hc-view

下载源码项目

下载地址,途径如下:

所属平台 下载链接
Github[git] https://github.com/HandyOrg/HandyControl.git
Gitee[git] https://gitee.com/handyorg/HandyControl.git
Github[zip] https://github.com/HandyOrg/HandyControl/archive/refs/heads/master.zip
Gitee[zip] https://gitee.com/handyorg/HandyControl/repository/archive/master.zip

根据实际情况,选择是通过Github还是Gitee进行源码下载

当然本地需要安装git,用于克隆项目源码,压缩包方式下载也行,总之本地得有一份新鲜的源码项目

方式一、克隆

选择一个本地目录,cmd指令中进行git克隆,此处以Gitee为例

>git clone https://gitee.com/handyorg/HandyControl.git
Cloning into 'HandyControl'...
remote: Enumerating objects: 487, done.
remote: Counting objects: 100% (487/487), done.
remote: Compressing objects: 100% (304/304), done.
remote: Total 24957 (delta 314), reused 285 (delta 183), pack-reused 24470
Receiving objects: 100% (24957/24957), 49.44 MiB | 4.07 MiB/s, done.
Resolving deltas: 100% (17202/17202), done.

克隆完成后,打开目录HandyControl

blog-hbh-hc-github

方式二、下载

直接下载,此处以Gitee为例,本地下载文件为handyorg-HandyControl-master.zip,解压目录如下:

blog-hbh-hc-giteezip

编译项目

环境要求

由于项目本身是在.Net5 SDK的本地环境下开发,所以需要小伙伴本地已经安装.Net5 SDKVisual Studio 2019 16.x版本,否则项目将出现如下状况:

blog-hbh-hc-error

打开目录src中,启动解决方案HandyControl.sln,启动项目,初次加载会比较缓慢,需要依据项目中的包依赖,自动下载Nuget包到本地的包缓存目录,请耐心等待几分钟

项目结构

blog-hbh-hc-projecttree

Net_40文件夹下代表着支持Net Fx4.0的相关案例和程序集,HandyControlDemo_Net_40是对应的4.0的启动项目入口,本地需要安装.Net Framework4.0

Net_GE45文件夹针对.Net版本大于等于4.5,同理,包含Demo字样的项目为4.5版本本身及其以上的Fx版本、Core版本以及Net5

Shared文件目录下的项目是Net_40Net_GE45共通的依赖的相关共享项目源码辅助项目

源码编译

调整版本

由于项目几乎包含了从Fx4.0开始的所有Framework版本,Core以及Net版本,所有项目中的依赖项会比较多,编译源码项目,需要将当前并不需要的版本通过人工编辑项目.csproj内容方式进行处理,如果直接调试或者运行,是不会成功的,只会调试失败,提示本地缺少Framework某些版本未安装

需要编辑的项目如下:

blog-hbh-hc-editproject

带黄色小感叹不要慌,先截个图发个朋友圈,这其实是,本地缺少对应版本的framework的正常现象,双击项目本身,一般会看到如下内容:

原始

<PropertyGroup>
    .......
  <TargetFrameworks>netcoreapp3.0;netcoreapp3.1;net45;net451;net452;net46;net461;net462;net47;net471;net472;net48;net5.0-windows</TargetFrameworks>
    .......
</PropertyGroup>

删除后

<PropertyGroup>
    .......
  <TargetFrameworks>netcoreapp3.0;netcoreapp3.1;net45;net451;net452;net46;net461;net462;net471;net472;net48;net5.0-windows</TargetFrameworks>
    .......
</PropertyGroup>

将上图项目中的内容进行修改,删除<TargetFrameworks></TargetFrameworks>节点内本地不需要或者缺少的版本,本地需要的皆可以保留,此处作为演示,仅仅删除net471,记住一定是上图截图部分的所有项目,删除后重新生成项目重新生成解决方案,可以发现依赖项中的黄色感叹号已经消失

blog-hbh-hc-right

运行案例

选择目标的项目HandyControlDemo_Net_GE45或者HandyControlDemo_Net40运行项目,Debug调试运行即可

Build_Config

运行期间会添加注册表,为正常现象,选择允许,至此,案例项目就可以正常运行

blog-hbh-hc-run

本地生成类库包

选择模式为Release发布模式,重新生成项目,即可在项目中``

blog-hbh-hc-release

输出窗口内容如下:

blog-hbh-hc-output

去到对应目录可以看到相关生成的Release版本类库程序集

blog-hbh-hc-dll

至此,源码编译就算完成了,剩下的就是依据依据当前项目目标版本引用对应的HandyControl.dll版本

注意

不少资源并未包含在HandyControl.dll程序集中,如果小伙伴瞧得起对应案例的资源样式,可以考虑自己从案例中刨出去使用即可

后续将继续构建HandyControl的相关系列,有相关想法请关注公众号,进行留言:【HandyControl

公众号

标签:HandyControl,项目,编译,源码,版本,git,Net
来源: https://www.cnblogs.com/guanguanchangyu/p/15022410.html