Materialish Progress 使用指南

---

项目介绍

Materialish Progress 是一款兼容 Android 2.3 及以上版本的 Material 设计风格的进度条库。它模拟了谷歌 Material Design 的视觉效果，提供了一个旋转的进度指示器（progress wheel），适用于各种加载场景。该库由 Pnikosis 开发并在GitHub上开源，为那些希望在旧版本Android设备上也能呈现现代设计感的应用提供了便利。

项目快速启动

要将 Materialish Progress 添加到您的项目中，请遵循以下步骤：

步骤 1: 添加依赖项

在您 Android 项目的 build.gradle (Module: app) 文件中的 dependencies 区块添加如下依赖：

dependencies {
    implementation 'com.pnikosis:materialish-progress:1.0'
}

之后同步 Gradle 以应用更改。

步骤 2: 使用示例代码

在布局文件 (.xml) 中添加 ProgressWheel 控件：

<com.pnikosis.materialishprogress.ProgressWheel
    android:id="@+id/progress_wheel"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:matProg_barColor="@color/colorAccent"
    app:matProg_progressIndeterminate="true" />

或在 Java 或 Kotlin 代码中动态创建并配置：

ProgressWheel progressWheel = new ProgressWheel(this);
progressWheel.setLayoutParams(new ViewGroup.LayoutParams(
        ViewGroup.LayoutParams.WRAP_CONTENT,
        ViewGroup.LayoutParams.WRAP_CONTENT));
progressWheel.setBarColor(ContextCompat.getColor(this, R.color.colorAccent));
progressWheel.setIndeterminate(true);
// 找到一个视图容器并添加它
yourContainer.addView(progressWheel);

步骤 3: 自定义样式

通过属性设置，您可以改变轮的颜色、大小、是否持续旋转等，如 app:matProg_fillRadius 可使进度条填充整个布局。

应用案例和最佳实践

在实际应用中，Materialish Progress 可用于网络请求期间的界面反馈，例如在加载数据、提交表单时显示。最佳实践包括：

• 延迟显示：避免瞬时显示即消失的情况，确保用户能看到加载过程。
• 定位策略：通常置于页面中心或操作按钮附近，清晰指示正在进行的操作。
• 结合异步任务：与后台任务配合使用，任务结束时及时隐藏进度条。

典型生态项目

虽然“Materialish Progress”本身是一个独立的小型库，但它的存在促进了Android应用遵循Material Design准则。在构建具有统一设计语言的应用时，它常与其他Material Design组件一同使用，比如搭配RecyclerView进行数据加载提示，或与SwipeRefreshLayout结合，增强刷新体验的一致性。

通过以上的集成方式和使用建议，开发者可以轻松地在其应用程序中引入 Material 风格的加载指示，提升用户交互体验。