简介
Gradle 是一个强大且灵活的软件构建工具,但伴随这些优势而来的是复杂性以及对最佳实践清晰指导的需求。在许多场景下,如何最佳地使用 Gradle 并不明确,因为 Gradle 提供了多种方式来实现相同目标。通常需要判断当前的解决方案是否可能在将来引起问题,或者是否可以通过不同地使用 Gradle 来提前避免问题。本指南旨在帮助 Gradle 编写者理解这些场景,并就是如何有效地使用 Gradle 做出明智的决定。
本指南是什么
本节概述了编写可维护、功能正常且符合 Gradle 核心设计理念的 Gradle 构建的最佳实践。其中一些实践是应该做的,另一些则是应该避免的。
本指南基于使用 Gradle 的一些大型软件生态系统的真实世界经验。它面向所有 Gradle 专业水平的用户,从初学者到高级用户。并非此处的每项实践都适用于所有构建,但它们旨在广泛适用并对许多不同的使用场景有益。
本指南 不是 关于如何使用 Gradle 的说明。为此,我们在 Gradle 文档的 其他地方 提供了详尽的教程和参考资料。
原则
本指南中的条目应做到 简明、易懂 和 可操作。
-
构建编写者应该能够快速识别他们何时遵循了最佳实践,何时没有。
-
阅读后,他们应该理解为什么某种特定方法是有益的或有问题的,以及在哪里可以找到进一步的参考资料。
-
建议应该广泛适用于 许多 或 大多数 典型构建,并且应该提供具体、切实的建议。