傳送門（最新文檔信息請(qǐng)?zhí)D(zhuǎn)到github查看）

https://github.com/youth5201314/banner

現(xiàn)在的絕大數(shù)app都有banner界面，實(shí)現(xiàn)循環(huán)播放多個(gè)廣告圖片和手動(dòng)滑動(dòng)循環(huán)等功能。因?yàn)閂iewPager并不支持循環(huán)翻頁，
所以要實(shí)現(xiàn)循環(huán)還得需要自己去動(dòng)手，我就把項(xiàng)目中的控件剔了出來，希望大家覺得有用。目前框架可以進(jìn)行不同樣式、不同動(dòng)畫設(shè)置，
以及完善的api方法能滿足大部分的需求了。

效果圖

模式	圖片
指示器模式	效果示例
數(shù)字模式	效果示例
數(shù)字加標(biāo)題模式	效果示例
指示器加標(biāo)題模式 垂直顯示	效果示例
指示器加標(biāo)題模式 水平顯示	效果示例

聯(lián)系方式

效果示例

• 如果遇到問題和建議歡迎在給我發(fā)送郵件或者加入qq群，希望讓這個(gè)工程越來越完善。

常量

動(dòng)畫常量類（setBannerAnimation方法調(diào)用）

方法

Attributes屬性（banner布局文件中調(diào)用）

<a > [ 點(diǎn)擊查看 ViewPager的PageTransformer用法 ]</a>

使用步驟

Step 1.依賴banner

Gradle

dependencies{
    compile 'com.youth.banner:banner:1.4.8'  //最新版本
    or
    compile 'com.youth.banner:banner:1.3.3' //舊版本，舊版本用法下面有跳轉(zhuǎn)鏈接
}

或者引用本地lib

compile project(':banner')

Step 2.添加權(quán)限到你的 AndroidManifest.xml

<!-- if you want to load images from the internet -->
<uses-permission android:name="android.permission.INTERNET" /> 

<!-- if you want to load images from a file OR from the internet -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

Step 3.在布局文件中添加Banner，可以設(shè)置自定義屬性

?。?！此步驟可以省略，直接在Activity或者Fragment中new Banner();

<com.youth.banner.Banner
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/banner"
    android:layout_width="match_parent"
    android:layout_height="高度自己設(shè)置" />

Step 4.重寫圖片加載器

public class GlideImageLoader extends ImageLoader {
    @Override
    public void displayImage(Context context, Object path, ImageView imageView) {
        /**
          常用的圖片加載庫(kù)：
          Universal Image Loader：一個(gè)強(qiáng)大的圖片加載庫(kù)，包含各種各樣的配置，最老牌，使用也最廣泛。      
          Picasso: Square出品，必屬精品。和OkHttp搭配起來更配呦！          
          Volley ImageLoader：Google官方出品，可惜不能加載本地圖片~          
          Fresco：Facebook出的，天生驕傲！不是一般的強(qiáng)大。         
          Glide：Google推薦的圖片加載庫(kù)，專注于流暢的滾動(dòng)。
         */
         
        //Glide 加載圖片簡(jiǎn)單用法
        Glide.with(context).load(path).into(imageView);

        //Picasso 加載圖片簡(jiǎn)單用法
        Picasso.with(context).load(path).into(imageView)
        
        //用fresco加載圖片簡(jiǎn)單用法
        Uri uri = Uri.parse((String) path);
        imageView.setImageURI(uri);
    }
    //提供createImageView 方法，如果不用可以不重寫這個(gè)方法，方便fresco自定義ImageView
    @Override
    public ImageView createImageView(Context context) {
        SimpleDraweeView simpleDraweeView=new SimpleDraweeView(context);
        return simpleDraweeView;
    }
}

Step 5.在Activity或者Fragment中配置Banner

--------------------------簡(jiǎn)單使用-------------------------------
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    Banner banner = (Banner) findViewById(R.id.banner);
    //設(shè)置圖片加載器
    banner.setImageLoader(new GlideImageLoader());
    //設(shè)置圖片集合
    banner.setImages(images);
    //banner設(shè)置方法全部調(diào)用完畢時(shí)最后調(diào)用
    banner.start();
}
--------------------------詳細(xì)使用-------------------------------
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    Banner banner = (Banner) findViewById(R.id.banner);
    //設(shè)置banner樣式
    banner.setBannerStyle(BannerConfig.CIRCLE_INDICATOR_TITLE);
    //設(shè)置圖片加載器
    banner.setImageLoader(new GlideImageLoader());
    //設(shè)置圖片集合
    banner.setImages(images);
    //設(shè)置banner動(dòng)畫效果
    banner.setBannerAnimation(Transformer.DepthPage);
    //設(shè)置標(biāo)題集合（當(dāng)banner樣式有顯示title時(shí)）
    banner.setBannerTitles(Arrays.asList(titles));
    //設(shè)置自動(dòng)輪播，默認(rèn)為true
    banner.isAutoPlay(true);
    //設(shè)置輪播時(shí)間
    banner.setDelayTime(1500);
    //設(shè)置指示器位置（當(dāng)banner模式中有指示器時(shí)）
    banner.setIndicatorGravity(BannerConfig.CENTER);
    //banner設(shè)置方法全部調(diào)用完畢時(shí)最后調(diào)用
    banner.start();
}
-----------------當(dāng)然如果你想偷下懶也可以這么用--------------------
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    Banner banner = (Banner) findViewById(R.id.banner);
    banner.setImages(images).setImageLoader(new GlideImageLoader()).start();
}

混淆代碼

# glide 的混淆代碼
-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
  **[] $VALUES;
  public *;
}
# banner 的混淆代碼
-keep class com.youth.banner.** {
    *;
 }

<a > [歷史版本資源地址]</a>

<a > [1.3.3以前舊版本文檔地址]</a>

常見問題

• 問：eclipse怎么使用banner？

  • 答：在歷史版本列表中下載你想要版本的aar包提取最新資源/也可以自己把工程轉(zhuǎn)成eclipse的
    
    eclipse的集成demo群文件里有共享！

• 問：怎么顯示的一片空白？

  • 答：
    
    1、沒有添加網(wǎng)絡(luò)權(quán)限就抱怨有問題，然后就拒絕使用，我能說什么？
    
    2、檢查圖片鏈接是否能打開。

• 問：怎么加載其他圖片資源（資源文件、文件、Uri、assets、raw、ContentProvider、sd卡資源）？

  • 答：列如！如果你使用的是glide，那么可以如下操作，其他圖片圖片加載框架可能有不同

    //資源文件
    Integer[] images={R.mipmap.a,R.mipmap.b,R.mipmap.c};
    //Uri
    Uri uri = resourceIdToUri(context, R.mipmap.ic_launcher);
    Uri[] images={uri};
    //文件對(duì)象
    File[] images={"文件對(duì)象","文件對(duì)象"};
    //raw 兩種方式
    String[] images={"Android.resource://com.frank.glide/raw/raw_1"};
    String[] images={"android.resource://com.frank.glide/raw/"+R.raw.raw_1"};
    //ContentProvider
    String[] images={"content://media/external/images/media/139469"};
    //assets
    String[] images={"file:///android_asset/f003.gif"};
    //sd卡資源
    String[] images={"file://"+ Environment.getExternalStorageDirectory().getPath()+"/test.jpg"};
    
    banner.setImages(images);//這里接收數(shù)組和集合都行