成功的公共代码库

Question

是否有任何流程、指南或最佳实践可用于成功实现公共代码库。目前，我们正在讨论开发团队中公共代码库的实现。在我们的例子中，我们的公共代码库将补充我们开发的主流.net软件包。

我特别感兴趣的是以下方面的详细情况和意见：

• 有机与设计第一方法
• 版本管理
• 成功的故事(当做工作时)
• 恐怖故事(当它们不起作用时)

非常感谢

Answer 1

我认为，我们应该在预先设计和有机发展之间找到一个很好的平衡。外部方使用的公共库越多，一旦发布API就越难更改。因此，我们应该从一开始就仔细考虑并保持一致。然而，它是为了供其他人使用，所以它应该遵循和适应客户的需要，而不是单纯地满足一些学术设计原则。

在实践中，库开发人员与他们(潜在的)客户之间的沟通是关键。设计者必须在实际生活中测试有关API的每一个想法，然后再提交给它。乔希·布洛赫在工作中的程序员中谈到了这一点:他总是编写大量代码来实际使用他正在开发中的API，即使这些只是半形成的框架，没有任何真正的功能。这为他提供了宝贵的反馈，以改进接口，使其易于使用，并且对于普通用例来说是明确无误的。

Answer 2

一个有教育意义的恐怖故事是失效模式。代码的泛化基本上被认为是一种反模式.如果您构建公共代码库，请确保它们尽可能地保持松散耦合。尝试向工具箱架构发展，根据你正在进行的项目来选择你需要的东西，而不是一个大核心-单体库，它可以做任何事情，除了进化。

Answer 3

命名约定应该就位。使类、函数、事件等的名称自我解释。这将有助于找到职能和避免重复/混淆。