Android XML中的<macro>标签是什么？如何及何时使用？

1. <macro>标签是什么？ #

<macro>是Material Components for Android库自定义的资源复用工具，本质是用来封装重复使用的资源引用（比如主题属性、样式引用），在编译阶段会被替换为对应的实际引用值。它不属于Android官方标准资源标签，也和XLIFF规范无关，是Material库为简化资源管理、统一组件样式定义而实现的扩展。

Android Studio能识别它，是因为Material库的Gradle插件或资源处理逻辑对其做了适配支持，允许在<resources>标签内声明和引用。

2. 如何使用<macro>？ #

声明宏 #

在res/values目录下的XML资源文件中，于<resources>标签内定义：

<macro name="m3_comp_assist_chip_container_shape">?attr/shapeAppearanceCornerSmall</macro>
<macro name="m3_comp_assist_chip_label_text_type">?attr/textAppearanceLabelLarge</macro>

• name：宏的唯一标识，命名通常遵循Material库规范（比如前缀m3_代表Material 3）
• 标签内容：要复用的资源引用，支持?attr/主题属性、@style/样式、@dimen/尺寸等多种资源类型

引用宏 #

在布局、样式或其他资源文件中，通过@macro/前缀调用：

<!-- 在组件样式中引用宏 -->
<style name="CustomAssistChip" parent="Widget.Material3.AssistChip">
    <item name="shapeAppearance">@macro/m3_comp_assist_chip_container_shape</item>
    <item name="textAppearance">@macro/m3_comp_assist_chip_label_text_type</item>
</style>

3. 何时使用<macro>？ #

• 统一样式基准：当多个组件或样式需要引用同一主题属性/资源时，用宏封装后，后续修改只需更新宏的定义，无需逐一修改所有引用处，比如Material 3中所有圆角组件统一复用shapeAppearance相关宏
• 简化复杂引用：对于较长的资源路径或属性名，用宏缩短引用代码，提升可读性
• 适配多版本/主题：通过宏统一管理样式入口，方便在不同版本（如Material 2和Material 3）或主题间切换资源引用

注意：<macro>是Material库专属扩展，若未基于Material Components开发，自定义宏可能无法被Android Studio或编译工具识别，除非自行实现对应的资源处理逻辑。

内容的提问来源于stack exchange，提问作者Lionel Briand