Android Studio 中使用 PullToRefresh 框架

1 概念

Android-PullToRefresh 框架是一个实现View下拉刷新的开源框架.

2 配置项目

1. 从Github上下载需要的文件.

Github下载地址 : https://github.com/chrisbanes/Android-PullToRefresh

2. 将下载的压缩包进行解压文件结构如下 :

--> Android-PullToRefresh-maste
     --> extras
     --> samples
     --> library (我们需要的.)

3. 新建项目,直接将解压得到的 library 拷贝到项目的根目录(在Android Studio中)下.其实也就是将library作为一个单独的Module.

// 此时的项目结构
--> 项目
    --> app      
    --> library  // 新拷贝的文件
    ... // 其他

4. 修改项目的 settings.gradle 文件. 增加 include ':library'

// 修改前
include ':app'

// 修改后
include ':app'
include ':library'

5. 在新建的 library Module 下面创建 build.gradle 文件.内容如下.

注意 : compileSdkVersion 和 buildToolsVersion要修改你本机上可用的.

apply plugin:'com.android.library'
android {
    compileSdkVersion 24
    buildToolsVersion "24.0.3"
    sourceSets {
        main {
            manifest.srcFile 'AndroidManifest.xml'
            java.srcDirs = ['src']
            resources.srcDirs = ['src']
            aidl.srcDirs = ['aidl']
            renderscript.srcDirs = ['src']
            res.srcDirs = ['res']
            assets.srcDirs = ['assets']
        }
    }
}

6. 修改 app Module 中的 build.gradle文件 增加依赖 compile project(':library')

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })
    compile 'com.android.support:appcompat-v7:24.2.1'
    // 新增加的
    compile project(':library')

    testCompile 'junit:junit:4.12'
}

7. 同步项目

注意 : 如果是Android 6.0 以上同步会提示 FloatMath 不可用的错误. 使用 Math 替换即可.

3 使用

在布局文件中使用 PullToRefreshListView

布局文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    android:id="@+id/activity_main"
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="10dp"
    tools:context="com.wsj.test.pulltorefreshtestone.MainActivity">
    <!-- PullToRefresh 测试的ListView -->
    <com.handmark.pulltorefresh.library.PullToRefreshListView
        android:id="@+id/id_lv_test"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:dividerHeight="1px"
        android:divider="#FF1493"
        android:background="#FFFFE0"/>
</LinearLayout>

Activity 中设置下拉刷新监听

• 使用 setOnRefreshListener设置刷新监听,
• 使用OnRefreshListener回调在 onRefresh方法中触发加载数据操作.实现下拉监听.
• 使用 AsyncTask 实现加载数据 .
• 加载完后已经记得调用 id_lv_test.onRefreshComplete();,否则将无法结束加载.

注意 : 加载数据时间不要太短,否则会出现无法 onRefreshComplete()失效的情况. 并且一定要在主线程中中.

public class MainActivity extends AppCompatActivity {
    PullToRefreshListView id_lv_test;
    // 数据组合
    private List<String> mList = new ArrayList<String>(){
        {
            add("语文");
            add("数学");
            add("计算机");
        }
    };
    private ArrayAdapter<String> mLvAdapter;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // 获取控件
        id_lv_test = (PullToRefreshListView) findViewById(R.id.id_lv_test);
        // 设置适配器
        mLvAdapter = new ArrayAdapter<String>(this,android.R.layout.simple_list_item_1,mList);
        id_lv_test.setAdapter(mLvAdapter);
        // 设置下拉刷新监听.
        id_lv_test.setOnRefreshListener(new PullToRefreshBase.OnRefreshListener<ListView>() {
            @Override
            public void onRefresh(PullToRefreshBase<ListView> refreshView) {
                // 使用 AsyncTask 加载新数据.
                new AsyncTask<Void,Void,Void>(){
                    @Override
                    protected Void doInBackground(Void... params) {
                        // 子线程加载数据,模拟延时 3s
                        SystemClock.sleep(3 * 1000);
                        mList.add("新数据 - " + mLvAdapter.getCount());
                        return null;
                    }
                    @Override
                    protected void onPostExecute(Void aVoid) {
                        // 这是在主线程. 通知 ListView 更新数据.
                        id_lv_test.onRefreshComplete();
                    }
                }.execute();

            }
        });

    }
}

实现上拉和下拉刷新

步骤和单独的下拉刷线基本一样试试 监听者 使用 OnRefreshListener2 实现其中的两个方法分别表示上拉 和 下拉.

// 设置刷新模式
/*
* 设置PullToRefresh刷新模式
* BOTH:上拉刷新和下拉刷新都支持
* DISABLED：禁用上拉下拉刷新
* PULL_FROM_START:仅支持下拉刷新（默认）
* PULL_FROM_END：仅支持上拉刷新
* MANUAL_REFRESH_ONLY：只允许手动触发
**/
id_lv_test.setMode(PullToRefreshBase.Mode.BOTH);
// 设置上下刷新 使用 OnRefreshListener2
id_lv_test.setOnRefreshListener(new PullToRefreshBase.OnRefreshListener2<ListView>() {
    @Override
    public void onPullDownToRefresh(PullToRefreshBase<ListView> refreshView) {
        // 主线程
        Log.d(TAG,"下拉动作 : " + Thread.currentThread().getId());

        // TODO : 实现数据加载逻辑.
        // 模拟数据加载,,加载时间不要太短 否则,会出现一直刷新的情况.
        id_lv_test.postDelayed(new Runnable() {
            @Override
            public void run() {
                id_lv_test.onRefreshComplete();
            }
        },50);

    }

    @Override
    public void onPullUpToRefresh(PullToRefreshBase<ListView> refreshView) {
        Log.d(TAG,"上拉动作");
        // TODO : 实现数据加载逻辑.
        id_lv_test.postDelayed(new Runnable() {
            @Override
            public void run() {
                id_lv_test.onRefreshComplete();
            }
        },50);
    }
});
// 设置PullRefreshListView上提加载时的加载提示
id_lv_test.getLoadingLayoutProxy(false,true).setPullLabel("上拉加载更多.");
id_lv_test.getLoadingLayoutProxy(false,true).setRefreshingLabel("正在加载数据...");
id_lv_test.getLoadingLayoutProxy(false,true).setReleaseLabel("松开加载更多...");
// 设置PullRefreshListView下拉加载时的加载提示
id_lv_test.getLoadingLayoutProxy(true, false).setPullLabel("下拉刷新...");
id_lv_test.getLoadingLayoutProxy(true, false).setRefreshingLabel("正在刷新...");
id_lv_test.getLoadingLayoutProxy(true,false).setReleaseLabel("松开刷新...");

参考 : https://my.oschina.net/sldk/blog/403313