Compose Material 3

使用 Material Design 3(下一代 Material Design)组件构建 Jetpack Compose 界面。Material 3 包括更新后的主题和组件,以及动态配色等 Material You 个性化功能,旨在与新的 Android 12 视觉风格和系统界面相得益彰。
最近更新时间 当前稳定版 下一候选版 Beta 版 Alpha 版
2021 年 12 月 1 日 - - - 1.0.0-alpha02

结构

Compose 由 androidx 中的 7 个 Maven 组 ID 构成。每个组都包含一套特定用途的功能,并各有专属的版本说明。

下表介绍了各个组及指向其版本说明的链接。

说明
compose.animation在 Jetpack Compose 应用中构建动画,丰富用户的体验。
compose.compiler借助 Kotlin 编译器插件,转换 @Composable functions(可组合函数)并启用优化功能。
compose.foundation使用现成可用的构建块编写 Jetpack Compose 应用,还可扩展 Foundation 以构建您自己的设计系统元素。
compose.material使用现成可用的 Material Design 组件构建 Jetpack Compose UI。这是更高层级的 Compose 入口点,旨在提供与 www.material.io 上描述的组件一致的组件。
compose.material3使用 Material Design 3(下一代 Material Design)组件构建 Jetpack Compose 界面。Material 3 包括更新后的主题和组件,以及动态配色等 Material You 个性化功能,旨在与新的 Android 12 视觉风格和系统界面相得益彰。
compose.runtimeCompose 的编程模型和状态管理的基本构建块,以及 Compose 编译器插件针对的核心运行时。
compose.ui与设备互动所需的 Compose UI 的基本组件,包括布局、绘图和输入。

声明依赖项

如需添加 Compose 的依赖项,您必须将 Google Maven 代码库添加到项目中。如需了解详情,请参阅 Google 的 Maven 代码库

在应用或模块的 build.gradle 文件中添加所需工件的依赖项:

Groovy

dependencies {
    implementation "androidx.compose.material3:material3:1.0.0-alpha03"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.0.0-alpha03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.material3:material3:1.0.0-alpha03")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.0.0-alpha03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

如需详细了解依赖项,请参阅添加 build 依赖项

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题,或对此库的改进有自己的见解,请告诉我们。创建新问题前,请先查看此库中的现有问题。您可以点击星标按钮,为现有问题投票。

创建新问题

如需了解详情,请参阅问题跟踪器文档

1.0 版

版本 1.0.0-alpha02

2021 年 12 月 1 日

发布了 androidx.compose.material3:material3:1.0.0-alpha02版本 1.0.0-alpha02 中包含这些提交内容

新功能

  • 添加了对复选框和单选按钮的支持。
  • 进行了更新,现在与 Kotlin 1.6.0 兼容

API 变更

  • 从 Material 3 的 scaffold 中移除了抽屉式导航栏。(I04f51)
  • 添加了 Material 3 Checkbox 支持。(Id5542)
  • 添加了 Material 3 RadioButton 支持。(I20334)

bug 修复

  • IconButton 涟漪效果半径从 40dp 缩减到了 20dp。(I68bbeb/206674345
  • 移植了 compose.material 中的“Text 字符串快速路径”更改 (I30b03)
  • 修复了硬编码按钮始终处于启用状态的 bug。(Iea832b/205335456

版本 1.0.0-alpha01

2021 年 10 月 27 日

发布了 androidx.compose.material3:material3:1.0.0-alpha01版本 1.0.0-alpha01 中包含这些提交内容

新功能

Material Design 3 主题和 Material You 动态配色

Material Design 3 组件

如需了解详情,请参阅《Compose 中的 Material 主题设置》指南中的“Material Design 3 和 Material You”部分。