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
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#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
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
先知(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 | ✅ | ✅ | ⚠️ | |
Furion.DependencyInjection | ✅ | ✅ | ⚠️ | |
Furion.DependencyInjection.AspNetCore | ✅ | ✅ | ⚠️ | |
Furion.DependencyInjection.Hosting | ✅ | ✅ | ⚠️ | |
Furion.DependencyInjection.Named | ✅ | ✅ | ⚠️ | |
Furion.DependencyInjection.TypeScanning | ✅ | ✅ | ⚠️ | |
Furion.Component | ✅ | ✅ | ⚠️ | |
Furion.Component.AspNetCore | ✅ | ✅ | ⚠️ | |
Furion.Component.Hosting | ✅ | ✅ | ⚠️ | |
Furion.Configuration | ✅ | ✅ | ⚠️ | |
Furion.Configuration.FileScanning | ✅ | ✅ | ⚠️ | |
Furion.Configuration.ManifestResource | ✅ | ✅ | ⚠️ | |
Furion.Configuration.Remoted | ✅ | ✅ | ⚠️ | |
Furion.Validation | ✅ | ✅ | ⚠️ | |
Furion.Validation.AspNetCore | ✅ | ✅ | ⚠️ | |
Furion.Validation.Fluent | ✅ | ✅ | ⚠️ | |
Furion.Exception | ✅ | ✅ | ⚠️ | |
Furion.Exception.AspNetCore | ✅ | ✅ | ⚠️ | |
Furion.Exception.RescuePolicy | ✅ | ✅ | ⚠️ | |
Furion.Kit | ✅ | ✅ | ⚠️ | |
Furion.OpenApi | ⏳ | ⏳ | ⚠️ | |
Furion.Logging | ⏳ | ⏳ | ⚠️ | |
Furion.Logging.AspNetCore | ⏳ | ⏳ | ⚠️ | |
Furion.Logging.Console | ⏳ | ⏳ | ⚠️ | |
Furion.Logging.File | ⏳ | ⏳ | ⚠️ |
状态说明
图标 描述 ⚠️ 待定 ⏳ 进行中 ✅ 完成 💔 随时抛弃
协议
Product | Versions 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.
-
net9.0
- Furion.AspNetCore (>= 5.0.0-preview.1.20240813.1)
- Furion.Configuration (>= 5.0.0-preview.1.20240813.1)
- Furion.Exception (>= 5.0.0-preview.1.20240813.1)
- Furion.OpenApi (>= 5.0.0-preview.1.20240813.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
5.0.0-preview.1.20240813.1 | 36 | 8/13/2024 |
5.0.0-preview.1.20231116.1 | 167 | 11/16/2023 |
5.0.0-preview.1.20230826.1 | 63 | 8/25/2023 |
5.0.0-preview.1.20230824.1 | 65 | 8/23/2023 |
5.0.0-preview.1.20230822.1 | 66 | 8/21/2023 |
5.0.0-preview.1.20230805.2 | 71 | 8/5/2023 |
5.0.0-preview.1.20230805.1 | 77 | 8/4/2023 |
5.0.0-preview.1.20230804.2 | 78 | 8/4/2023 |
5.0.0-preview.1.20230804.1 | 73 | 8/3/2023 |
5.0.0-preview.1.20230801.1 | 75 | 8/1/2023 |
5.0.0-preview.1.20230731.4 | 75 | 7/31/2023 |
5.0.0-preview.1.20230731.3 | 70 | 7/31/2023 |
5.0.0-preview.1.20230731.2 | 73 | 7/30/2023 |
5.0.0-preview.1.20230731.1 | 73 | 7/30/2023 |
5.0.0-preview.1.20230730.1 | 74 | 7/29/2023 |
5.0.0-preview.1.20230729.1 | 67 | 7/28/2023 |
5.0.0-preview.1.20230728.2 | 75 | 7/28/2023 |
5.0.0-preview.1.20230728.1 | 75 | 7/27/2023 |
5.0.0-preview.1.20230727.1 | 78 | 7/27/2023 |
5.0.0-preview.1.20230726.1 | 72 | 7/26/2023 |