Android小白一枚，最近项目中有一个轮播图的需求，网上搜了很多资料，也看了多开源库，但不是bug多就是库不维护。后来在GitHub上找到一个很棒的轮播图–BannerViewPager库推荐个大家。
它的使用方法很简单，也是我看过其他库里边使用最简单的一个。
1.gradle中添加依赖
在项目的root build.gradle中添加如下配置,这个配置是需要添加到项目根目录下的gradel文件中的。
allprojects {
repositories {
...
maven {
url 'https://www.jitpack.io' }
}
}
然后在项目app目录下的gradle中添加BannerViewPager的依赖：
implementation 'com.github.zhpanvip:BannerViewPager:3.4.0'
然后在Activity的布局文件中添加BannerViewPager:
<com.zhpan.bannerview.BannerViewPager
android:id="@+id/banner_view"
android:layout_width="match_parent"
android:layout_margin="10dp"
android:layout_height="160dp" />
2.Banner的页面布局
这个是我们Banner的item页面布局文件，Item的布局必须是"match_parent",否则会抛出一个IllegalStateException.
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<ImageView
android:id="@+id/banner_image"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:scaleType="centerCrop" />
</RelativeLayout>
3.编写Adapter
创建一个BannerAdapter并集成BaseBannerAdapter，BaseBannerAdapter是一个泛型类，需要指定Item的数据的实体类。然后重写getLayoutId方法，返回上边写的布局文件。最后重写bindData方法，并这个方法里边绑定数据即可
public class BannerAdapter extends BaseBannerAdapter<BannerData> {
@Override
protected void bindData(BaseViewHolder<BannerData> holder, BannerData data, int position, int pageSize) {
ImageView imageView = holder.findViewById(R.id.banner_image);
Glide.with(imageView).load(data.getImageUrl()).into(imageView);
}
@Override
public int getLayoutId(int viewType) {
return R.layout.item_banner;
}
}
（5）在Activity中创建BannerViewPager
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
BannerViewPager<BannerData> bannerViewPager = findViewById(R.id.banner_view);
bannerViewPager.setAdapter(new BannerAdapter())
.setLifecycleRegistry(getLifecycle())
.create(getBannerData());
}
private List<BannerData> getBannerData() {
List<BannerData> list = new ArrayList<>();
BannerData bannerData1 = new BannerData();
bannerData1.setImageUrl("https://ss1.baidu.com/9vo3dSag_xI4khGko9WTAnF6hhy/zhidao/pic/item/a044ad345982b2b75133e15130adcbef77099bf3.jpg");
BannerData bannerData2 = new BannerData();
bannerData2.setImageUrl("https://ss0.baidu.com/94o3dSag_xI4khGko9WTAnF6hhy/zhidao/pic/item/d009b3de9c82d1582442d267820a19d8bd3e4220.jpg");
BannerData bannerData3 = new BannerData();
bannerData3.setImageUrl("https://ss3.baidu.com/9fo3dSag_xI4khGko9WTAnF6hhy/zhidao/pic/item/0824ab18972bd407ff38f2b378899e510eb30984.jpg");
list.add(bannerData1);
list.add(bannerData2);
list.add(bannerData3);
return list;
}
因为上边代码中的数据是写死的，可以直接通过create(getBannerData())方法创建数据。但是如果数据是从服务器拿到的则可以调用create()方法，等到拿到服务器数据后在通过refreshData方法刷新即可。代码如下：
bannerViewPager.setAdapter(new BannerAdapter())
.setLifecycleRegistry(getLifecycle())
.create();
bannerViewPager.refreshData(dataList);
这样，就完成了一个自动无限轮播的ViewPager了，并且带有一个默认的圆形指示器，效果如下图所示：
是不是非常简单呢？当然，这还是最基本的用法，这个库还提供了很多的配置，包括页面样式，还有很多炫酷的指示器样式。下边稍微修改一下代码：
bannerViewPager.setAdapter(new BannerAdapter())
.setLifecycleRegistry(getLifecycle())
.setIndicatorSliderColor(getResources().getColor(R.color.purple_200), getResources().getColor(R.color.purple_500))
.setIndicatorSlideMode(IndicatorSlideMode.WORM)
.setPageStyle(PageStyle.MULTI_PAGE_OVERLAP)
.setRevealWidth(getResources().getDimensionPixelOffset(R.dimen.margin))
.create(getBannerData());
相比上边仅仅添加了四行代码，再来看效果：
哈哈，有没有很酷！这个库支持的效果还不仅仅是这些，具体效果大家可以点击BannerViewPager链接到GitHub查看。
最后，欢迎大家点赞呀！
来源：oschina
链接：https://my.oschina.net/u/4281394/blog/4863398