Merge pull request #2815 from AllenCoder/androidx

Merge remote-tracking branch 'remotes/remote/master' into androidx

Author: AllenCoder

.circleci/config.yml

@@ -3,7 +3,7 @@ jobs:
   build:
     working_directory: ~/code
     docker:
-      - image: circleci/android:api-26-alpha
+      - image: circleci/android:api-28-alpha
     environment:
       JVM_OPTS: -Xmx3200m
     steps:

.github/pull_request_template.md

@@ -0,0 +1,7 @@
+Thank you for contributing to BaseRecyclerViewAdapterHelper. Before pressing the "Create Pull Request" button, please consider the following points:
+
+  - [1] Please give a description about what and why you are contributing, even if it's trivial.
+
+  - [2] Please include the issue list number(s) or other PR numbers in the description if you are contributing in response to those.
+
+  - [3] Please include a reasonable set of demo tests if you contribute new code or change an existing one. please make sure you have demo for working correctly.

.travis.yml

@@ -1,20 +1,21 @@
 language: android
+dist: trusty
 jdk: oraclejdk8
 sudo: false
 
 android:
 components:
     - tools
     - platform-tools
-    - build-tools-27.0.2
-    - android-27
+    - build-tools-28.0.3
+    - android-28
     - extra-android-m2repository
     - extra-android-support
 before_install:
   - chmod +x gradlew
   - mkdir "$ANDROID_HOME/licenses" || true
   # Hack to accept Android licenses
-  - yes | sdkmanager "platforms;android-27"
+  - yes | sdkmanager "platforms;android-28"
 
 script:
   - ./gradlew assembleRelease

README-cn.md

@@ -163,7 +163,7 @@ Activity
                 Toast.makeText(RecyclerClickItemActivity.this, "" + Integer.toString(position), Toast.LENGTH_SHORT).show();
             }
         });
-``` 
+```
 
 
 # 如何使用它添加动画？
@@ -413,6 +413,85 @@ protected K createBaseViewHolder(View view) {
 
 ```
 
+# DiffUtil
+先继承`BaseQuickDiffCallback<T>`并实现：
+```java
+public class DiffDemoCallback extends BaseQuickDiffCallback<DiffUtilDemoEntity> {
+
+    public DiffDemoCallback(@Nullable List<DiffUtilDemoEntity> newList) {
+        super(newList);
+    }
+
+    /**
+     * 判断是否是同一个item
+     *
+     * @param oldItem New data
+     * @param newItem old Data
+     * @return
+     */
+    @Override
+    protected boolean areItemsTheSame(DiffUtilDemoEntity oldItem, DiffUtilDemoEntity newItem) {
+……
+    }
+
+    /**
+     * 当是同一个item时，再判断内容是否发生改变
+     *
+     * @param oldItem New data
+     * @param newItem old Data
+     * @return
+     */
+    @Override
+    protected boolean areContentsTheSame(DiffUtilDemoEntity oldItem, DiffUtilDemoEntity newItem) {
+……
+    }
+
+    /**
+     * 可选实现
+     * 如果需要精确修改某一个view中的内容，请实现此方法。
+     * 如果不实现此方法，或者返回null，将会直接刷新整个item。
+     *
+     * @param oldItem Old data
+     * @param newItem New data
+     * @return Payload info. if return null, the entire item will be refreshed.
+     */
+    @Override
+    protected Object getChangePayload(DiffUtilDemoEntity oldItem, DiffUtilDemoEntity newItem) {
+……
+    }
+}
+```
+
+`BaseQuickAdapter`中实现`convertPayloads()`方法，用于局部更新：
+```java
+    /**
+     *
+     * 当有 payload info 时，只会执行此方法
+     *
+     * @param helper   A fully initialized helper.
+     * @param item     The item that needs to be displayed.
+     * @param payloads payload info.
+     */
+    @Override
+    protected void convertPayloads(BaseViewHolder helper, DiffUtilDemoEntity item, @NonNull List<Object> payloads) {
+        for (Object p : payloads) {
+……
+        }
+    }
+```
+
+更新整个数据集时，使用如下方法：
+```java
+DiffDemoCallback callback = new DiffDemoCallback(getNewList());
+mAdapter.setNewDiffData(callback);
+```
+
+更新单个item时，使用如下方法：
+```java
+mAdapter.notifyItemChanged(0, "payload info");
+```
+
+
 >**持续更新!，所以推荐Star项目**
 
 # 感谢

README.md

@@ -29,6 +29,7 @@ kotlin demo :[BRVAH_kotlin](https://github.com/AllenCoder/BRVAH_kotlin)
 -keepclassmembers  class **$** extends com.chad.library.adapter.base.BaseViewHolder {
      <init>(...);
 }
+-keepattributes InnerClasses
 ```
 
 # Extension library

app/build.gradle

@@ -5,7 +5,7 @@ android {
 
     defaultConfig {
         applicationId "com.chad.baserecyclerviewadapterhelper"
-        minSdkVersion 14
+        minSdkVersion 16
         targetSdkVersion 28
         versionCode 5
         versionName "2.1"
@@ -24,9 +24,8 @@ android {
 }
 
 dependencies {
-    implementation fileTree(include: ['*.jar'], dir: 'libs')
+    implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
     implementation project(path: ':library')
-    implementation project(':material-spinner-1.0.5')
     implementation 'com.google.android.material:material:1.0.0'
     implementation 'androidx.cardview:cardview:1.0.0'
     implementation 'androidx.appcompat:appcompat:1.0.2'

material-spinner-1.0.5/material-spinner-1.0.5.aar renamed to app/libs/material-spinner-1.0.5.aar

@@ -1,16 +1,8 @@
 package com.chad.baserecyclerviewadapterhelper;
 
-import android.app.Application;
-import android.test.ApplicationTestCase;
-
 /**
  * <a href="http://d.android.com/tools/testing/testing_android.html">Testing Fundamentals</a>
  */
-public class ApplicationTest extends ApplicationTestCase<Application> {
-    public ApplicationTest() {
-        super(Application.class);
-    }
-    public void test() {
-        
-    }
+public class ApplicationTest {
+
 }

app/src/androidTest/java/com/chad/baserecyclerviewadapterhelper/ApplicationTest.java

@@ -36,6 +36,7 @@
             android:launchMode="singleTask"></activity>
         <activity android:name=".UpFetchUseActivity" />
         <activity android:name=".SectionMultipleItemUseActivity" />
+        <activity android:name=".DiffUtilActivity" />
     </application>
 
 </manifest>

app/src/main/AndroidManifest.xml

@@ -24,8 +24,6 @@
 public class AnimationUseActivity extends Activity {
     private RecyclerView mRecyclerView;
     private AnimationAdapter mAnimationAdapter;
-    private ImageView mImgBtn;
-    private int mFirstPageItemCount = 3;
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
@@ -41,7 +39,7 @@ protected void onCreate(Bundle savedInstanceState) {
 
     private void initView() {
 
-        mImgBtn = (ImageView) findViewById(R.id.img_back);
+        ImageView mImgBtn = (ImageView) findViewById(R.id.img_back);
         mImgBtn.setOnClickListener(new View.OnClickListener() {
             @Override
             public void onClick(final View v) {
@@ -53,6 +51,7 @@ public void onClick(final View v) {
     private void initAdapter() {
         mAnimationAdapter = new AnimationAdapter();
         mAnimationAdapter.openLoadAnimation();
+        int mFirstPageItemCount = 3;
         mAnimationAdapter.setNotDoAnimationCount(mFirstPageItemCount);
         mAnimationAdapter.setOnItemChildClickListener(new BaseQuickAdapter.OnItemChildClickListener() {
             @Override
@@ -73,6 +72,8 @@ public void onItemChildClick(BaseQuickAdapter adapter, View view, int position)
                         Toast.makeText(AnimationUseActivity.this, content, Toast.LENGTH_LONG).show();
                         // you have set clickspan .so there should not solve any click event ,just empty
                         break;
+                    default:
+                        break;
 
                 }
             }
@@ -112,7 +113,8 @@ public void onItemSelected(MaterialSpinner view, int position, long id, String i
                 mRecyclerView.setAdapter(mAnimationAdapter);
             }
         });
-        mAnimationAdapter.isFirstOnly(false);//init firstOnly state
+        //init firstOnly state
+        mAnimationAdapter.isFirstOnly(false);
         SwitchButton switchButton = (SwitchButton) findViewById(R.id.switch_button);
         switchButton.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
             @Override