lulianqi opened a new issue, #11:
URL: https://github.com/apache/dubbo-net/issues/11

   目前 DubboNet 核心库仅提供 net10.0 目标,测试、示例和 CI 也使用 .NET 10。
   使用现代 SDK 和受支持运行时进行开发、测试是合理的,但可复用类库的最低兼容目标,不必与开发工具及测试运行时完全一致。
   希望为核心库提供可实际使用的 netstandard2.0 兼容目标,降低使用者接入 Dubbo 的门槛,同时继续使用 .NET 10 
SDK、测试运行时和 CI。
   
   **必要性与收益**
   
   1. 避免接入一个客户端库就必须升级整个应用。
      仅提供 net10.0 会限制其他目标框架的应用直接引用。提供兼容目标,可以让应用按自身节奏升级运行时。
   2. 扩大跨语言调用的适用范围。
      DubboNet 的价值在于帮助 .NET 应用接入 Java/Dubbo 服务,核心客户端应尽量减少与特定宿主框架版本的绑定。
   3. 为既有 .NET Framework 应用保留接入可能。
      .NET Standard 2.0 是 .NET Framework 支持的最后一个 .NET Standard 版本;2.1 
不能覆盖该场景。不过,实际支持范围仍须结合依赖、操作系统和传输行为验证,不能仅凭 TFM 
承诺兼容。[微软说明](https://learn.microsoft.com/en-us/dotnet/standard/net-standard)
   4. 区分兼容性与维护策略。
      提供较低的类库 API 基线,不意味着使用过时 SDK,也不意味着承诺维护所有已结束支持的宿主运行时。
   
   **合理性与初步评估**
   
   DubboNet 的主要职责是协议通信、编解码、服务发现、元数据处理和负载均衡,并非必须依赖 .NET 10 
应用模型的程序,因此值得评估更广泛的兼容目标。
   初步检查发现,当前三个直接依赖均提供 netstandard2.0 资产:
   - DistributedLock.ZooKeeper
   - nacos-sdk-csharp
   - NHessian
   但这不代表已经证明完整可行。仍需检查传递依赖、不同目标下选择的包版本,以及网络传输在实际运行时上的行为。
   当前源码也使用了许多需要适配的现代 API,例如:
   - Task.WaitAsync
   - Random.Shared / NextInt64
   - ReferenceEqualityComparer
   - SocketsHttpHandler
   - 带取消令牌的 HTTP 正文读取
   - Socket/Stream 的部分 Memory<T> 异步重载
   
   
   **验收标准**
   
   - [ ] NuGet 包包含可被消费项目正常引用的 lib/netstandard2.0 资产。
   - [ ] 完成 API、直接依赖和传递依赖审计,记录兼容边界。
   - [ ] 使用测试宿主实际加载并运行 netstandard2.0 产物,避免多目标工程默认选中 net10.0 而漏测。
   - [ ] 现有测试持续通过,不通过删除或跳过测试使迁移达标。
   - [ ] 超时、取消、资源释放、连接复用和安全防护不退化。
   - [ ] 核心 RPC、注册中心及消费者注册能力在声明支持的宿主上完成验证。
   - [ ] README 明确区分“可引用”“已验证支持”和“未验证”,并说明运行时支持政策。


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to