Skip to content

开始使用

官方演示Demo:MaterialCatalog

引入依赖

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

kotlin
dependencies {
    implementation("com.google.android.material:material:1.11.0")
}
groovy
dependencies {
    implementation "com.google.android.material:material:1.11.0"
}

在此可以查看最新的版本

Android SDK 编译

为了使用最新版本的 Android 材质组件和 AndroidX Jetpack 库,您必须安装最新版本的 Android Studio 并更新您的应用以满足以下要求:

  • compileSdkVersion -> 34或更高版本
  • minSdkVersion -> 19或更高版本

Java 8 编译

最新的 Material 和 AndroidX Jetpack 库现在要求您的应用 使用 Java 8 编译。 请参阅 Java 8 语言功能和 API 文档

Gradle、AGP 和 Android Studio

使用 MDC-Android 及更高版本时,您需要确保 您的项目是按照以下最低要求构建的,以便 支持最新的构建功能

  • Gradle 版本 7.3.3
  • Android Gradle 插件 (AGP) 版本 7.2.0
  • Android Studio Chipmunk,版本 2021.2.1

AppCompatActivity

Activity 需要是继承于 AppCompatActivity

Theme

xml中主题需要使用 MaterialComponentsMaterial3

xml

<style name="Theme.MyApp" parent="Theme.Material3.DayNight.NoActionBar">
    <!-- ... -->
</style>

以下是可以使用的一些样式主题:

Material3MaterialComponents
Theme.Material3.LightTheme.MaterialComponents.Light
Theme.Material3.Light.NoActionBarTheme.MaterialComponents.Light.NoActionBar
Theme.Material3.DarkTheme.MaterialComponents
Theme.Material3.Dark.NoActionBarTheme.MaterialComponents.NoActionBar
Theme.Material3.DayNightTheme.MaterialComponents.DayNight
Theme.Material3.DayNight.NoActionBarTheme.MaterialComponents.DayNight.NoActionBar
Theme.Material3.DynamicColors.LightN/A
Theme.Material3.DynamicColors.Light.NoActionBarN/A
Theme.Material3.DynamicColors.DarkN/A
Theme.Material3.DynamicColors.Dark.NoActionBarN/A
Theme.Material3.DynamicColors.DayNightN/A
Theme.Material3.DynamicColors.DayNight.NoActionBarN/A
N/ATheme.MaterialComponents.Light.DarkActionBar
N/ATheme.MaterialComponents.DayNight.DarkActionBar