LoadingButtonAndroid使用手册

本指南将带您深入了解由Leandro Borges Ferreira维护的LoadingButtonAndroid项目，这是一个旨在替代ProgressDialog的安卓库，通过将按钮转换成加载进度条来提升应用的用户体验。

1. 项目目录结构及介绍

该项目遵循标准的Android开发结构，并且融入了GitHub的常规仓库布局。以下是一些关键部分的概述：

• src/main/java/com/github/leandroborgesferreira/loadingbutton/customViews/CircularProgressButton.java: 主要的自定义视图类，定义了按钮到进度条的动画和功能。
• sample/: 示例应用程序的目录，展示了如何在实际应用中集成此按钮。
• build.gradle: Gradle构建脚本，定义了依赖项和编译配置。
• README.md: 包含项目说明、安装步骤、基本用法和其他重要信息的文档。
• LICENSE: 许可证文件，声明项目遵循MIT协议。
• gitignore: 定义了哪些文件或目录不应被Git版本控制系统追踪。
• travis.yml: 自动化测试配置文件，用于持续集成流程。

2. 项目的启动文件介绍

项目的核心启动并不直接关联于单一“启动文件”，而是基于如何在你的Android项目中整合这个库。主要的交互发生在你的Activity或Fragment中，通过XML布局文件引入自定义按钮并初始化它来启动加载动画。例如，在XML布局中添加按钮：

<com.github.leandroborgesferreira.loadingbutton.customViews.CircularProgressButton
    android:id="@+id/btn_id"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@drawable/circular_border_shape"
    app:spinning_bar_width="4dp"/>

然后在相应的Java或Kotlin文件中进行初始化与逻辑处理：

val btn = findViewById<CircularProgressButton>(R.id.btn_id)
btn.startAnimation()
// 在异步任务完成时调用
btn.doneLoadingAnimation()

3. 项目的配置文件介绍

build.gradle 文件

项目根目录下的 build.gradle 文件管理全局构建设置，而子目录中的 build.gradle（如 app/build.gradle 或 sample/build.gradle）则指定模块级的依赖和编译选项。对于这个特定的项目，你需要关注的是在你的应用模块中添加依赖：

dependencies {
    implementation("com.github.leandroborgesferreira:loading-button-android:2.3.0")
}

确保这个依赖版本是最新的或者符合你的项目需求。

settings.gradle

控制着项目包含的模块，确保在使用此库时没有遗漏。

XML属性配置

在使用过程中，通过XML属性对按钮进行定制也是配置的一个重要方面，例如：

app:spinning_bar_width="4dp"
app:spinning_bar_color="#FFF"
app:spinning_bar_padding="6dp"

这些属性允许你在不写代码的情况下调整按钮样式。

---

以上就是关于LoadingButtonAndroid的基本结构、启动方法以及核心配置的简介。通过遵循这些指导，您可以顺利地将其集成到您的Android应用中，以提升用户体验。