AnimatedCircleLoadingView 使用教程

AnimatedCircleLoadingView 使用教程

1. 项目介绍

AnimatedCircleLoadingView 是一个由José Luis Martín开发的Android库，它提供了确定性和不确定性的加载动画视图。这个库是基于原生的Java实现，并被C#语言移植到Xamarin平台，允许在Xamarin.Android应用程序中使用。动画效果灵感来源于android-watch-loading-animation。

该项目支持以下功能：

• 确定性（determinate）加载动画，显示加载进度。
• 不确定性（indeterminate）加载动画，无具体进度指示。
• 动画结束时可选择成功或失败状态显示。
• 自定义颜色、大小等属性。

2. 项目快速启动

要在你的Android项目中集成AnimatedCircleLoadingView，请遵循以下步骤：

2.1 添加依赖

在你的build.gradle文件的dependencies部分添加以下依赖项：

dependencies {
    // ...
    implementation 'com.github.jlmd:AnimatedCircleLoadingView:1.1.5'
}

同步Gradle以下载库。

2.2 引入XML布局

在你的布局文件中添加AnimatedCircleLoadingView组件：

<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <com.xama.jtports.animatedcircleloadingview.AnimatedCircleLoadingView
        android:id="@+id/circle_loading_view"
        android:layout_width="250dp"
        android:layout_height="250dp"
        android:layout_gravity="center_horizontal"
        android:background="@color/your_background_color"
        
        app:animCircleLoadingView_mainColor="@color/your_main_color"
        app:animCircleLoadingView_secondaryColor="@color/your_secondary_color"
        app:animCircleLoadingView_textColor="@android:color/white" />

</LinearLayout>

2.3 初始化并控制动画

在你的Activity或Fragment中初始化并控制加载动画：

import com.xama.jtports.animatedcircleloadingview.AnimatedCircleLoadingView;

public class YourActivity extends AppCompatActivity {

    private AnimatedCircleLoadingView circleLoadingView;

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

        circleLoadingView = findViewById(R.id.circle_loading_view);

        // 启动确定性加载动画
        circleLoadingView.startDeterminate();

        // 设置进度百分比
        circleLoadingView.setPercentage(50);

        // 动画完成，成功状态
        circleLoadingView.stopOk();

        // 动画完成，失败状态
        circleLoadingView.stopFailure();

        // 重置加载
        circleLoadingView.resetLoading();
    }
}

3. 应用案例和最佳实践

• 在网络请求或者数据加载期间，可以显示不确定性的加载动画，给用户一种正在后台工作的反馈。
• 当需要展示明确的加载进度时，如上传或下载文件，使用确定性的加载动画，并随着进度更新百分比。
• 结束加载动画时，根据操作结果调用stopOk()或stopFailure()方法，提供明确的操作结果反馈。
• 根据你的设计需求调整组件的颜色和大小。

4. 典型生态项目

此库已被用于多个Android应用中，包括但不限于：

• 移动应用中的数据加载场景
• 用户界面中的交互式按钮
• 高性能要求的应用，需优化用户体验的地方

请注意，由于开源社区的活跃性，可能还有其他未列出的项目在使用此库。

以上就是AnimatedCircleLoadingView的简要介绍及使用教程，希望对您的开发工作有所帮助。在实践中，根据具体情况灵活运用这些功能，可以提升您应用的用户体验。