2024年8月Amper更新——独立项目、设置追踪及更多

2024年8月Amper更新——独立项目、设置追踪及更多

💡 原文英文,约800词,阅读约需3分钟。
📝

内容提要

Amper版本0.4.0现已推出,引入了项目根定义和设置追踪功能。独立项目现在具有项目级配置文件,而多模块项目需要一个project.yaml文件。项目文件允许进行项目范围的配置选项,并为未来的改进奠定了基础。设置追踪有助于跟踪构建配置更改。Amper支持特定平台的配置,并根据使用的平台提供完成和警告。现有项目需要更新存储库URL和插件版本。提供了示例项目和错误修复。鼓励提供反馈以塑造Amper的未来。

🔎

延伸解读

项目根定义:独立与多模块项目的差异

Amper 0.4.0 为独立项目引入了项目级配置文件,明确了项目根和内容。单模块项目仍可用 module.yaml 快速启动,而多模块项目必须在根目录包含 project.yaml,列出所有模块(支持路径或通配符)。对于 Gradle 项目,settings.gradle.kts 继续作为项目定义文件,但必须显式列出所有 Amper 模块。这一设计为未来项目级配置、依赖版本管理等功能奠定了基础。

设置追踪:理解构建配置的有效值

设置追踪功能帮助开发者检查构建配置中设置值的来源和覆盖情况。通过设置块的工具提示,可以查看所有有效值及其定义位置;查看单个设置时,能了解何时覆盖了已设值。检查功能还会警告冗余设置,例如值未实际改变或与默认值相同。这有助于维护复杂项目的构建配置,减少错误。

平台特定配置:针对多平台项目的智能提示

Amper 专为 Kotlin Multiplatform 设计,能根据模块实际使用的平台集定制配置体验。最新工具仅对相关平台提供配置选项的补全,并在设置无效时给出警告,提示缺少哪个平台。这减少了配置错误,提升了多平台开发的效率。

升级注意:更新仓库URL和插件版本

从 0.4.0 开始,Amper 构建发布在新仓库中,包含公开版本和开发版本,便于切换。Gradle 项目需将旧仓库 URL 替换为新 URL,并更新插件版本至 0.4.0。独立项目用户需按照文档更新 amper 脚本。示例项目已更新,可参考使用。

❓

Q&A

Amper 0.4.0版本新增了哪些功能?

Amper 0.4.0版本新增了项目根定义和设置追踪功能,并引入了项目级配置文件。

如何为多模块项目配置Amper?

多模块项目必须在根目录中包含project.yaml文件,列出所有包含的模块。

设置追踪功能的作用是什么?

设置追踪功能帮助跟踪构建配置的变化,便于检查和理解构建过程。

如何更新现有的Amper项目?

更新现有项目时,需要更新存储库URL和插件版本,以使用新版本的Amper。

Amper支持哪些平台的配置?

Amper支持特定平台的配置,并根据使用的平台提供相关的完成和警告。

用户如何反馈Amper的使用体验?

用户可以通过Kotlinlang Slack的#amper频道或在YouTrack上分享建议和想法来反馈使用体验。

🏷️

标签

➡️

继续阅读