Android实用开源—BGA系列

2019-11-09 16:12:00

字体：大中小

来源：转载

供稿：网友

BGARefreshLayout下拉刷新 ——介绍

这里写图片描述功能介绍 引导界面滑动导航 + 大于等于1页时无限轮播 + 各种切换动画轮播效果 引导界面导航效果支持根据服务端返回的数据动态设置广告条的总页数支持大于等于1页时的无限循环自动轮播、手指按下暂停轮播、抬起手指开始轮播支持自定义指示器位置和广告文案位置支持图片指示器和数字指示器支持 ViewPager 各种切换动画支持选中特定页面支持监听 item 点击事件加载网络数据时支持占位图设置，避免出现整个广告条空白的情况多个 ViewPager 跟随滚动 1.添加 Gradle 依赖

Maven Central bga-banner 后面的「latestVersion」指的是左边这个 maven-central 徽章后面的「数字」，请自行替换。

dependencies { compile 'com.android.support:support-v4:latestVersion' compile 'cn.bingoogolapple:bga-banner:latestVersion@aar'}

2.在布局文件中添加 BGABanner

<cn.bingoogolapple.bgabanner.BGABanner android:id="@+id/banner_guide_content" style="@style/MatchMatch" app:banner_pageChangeDuration="1000" app:banner_pointAutoPlayAble="false" app:banner_pointContainerBackground="@android:color/transparent" app:banner_pointDrawable="@drawable/bga_banner_selector_point_hollow" app:banner_pointTopBottomMargin="15dp" app:banner_transitionEffect="alpha" />

3.在 Activity 或者 Fragment 中配置 BGABanner 的数据源

配置数据源的方式1：通过传入数据模型并结合 Adapter 的方式配置数据源。这种方式主要用于加载网络图片，以及实现少于3页时的无限轮播

mContentBanner.setAdapter(new BGABanner.Adapter<ImageView, String>() { @Override public void fillBannerItem(BGABanner banner, ImageView itemView, String model, int position) { Glide.with(MainActivity.this) .load(model) .placeholder(R.drawable.holder) .error(R.drawable.holder) .centerCrop() .dontAnimate() .into(itemView); }});mContentBanner.setData(Arrays.asList("网络图片路径1", "网络图片路径2", "网络图片路径3"), Arrays.asList("提示文字1", "提示文字2", "提示文字3"));

配置数据源的方式2：通过直接传入视图集合的方式配置数据源，主要用于自定义引导页每个页面布局的情况

List<View> views = new ArrayList<>();views.add(BGABannerUtil.getItemImageView(this, R.drawable.ic_guide_1));views.add(BGABannerUtil.getItemImageView(this, R.drawable.ic_guide_2));views.add(BGABannerUtil.getItemImageView(this, R.drawable.ic_guide_3));mContentBanner.setData(views);

配置数据源的方式3：通过传入图片资源 id 的方式配置数据源，主要用于引导页每一页都是只显示图片的情况

mContentBanner.setData(R.drawable.uoko_guide_foreground_1, R.drawable.uoko_guide_foreground_2, R.drawable.uoko_guide_foreground_3);

4.监听广告 item 的单击事件，在 BGABanner 里已经帮开发者处理了防止重复点击事件

mContentBanner.setDelegate(new BGABanner.Delegate<ImageView, String>() { @Override public void onBannerItemClick(BGABanner banner, ImageView itemView, String model, int position) { Toast.makeText(banner.getContext(), "点击了" + position, Toast.LENGTH_SHORT).show(); }});

5.设置「进入按钮」和「跳过按钮」控件资源 id 及其点击事件，如果进入按钮和跳过按钮有一个不存在的话就传 0，在 BGABanner 里已经帮开发者处理了防止重复点击事件，在 BGABanner 里已经帮开发者处理了「跳过按钮」和「进入按钮」的显示与隐藏

mContentBanner.setEnterSkipViewIdAndDelegate(R.id.btn_guide_enter, R.id.tv_guide_skip, new BGABanner.GuideDelegate() { @Override public void onClickEnterOrSkip() { startActivity(new Intent(GuideActivity.this, MainActivity.class)); finish(); }});

自定义属性说明

<declare-styleable name="BGABanner">  <attr name="banner_pointContainerBackground" format="reference|color" />  <attr name="banner_pointDrawable" format="reference" />  <attr name="banner_pointContainerLeftRightPadding" format="dimension" />  <attr name="banner_pointTopBottomMargin" format="dimension" />  <attr name="banner_pointLeftRightMargin" format="dimension" />  <attr name="banner_indicatorGravity"> <flag name="top" value="0x30" /> <flag name="bottom" value="0x50" /> <flag name="left" value="0x03" /> <flag name="right" value="0x05" /> <flag name="center_horizontal" value="0x01" /> </attr>  <attr name="banner_pointAutoPlayAble" format="boolean" />  <attr name="banner_pointAutoPlayInterval" format="integer" />  <attr name="banner_pageChangeDuration" format="integer" />  <attr name="banner_transitionEffect" format="enum"> <enum name="defaultEffect" value="0" /> <enum name="alpha" value="1" /> <enum name="rotate" value="2" /> <enum name="cube" value="3" /> <enum name="flip" value="4" /> <enum name="accordion" value="5" /> <enum name="zoomFade" value="6" /> <enum name="fade" value="7" /> <enum name="zoomCenter" value="8" /> <enum name="zoomStack" value="9" /> <enum name="stack" value="10" /> <enum name="depth" value="11" /> <enum name="zoom" value="12" /> </attr>  <attr name="banner_tipTextColor" format="reference|color" />  <attr name="banner_tipTextSize" format="dimension" />  <attr name="banner_placeholderDrawable" format="reference" />  <attr name="banner_isNumberIndicator" format="boolean" />  <attr name="banner_numberIndicatorTextColor" format="reference|color" />  <attr name="banner_numberIndicatorTextSize" format="dimension" />  <attr name="banner_numberIndicatorBackground" format="reference" />  <attr name="banner_isNeedShowIndicatorOnOnlyOnePage" format="boolean" />  <attr name="banner_contentBottomMargin" format="dimension"/></declare-styleable>

Demo点击查看

BGAQRCode——扫描二维码

点击查看 QRCode 扫描二维码、扫描条形码、相册获取图片后识别、生成带 Logo 二维码、支持微博微信 QQ 二维码扫描样式

BGABadgeView——徽章控件

点击查看

微博底部tab显示最新微博条数微博列表用户头像显示显示右下角vip徽章微信消息界面用户新消息微信消息界面订阅号新消息使用v4包中的RoundedBitmapDrawable制作圆角头像拖拽删除徽章

BGAPhotoPicker——九宫格照片

点击查看将 MeiqiaSDK-Android 里的图库单独抽出来开源，将其中的 GridView、ListView 和 RelativeLayout 换成 RecyclerView 和 Toolbar，方便在以后的项目中直接依赖使用。Demo 中模仿了微信朋友圈的部分功能，详细用法请查看 Demo。希望能该库帮正在做这几个功能的猿友节省开发时间。

单图选择多图选择拍照选择图片选择预览（支持微博长图）、缩放查看图片预览（支持微博长图）、缩放查看支持 glide、picasso、universal-image-loader、xutils 图片加载库支持配置列表滚动时是否暂停加载图片，列表停止滚动时恢复加载图片(用 xutils 作为图片加载库时该配置无效) 正方形、圆形头像、带边框的圆形头像控件朋友圈列表界面的九宫格图片控件发布朋友圈界面的可拖拽排序的九宫格图片控件覆盖相应的资源文件来定制界面

BGASwipeBackLayout—滑动返回

点击查看功能介绍通过修改 support-v4 包中 SlidingPaneLayout 的源码来实现滑动返回布局动态设置滑动返回是否可用动态设置是否仅仅跟踪左侧边缘的滑动返回动态设置是否是微信滑动返回样式动态设置是否显示滑动返回的阴影效果

BGAAdapter——适配器

点击查看在 AdapterView 和 RecyclerView 中通用的 Adapter 和 ViewHolder。

BGAAdapterViewAdapter 和 BGAViewHolderHelper 用于简化 AdapterView 的子类（如 ListView、GridView）的适配器的编写 BGARecyclerViewAdapter 和 BGAViewHolderHelper 用于简化 RecyclerView 的适配器的编写，支持多 Item 类型，支持添加多个 Header 和 Footer，回调接口里的索引位置已经在库里处理了，不需要开发者自己减去 Header 个数 BGABindingRecyclerViewAdapter 和 BGABindingViewHolder 用于 RecyclerView 结合 DataBinding 使用时简化 RecyclerView 的适配器的编写，支持多 Item 类型，支持添加多个 Header 和 Footer，回调接口里的索引位置已经在库里处理了，不需要开发者自己减去 Header 个数

BGAUpdate——更新软件

点击查看 Rxjava + Retrofit 下载新版 apk 文件，RxBus 监听下载进度适配 Android 7.+ 系统检测新版 apk 文件是否已经下载过 RxJava + Retrofit 下载新版 apk 文件 RxBus 监听下载进度安装 apk 文件删除之前升级时下载的老的 apk 文件