Material Icon Library 使用教程

Material Icon Library 使用教程

material-icon-lib Library containing over 2000 material vector icons that can be easily used as Drawable or as a standalone View. 项目地址: https://gitcode.com/gh_mirrors/ma/material-icon-lib

1. 项目介绍

Material Icon Library 是一个包含超过 2000 个 Material 矢量图标的库，可以轻松地用作 Drawable 或独立的 View。这个库旨在简化开发者在 Android 应用中使用 Material 图标的流程，避免了每次都需要搜索和生成 PNG 资源的繁琐过程。

主要特点

• 包含超过 2000 个 Material 矢量图标。
• 支持在 Android Studio 设计器中实时预览和代码补全。
• 配置简单，只需几分钟即可完成。
• 添加到 APK 中的大小约为 257kb，平均每个图标占用约 109 字节。

2. 项目快速启动

2.1 添加依赖

首先，在项目的 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'net.steamcrafted:materialiconlib:1.1.5'
}

2.2 配置字体文件

为了在 Android Studio 中启用预览功能，需要将字体文件手动添加到项目的 assets 目录中。可以从 这里 下载字体文件，并将其放置在 src/main/assets 目录下。

2.3 使用 MaterialIconView

在 XML 布局文件中添加 MaterialIconView：

<net.steamcrafted.materialiconlib.MaterialIconView
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="48dp"
    android:layout_height="48dp"
    app:materialIcon="clipboard_arrow_down"
    app:materialIconColor="#fff"
    app:materialIconSize="24dp"
    android:scaleType="center"
    android:background="@android:color/darker_gray"
    android:id="@+id/icon" />

2.4 使用 MaterialDrawable

通过 MaterialDrawableBuilder 创建 MaterialDrawable：

Drawable yourDrawable = MaterialDrawableBuilder.with(context)
    .setIcon(MaterialDrawableBuilder.IconValue.WEATHER_RAINY)
    .setColor(Color.WHITE)
    .setToActionbarSize()
    .build();

yourImageView.setImageDrawable(yourDrawable);

3. 应用案例和最佳实践

3.1 在 Toolbar 中使用图标

Material Icon Library 提供了一个 MaterialMenuInflater，可以方便地在 Toolbar 中使用图标：

Toolbar toolbar = findViewById(R.id.toolbar);
MaterialMenuInflater.with(this, toolbar)
    .inflate(R.menu.your_menu, toolbar.getMenu());

3.2 在 ListView 中使用图标

由于 MaterialIconView 不缓存生成的 Drawable，因此在 ListView 中使用时建议手动缓存 Drawable：

Drawable cachedDrawable = MaterialDrawableBuilder.with(context)
    .setIcon(MaterialDrawableBuilder.IconValue.WEATHER_RAINY)
    .setColor(Color.WHITE)
    .setToActionbarSize()
    .build();

yourImageView.setImageDrawable(cachedDrawable);

4. 典型生态项目

Material Icon Library 可以与其他 Material Design 相关的库和工具结合使用，例如：

• Material Components for Android: 提供了一套完整的 Material Design 组件，可以与 Material Icon Library 无缝集成。
• AndroidX: 包含了一系列支持库，提供了对 Material Design 的支持，可以与 Material Icon Library 一起使用。
• Material Design Icons: 提供了大量的 Material Design 图标，可以与 Material Icon Library 结合使用，扩展图标库的覆盖范围。

通过结合这些生态项目，开发者可以更高效地构建符合 Material Design 标准的 Android 应用。

material-icon-lib Library containing over 2000 material vector icons that can be easily used as Drawable or as a standalone View. 项目地址: https://gitcode.com/gh_mirrors/ma/material-icon-lib