Furion.Kit 5.0.0-preview.1.20240813.1

This is a prerelease version of Furion.Kit.
dotnet add package Furion.Kit --version 5.0.0-preview.1.20240813.1                
NuGet\Install-Package Furion.Kit -Version 5.0.0-preview.1.20240813.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Furion.Kit" Version="5.0.0-preview.1.20240813.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Furion.Kit --version 5.0.0-preview.1.20240813.1                
#r "nuget: Furion.Kit, 5.0.0-preview.1.20240813.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Furion.Kit as a Cake Addin
#addin nuget:?package=Furion.Kit&version=5.0.0-preview.1.20240813.1&prerelease

// Install Furion.Kit as a Cake Tool
#tool nuget:?package=Furion.Kit&version=5.0.0-preview.1.20240813.1&prerelease                

先知(v5)

一个应用程序框架,您可以将它集成到任何 .NET/C# 应用程序中。


新域名

过去 Furion 没有独立好记的域名,这一次我们出手了,以合理的交易价格购买下了 furion.net 域名。

域名寓意非常好 —— Furion 是基于 .NET 开发的基础框架,正是 furion + .net 的组合。

访问新官网(建设中):https://furion.net

项目背景

当前的 👉 Furion v4 版本已经逐步成熟且稳定,但仍存在以下问题:

  • 早期开发进展迅速,很多代码存在仓促上线的情况,缺乏充分思考和考虑
  • 所有模块都包含在一个项目中,无法按需加载和安装
  • 过度使用静态类和静态内存存储,不利于进行单元测试和数据隔离
  • 对于 .NET Core 的掌握程度有限,导致历史代码臃肿且高度耦合
  • 代码架构和设计模式缺乏统一性,可以说是一个大杂烩
  • 在早期对用户需求掌握不足,导致后期不断打补丁来进行改进,稍有改动就可能引发破坏性的修改
  • 模块、类型、属性、方法、属性等命名混乱,很难从字面上理解其功能含义
  • 模块功能封装过度,配置参数繁杂
  • 框架示例混乱,用户只能自行摸索最佳实践
  • 虽有单元测试,但是非常混乱

正是因为存在以上诸多问题,为了 Furion 能够长期发展,我们团队决定进行下一版本(v5)开发。

技术选择

Furion v5 版本采用 C# 12 和 .NET 8 进行开发。

开发团队

百小僧、百签科技(广东)有限公司

设计指导

  • 计划和分析: 在开始编写代码之前,仔细规划和分析整个框架的需求和功能。确定好核心功能和结构,以及可能的扩展和变化。这样可以减少后续的重构工作。
  • 模块化设计: 将整个框架划分为多个独立的模块,每个模块负责一个特定的功能。这样可以降低代码间的依赖性,方便后续的修改和调整。
  • 接口设计: 设计清晰的接口和抽象层,以便将来的修改不会对其他模块产生过多的影响。好的接口设计可以提高代码的可维护性和可扩展性。
  • 设计模式: 使用合适的设计模式来解决常见的问题,例如单例模式、观察者模式、策略模式等。这些设计模式可以提供灵活性和可扩展性,减少需要重构的风险。
  • 自动化测试: 在开发过程中编写充分的自动化测试,覆盖各个模块的功能和边界情况。这样可以及早发现问题,并减少在重构时引入新的错误。
  • 审查和反馈: 定期进行代码审查,并及时处理同事和用户的反馈意见。这有助于发现问题和改进,避免重复的重构工作。
  • 持续集成: 将代码集成到一个持续集成系统中,并在每次提交代码时运行自动化测试。这可以及时发现潜在的问题,避免代码质量下降。

框架目标

  • 实现完全无第三方依赖(除微软官方提供外)
  • 实现彻底模块化,每个模块都是独立的项目
  • 每个模块的单元测试覆盖率要达到 92% 以上
  • 确保每个类型、属性、字段、方法都有详细的注释
  • 尽可能避免使用静态内存存储
  • 所有模块都采用上下文和构建器模式进行设计
  • 所有模块都采用依赖注入/控制反转的设计模式
  • 所有模块都采用约定大于配置设计原则
  • 尽可能为每个模块提供看板功能
  • 提供所有模块最佳实践示例
  • 提供所有模块详细使用文档和 API 文档

模块状态

模块名称 状态 单元测试 版本 文档
Furion.Core nuget ⚠️
Furion.DependencyInjection nuget ⚠️
Furion.DependencyInjection.AspNetCore nuget ⚠️
Furion.DependencyInjection.Hosting nuget ⚠️
Furion.DependencyInjection.Named nuget ⚠️
Furion.DependencyInjection.TypeScanning nuget ⚠️
Furion.Component nuget ⚠️
Furion.Component.AspNetCore nuget ⚠️
Furion.Component.Hosting nuget ⚠️
Furion.Configuration nuget ⚠️
Furion.Configuration.FileScanning nuget ⚠️
Furion.Configuration.ManifestResource nuget ⚠️
Furion.Configuration.Remoted nuget ⚠️
Furion.Validation nuget ⚠️
Furion.Validation.AspNetCore nuget ⚠️
Furion.Validation.Fluent nuget ⚠️
Furion.Exception nuget ⚠️
Furion.Exception.AspNetCore nuget ⚠️
Furion.Exception.RescuePolicy nuget ⚠️
Furion.Kit nuget ⚠️
Furion.OpenApi ⚠️
Furion.Logging ⚠️
Furion.Logging.AspNetCore ⚠️
Furion.Logging.Console ⚠️
Furion.Logging.File ⚠️

状态说明

图标 描述
⚠️ 待定
进行中
完成
💔 随时抛弃

协议

Furion 采用 MIT 开源协议。

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.