Gloading 开源项目使用教程

1. 项目的目录结构及介绍

Gloading 项目的目录结构如下：

Gloading/
├── app/
│   ├── build.gradle
│   └── src/
├── gradle/
│   └── wrapper/
├── image/
├── gloading/
│   ├── build.gradle
│   └── src/
├── .gitignore
├── LICENSE
├── README-zh-CN.md
├── README.md
├── bintray.gradle
├── build.gradle
├── demo.apk
├── gradle.properties
├── gradlew
├── gradlew.bat
└── settings.gradle

目录结构介绍

• app/: 包含示例应用的代码和配置文件。
• gradle/: 包含 Gradle 包装器的文件。
• image/: 包含项目相关的图片资源。
• gloading/: 包含 Gloading 库的核心代码和配置文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• README-zh-CN.md: 中文版项目说明文档。
• README.md: 项目说明文档。
• bintray.gradle: Bintray 发布配置文件。
• build.gradle: 项目构建配置文件。
• demo.apk: 示例应用的 APK 文件。
• gradle.properties: Gradle 属性配置文件。
• gradlew: Gradle 包装器脚本（Unix）。
• gradlew.bat: Gradle 包装器脚本（Windows）。
• settings.gradle: 项目设置文件。

2. 项目的启动文件介绍

Gloading 项目的启动文件主要是 app/src/main/java/com/billy/app_lib_gloading/MainActivity.java。这个文件是示例应用的主活动，展示了如何使用 Gloading 库来显示加载状态视图。

MainActivity.java 文件介绍

package com.billy.app_lib_gloading;

import android.os.Bundle;
import android.view.View;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;
import com.billy.gloading.Gloading;
import com.billy.gloading.Holder;

public class MainActivity extends AppCompatActivity {

    private Holder mHolder;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 初始化 Gloading
        mHolder = Gloading.getDefault().wrap(this).withRetry(new Runnable() {
            @Override
            public void run() {
                retryLoad();
            }
        });

        // 显示加载状态视图
        mHolder.showLoading();
    }

    private void retryLoad() {
        Toast.makeText(this, "Retry loading", Toast.LENGTH_SHORT).show();
        // 模拟加载成功
        mHolder.showLoadSuccess();
    }
}

关键点介绍

• Gloading.getDefault().wrap(this): 将当前活动包装在 Gloading 中，以便显示加载状态视图。
• withRetry(new Runnable() {...}): 设置加载失败时的重试任务。
• mHolder.showLoading(): 显示加载状态视图。
• mHolder.showLoadSuccess(): 显示加载成功状态视图。

3. 项目的配置文件介绍

Gloading 项目的主要配置文件包括 build.gradle 和 gradle.properties。

build.gradle 文件介绍

build.gradle 文件位于项目根目录下，包含了项目的构建配置。

// 项目级别的 build.gradle 文件
buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.5.3'
    }
}

allprojects {
    repositories {
        google()
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

gradle.properties 文件介绍

gradle.properties 文件位于项目根目录下，包含了 Gradle 构建