下拉刷新框架Android-Ultra-Pull-To-Refresh的学习与-阿里云开发者社区

之所以做这件事，是因为前者已经没有在维护了，所以把现在的下拉刷新框架PullToRefresh框架换成Android-Ultra-Pull-To-Refresh框架。

一、下载和配置

在网址为：https://github.com/liaohuqiu/android-Ultra-Pull-To-Refresh的地址，把这个项目下载下来，解压后找到名为“ptr_lib”的文件夹，直接丢进我们的项目中。（注：这里我为了方便自己识别，改为了AndroidPtr_Library）。

第一步：在整个工程的settings.gradle文件中添加

include:’ AndroidPtr_Library’

后，在Project Structure中找到我们的项目，点击弹框右侧添加按钮，添加一个命名为“AndroidPtr_Library”的Module Dependency。

第二步：在项目的build.gradle文件中添加依赖

compile project(':AndroidPtr_Library')

做完上面这两步后，点击“Rebuild Project”，“，然后就报错了，报错内容如下：

“Error:(4, 1) A problemoccurred evaluating project ':AndroidPtr_Library'.

> Could not getunknown property 'ANDROID_BUILD_SDK_VERSION' for project':AndroidPtr_Library' of type org.gradle.api.Project.”

所以就有了第三步：在整个工程的gradle.properties文件中添加

ANDROID_BUILD_MIN_SDK_VERSION=8

ANDROID_BUILD_TARGET_SDK_VERSION=22

ANDROID_BUILD_SDK_VERSION=22

ANDROID_BUILD_TOOLS_VERSION=22.0.1

接着运行便没有问题了，也可以看到下拉刷新的框架已经加进来了。

二、Header改造之PtrClassicDefaultHeader类

在源码中有很多叫***Header的类，也就是我们下拉刷新的头部对应的类，这里我们先来看最原始的PtrClassicDefaultHeader的类。

在这个类里面有几个主要方法：

initView() 初始化视图

buildAnimation() 初始化动画对象，这里面有两个旋转动画用于图片为一个箭头的ImageView在下拉时改变箭头方向。

重写onDetachedFromWindow() 当视图销毁时，判断下拉时更新时间的线程是否为空，如果不为空就停止该线程。

tryUpdateLastUpdateTime() 更新最后的刷新时间

getLastUpdateTime() 也就是获得最后的刷新时间

重写onUIPositionChange() 这个方法是用来判断位置变化从而在里面对ImageView进行动画处理

了解了这些方法后，再来看这个类对应的布局，也就是一个命名为“cube_ptr_classic_default_header”的布局文件，它由四个部分组成，一个根据旋转动画RotateAnimation变化方向的ImageView，两个TextView，一个用来刷新时显示刷新的状态（下拉刷新-释放刷新-加载中-更新完成），一个则是在下拉刷新时提示上次更新的时间，一个ProgressBar（刷新时转动）。

接着我们就可以对下拉刷新的头部进行改造了。这里我新建了一个类命名为“SherryPtrClassicDefaultHeader”，在这个类里面我只用到了ImageView和TextView。布局文件如下：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <RelativeLayout
        android:layout_width="fill_parent"
        android:layout_height="60dp">

        <LinearLayout
            android:id="@+id/sherry_ptr_classic_header_rotate_view_header_text"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true"
            android:layout_marginLeft="10dp"
            android:gravity="center"
            android:orientation="vertical">

            <TextView
                android:id="@+id/sherry_ptr_classic_header_rotate_view_header_title"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:textColor="#666666"
                android:textSize="14sp" />
        </LinearLayout>

        <FrameLayout
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerVertical="true"
            android:layout_toLeftOf="@+id/sherry_ptr_classic_header_rotate_view_header_text">

            <ImageView
                android:id="@+id/sherry_ptr_classic_header_rotate_view"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_gravity="center"
                android:src="@drawable/default_ptr_rotate"/>

        </FrameLayout>
    </RelativeLayout>

</LinearLayout>

这里我的ImageView的默认图片是一个类似于圆形ProgressBar的图片，也就是上面的“default_ptr_rotate”。接着附上我的java类代码：

public class SherryPtrClassicDefaultHeader extends FrameLayout implements PtrUIHandler {

    private final static String KEY_SharedPreferences = "cube_ptr_classic_last_update";
    private static SimpleDateFormat sDataFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    private static final int ROTATION_ANIMATION_DURATION = 1200;
    private int mRotateAniTime = 150;
    private RotateAnimation mFlipAnimation;
    private RotateAnimation mReverseFlipAnimation;
    private TextView mTitleTextView;
    private View mRotateView;
    private float mDownHeight = 0;
    private long mLastUpdateTime = -1;
    private String mLastUpdateTimeKey;

    public SherryPtrClassicDefaultHeader(Context context) {
        super(context);
        initViews(null);
    }

    public SherryPtrClassicDefaultHeader(Context context, AttributeSet attrs) {
        super(context, attrs);
        initViews(attrs);
    }

    public SherryPtrClassicDefaultHeader(Context context, AttributeSet attrs, int defStyle) {
        super(context, attrs, defStyle);
        initViews(attrs);
    }

    protected void initViews(AttributeSet attrs) {
        TypedArray arr = getContext().obtainStyledAttributes(attrs, R.styleable.PtrClassicHeader, 0, 0);
        if (arr != null) {
            mRotateAniTime = arr.getInt(R.styleable.PtrClassicHeader_ptr_rotate_ani_time, mRotateAniTime);
        }
        buildAnimation();
        View header = LayoutInflater.from(getContext()).inflate(R.layout.sherry_ptr_classic_default_header, this);

        mRotateView = header.findViewById(R.id.sherry_ptr_classic_header_rotate_view);

        mTitleTextView = (TextView) header.findViewById(R.id.sherry_ptr_classic_header_rotate_view_header_title);

        resetView();
    }

    public void setRotateAniTime(int time) {
        if (time == mRotateAniTime || time == 0) {
            return;
        }
        mRotateAniTime = time;
        buildAnimation();
    }

    /**
     * Specify the last update time by this key string
     *
     * @param key
     */
    public void setLastUpdateTimeKey(String key) {
        if (TextUtils.isEmpty(key)) {
            return;
        }
        mLastUpdateTimeKey = key;
    }

    /**
     * Using an object to specify the last update time.
     *
     * @param object
     */
    public void setLastUpdateTimeRelateObject(Object object) {
        setLastUpdateTimeKey(object.getClass().getName());
    }

    private void buildAnimation() {
        mFlipAnimation = new RotateAnimation(0, mDownHeight * 360 / 100, Animation.RELATIVE_TO_SELF, 0.5f, Animation.RELATIVE_TO_SELF,
                0.5f);
        mFlipAnimation.setInterpolator(new LinearInterpolator());
        mFlipAnimation.setDuration(100);
        mFlipAnimation.setRepeatCount(Animation.INFINITE);
        mFlipAnimation.setRepeatMode(Animation.RESTART);

        mReverseFlipAnimation = new RotateAnimation(0, 720, Animation.RELATIVE_TO_SELF, 0.5f, Animation.RELATIVE_TO_SELF,
                0.5f);
        mReverseFlipAnimation.setInterpolator(new LinearInterpolator());
        mReverseFlipAnimation.setDuration(ROTATION_ANIMATION_DURATION);
        mReverseFlipAnimation.setRepeatCount(Animation.INFINITE);
        mReverseFlipAnimation.setRepeatMode(Animation.RESTART);
    }

    private void resetView() {
        hideRotateView();
    }

    private void hideRotateView() {
        mRotateView.clearAnimation();
        mRotateView.setVisibility(INVISIBLE);
    }

    @Override
    public void onUIReset(PtrFrameLayout frame) {
        resetView();
    }

    @Override
    public void onUIRefreshPrepare(PtrFrameLayout frame) {


        mRotateView.setVisibility(VISIBLE);
        mTitleTextView.setVisibility(VISIBLE);
        if (frame.isPullToRefresh()) {
            mTitleTextView.setText(getResources().getString(R.string.ynf_ptr_pull_down_to_refresh));
        } else {
            mTitleTextView.setText(getResources().getString(R.string.ynf_ptr_pull_down));
        }
    }

    @Override
    public void onUIRefreshBegin(PtrFrameLayout frame) {
        mTitleTextView.setVisibility(VISIBLE);
        mTitleTextView.setText(R.string.ynf_ptr_refreshing);

    }

    @Override
    public void onUIRefreshComplete(PtrFrameLayout frame) {

        mTitleTextView.setVisibility(VISIBLE);
        mTitleTextView.setText(getResources().getString(R.string.ynf_ptr_refresh_complete));

        // update last update time
        SharedPreferences sharedPreferences = getContext().getSharedPreferences(KEY_SharedPreferences, 0);
        if (!TextUtils.isEmpty(mLastUpdateTimeKey)) {
            mLastUpdateTime = new Date().getTime();
            sharedPreferences.edit().putLong(mLastUpdateTimeKey, mLastUpdateTime).commit();
        }
    }

    @Override
    public void onUIPositionChange(PtrFrameLayout frame, boolean isUnderTouch, byte status, PtrIndicator ptrIndicator) {

        final int mOffsetToRefresh = frame.getOffsetToRefresh();
        final int currentPos = ptrIndicator.getCurrentPosY();
        final int lastPos = ptrIndicator.getLastPosY();

        mDownHeight = mOffsetToRefresh;
        Log.d("xueli-----------", "currentPos==" + currentPos + ",lastPos==" + lastPos + ",mOffsetToRefresh==" + mOffsetToRefresh
                +"isUnderTouch==" + isUnderTouch);
        if (currentPos < mOffsetToRefresh && lastPos >= mOffsetToRefresh) {
            if (status == PtrFrameLayout.PTR_STATUS_LOADING) {
                crossRotateLineFromBottomUnderTouch(frame);
                if (mRotateView != null) {
                    Log.d("xueli----2------", "mReverseFlipAnimation");
                    mRotateView.clearAnimation();
                    mRotateView.startAnimation(mReverseFlipAnimation);
                }
            }
        } else if (currentPos > mOffsetToRefresh && lastPos <= mOffsetToRefresh) {
            if (isUnderTouch && status == PtrFrameLayout.PTR_STATUS_PREPARE) {
                crossRotateLineFromTopUnderTouch(frame);
                if (mRotateView != null) {
                    Log.d("xueli----1------", "mFlipAnimation");
                    mRotateView.clearAnimation();
                    mRotateView.startAnimation(mFlipAnimation);
                }
            }
        }
    }

    private void crossRotateLineFromTopUnderTouch(PtrFrameLayout frame) {
        if (!frame.isPullToRefresh()) {
            mTitleTextView.setVisibility(VISIBLE);
            mTitleTextView.setText(R.string.ynf_ptr_release_to_refresh);
        }
    }

    private void crossRotateLineFromBottomUnderTouch(PtrFrameLayout frame) {
        mTitleTextView.setVisibility(VISIBLE);
        if (frame.isPullToRefresh()) {
            mTitleTextView.setText(getResources().getString(R.string.ynf_ptr_pull_down_to_refresh));
        } else {
            mTitleTextView.setText(getResources().getString(R.string.ynf_ptr_pull_down));
        }
    }
}

改完了之后，要注意的一点就是把除了PtrClassicDefaultHeader以外，用到PtrClassicDefaultHeader的地方，把名字都改成SherryPtrClassicDefaultHeader，其实也就是PtrClassicFrameLayout类中的PtrClassicDefaultHeader。

三、下拉刷新控件的使用

首先看布局文件：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:cube_ptr="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@color/gray_shallow"
    android:orientation="vertical">

    <include layout="@layout/title" />

    <in.srain.cube.views.ptr.PtrClassicFrameLayout
        android:id="@+id/ptr_my_coupon"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        cube_ptr:ptr_duration_to_close="200"
        cube_ptr:ptr_duration_to_close_header="1000"
        cube_ptr:ptr_keep_header_when_refresh="true"
        cube_ptr:ptr_pull_to_fresh="false"
        cube_ptr:ptr_ratio_of_header_height_to_refresh="1.2"
        cube_ptr:ptr_resistance="1.7">

        <RelativeLayout
            android:layout_width="match_parent"
            android:layout_height="match_parent">

            <ListView
                android:id="@+id/lv_my_coupon"
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:cacheColorHint="@android:color/transparent"
                android:divider="@null"
                android:fadingEdge="none"
                android:fastScrollEnabled="false"
                android:listSelector="@null"
                android:overScrollMode="never"
                android:scrollbars="none" />

            <include
                android:id="@+id/my_coupons_empty"
                layout="@layout/my_coupon_empty"
                android:visibility="gone" />
        </RelativeLayout>
    </in.srain.cube.views.ptr.PtrClassicFrameLayout>

</LinearLayout>

从布局文件我们可以看到，这里我们是直接使用了<in.srain.cube.views.ptr.PtrClassicFrameLayout />，然后在这个FrameLayout里面再放入我们想要下拉刷新显示的布局，要注意的是，这个里面只能有一个子View，不然会报错，所以这里可以看到的是我用的一个相对布局，那么在代码里面当页面为空时，我可以设置ListView不可见，然后显示页面为空时的布局，也就是my_coupon_empty布局文件。

附上java类里面使用的主要代码：

vPtrClsFl = (PtrClassicFrameLayout) findViewById(R.id.ptr_my_coupon);
vPtrClsFl.setPtrHandler(new PtrHandler() {
     @Override
     public boolean checkCanDoRefresh(PtrFrameLayout frame, View content, View header) {
         return PtrDefaultHandler.checkContentCanBePulledDown(frame, content, header);
     }

     @Override
     public void onRefreshBegin(PtrFrameLayout frame) {
         // 调接口拿数据
    }
});

好的，那么以上就是我学习与使用下拉刷新框架Android-Ultra-Pull-To-Refresh的一些小心得，有不对的地方欢迎大家指正，转载请附链接。

下拉刷新框架Android-Ultra-Pull-To-Refresh的学习与

热门文章

最新文章

相关课程

相关电子书

热门

活动广场

任务中心

开发者评测

高校计划

乘风者计划

训练营

阿里云MVP

话题

直播

下载

镜像站

技术资料

插件

下拉刷新框架Android-Ultra-Pull-To-Refresh的学习与

热门文章

最新文章

相关课程

相关电子书