c# - 公共(public) API 的正确命名空间

Question

我试图找出在从大量实现代码中创建公共(public) API 时如何正确使用命名空间。

我正在编写一个 API，为我公司创建的所有代码添加一个友好的公众形象，以便解决我们最常用框架中的问题。

我的新项目的根命名空间称为“FrameworkSDK”。

在 FrameworkSDK 下，我有 FrameworkSDK.CompanyNameLibrary，这是我公司创建的所有实现代码所在的位置。

我正在尝试编写 PublicFacingAPI，理想情况下它会在 FrameworkSDK.CompanyNameLibrary 之上放置一个漂亮的面孔，以便新开发人员可以立即开始使用它，等等。

我应该将新的 PublicFacingAPIcode 放在哪个命名空间中？

它应该放在 FrameworkSDK.CompanyNameLibrary.PublicFacingAPI 中吗？那么每当开发人员导入这个 dll 时，这将是一个荒谬的 using 语句。

我可以将代码放在 FrameworkSDK 命名空间中，但所有公共(public)类都需要包含使用 FrameworkSDK.CompanyNameLibrary 或 using FrameworkSDK.CompanyNameLibrary.SubNameSpace 的 using 语句。

这段代码应该放在哪里？

谢谢

Answer 1

我不认为 SDK.CompanyNameLibrary.CompanyInternalAPI 如此荒谬。它有点长，但具有描述性，任何使用该 dll 的人都会确切地知道他们得到的是什么。