Skip to content

Latest commit

 

History

History
236 lines (192 loc) · 8.28 KB

README-CN.md

File metadata and controls

236 lines (192 loc) · 8.28 KB
Raw

Album

Album是一个MD风格的开源相册，主要功能分为两部分：相册选图、画廊预览。

技术交流群：46523908

我的主页：http://www.yanzhenjie.com
我的微博：http://weibo.com/yanzhenjieit

另外文件上传Http框架：https://github.com/yanzhenjie/NoHttp

特性

  1. 完美支持7.0，不存在Android7.0 FileUriExposedException。
  2. 支持组件：Activity、Fragment。
  3. UI风格可以配置，比如：Toolbar、StatusBar、NavigationBar。
  4. 单选、多选、文件夹预览、画廊、画廊缩放。
  5. 支持配置相册展示时的列数。
  6. 支持配置是否使用相机。
  7. 画廊预览选择的图片，预览时可以反选。
  8. 支持自定义LocalImageLoader，例如使用：Glide、Picasso、ImageLoader实现。

效果预览

体验请下载demo的apk。

依赖

  • Gradle：
compile 'com.yanzhenjie:album:1.0.3'
  • Maven:
<dependency>
  <groupId>com.yanzhenjie</groupId>
  <artifactId>album</artifactId>
  <version>1.0.3</version>
  <type>pom</type>
</dependency>
  • Eclipse 请放弃治疗。

mainifest.xml中需要注册

<activity
    android:name="com.yanzhenjie.album.AlbumActivity"
    android:configChanges="orientation|keyboardHidden|screenSize"
    android:theme="@style/Theme.AppCompat.Light.NoActionBar"
    android:windowSoftInputMode="stateAlwaysHidden|stateHidden" />

权限

<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
  • 开发者不需要担心Android6.0运行时权限，Album已经非常完善的处理过了。
  • 另外Android6.0运行时权限推荐使用：AndPermission，如果不使用6.0特性，建议把targetSdkVersion值设置的小于23，这样就不会使用Android6.0运行时权限了。

使用教程

Album主要功能分为两部分：相册选图、画廊预览，下面分别说明。

Album 相册

使用Album.album(this).start()即可调起相册。

Album.album(this)
    .requestCode(999) // 请求码，返回时onActivityResult()的第一个参数。
    .toolBarColor(toolbarColor) // Toolbar 颜色，默认蓝色。
    .statusBarColor(statusBarColor) // StatusBar 颜色，默认蓝色。
    .navigationBarColor(navigationBarColor) // NavigationBar 颜色，默认黑色，建议使用默认。
    .title("图库") // 配置title。
    
    .selectCount(9) // 最多选择几张图片。
    .columnCount(2) // 相册展示列数，默认是2列。
    .camera(true) // 是否有拍照功能。
    .checkedList(mImageList) // 已经选择过得图片，相册会自动选中选过的图片，并计数。
    .start();

重写onActivityResult()方法，接受图片选择结果：

ArrayList<String> mImageList;

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if(requestCode == 999) {
        if (resultCode == RESULT_OK) { // Successfully.
            // 不要质疑你的眼睛，就是这么简单。
            mImageList = Album.parseResult(data);
        } else if (resultCode == RESULT_CANCELED) { // User canceled.
            // 用户取消了操作。
        }
    }
}

Gallery 画廊

使用Album.gallery(this).start()即可调起画廊，画廊只支持预览本地图片，你只需要传入一个图片集合：

Album.gallery(this)
    .requestCode(666) // 请求码，返回时onActivityResult()的第一个参数。
    .toolBarColor(toolbarColor) // Toolbar 颜色，默认蓝色。
    .statusBarColor(statusBarColor) // StatusBar 颜色，默认蓝色。
    .navigationBarColor(navigationBarColor) // NavigationBar 颜色，默认黑色，建议使用默认。
    
    .checkedList(mImageList) // 要预览的图片list。
    .currentPosition(position) // 预览的时候要显示list中的图片的index。
    .checkFunction(true) // 预览时是否有反选功能。
    .start();

注意：

  • 一定要传入要预览的图片集合，否则启动会立即返回。
  • 调用画廊预览时判断if(currentPosition < mImageList.size())，这样才能保证传入的position在list中，否则会立即返回。

如果你需要预览时的反选功能，那么重写onActivityResult()方法，接受反选后的图片List结果：

ArrayList<String> mImageList;

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if(requestCode == 666) {
        if (resultCode == RESULT_OK) { // Successfully.
            // 不要再次质疑你的眼睛，还是这么简单。
            mImageList = Album.parseResult(data);
        } else if (resultCode == RESULT_CANCELED) { // User canceled.
            // 用户取消了操作。
        }
    }
}

高级配置

这个配置不是必须的，不配置也完全可以用，为了照顾强迫症同学，开放配置。

你的App如果使用了任何图片加载框架，比如：Glide、Picasso、ImageLoader，你可以用他们自定义本地图片Loader，不过Album已经提供了一个默认的，所以你不配置也完全可以。

Album提供的默认的LocalImageLoader如下：

public class Application extends android.app.Application {
    @Override
    public void onCreate() {
        super.onCreate();

        Album.initialize(new AlbumConfig.Build()
                .setImageLoader(new LocalImageLoader()) // 使用默认loader.
                .build()
        );
    }
}

根据小伙伴们的测试情况，推荐使用优先级如下：

  1. LocalImageLoader
  2. Glide
  3. Picasso

最后我把用Glide和Picasso的例子也给出来，当然Demo中也有，你也可以下载Demo看。

**注意：**只是在demo中用Glide和Picasso提供了sample，Album库中并没有引入Glide和Picasso。

Glide

public class GlideImageLoader implements AlbumImageLoader {
    @Override
    public void loadImage(ImageView imageView, String imagePath, int width, int height) {
        Glide.with(imageView.getContext())
            .load(new File(imagePath))
            .into(imageView);
    }
}

...

Album.initialize(new AlbumConfig.Build()
    .setImageLoader(new GlideImageLoader()) // Use glide loader.
    .build()

Picasso

public class PicassoImageLoader implements AlbumImageLoader {

    @Override
    public void loadImage(ImageView imageView, String imagePath, int width, int height) {
        Picasso.with(imageView.getContext())
            .load(new File(imagePath))
            .centerCrop()
            .resize(width, height)
            .into(imageView);
    }
}

...

Album.initialize(new AlbumConfig.Build()
    .setImageLoader(new PicassoImageLoader()) // Use picasso loader.
    .build()

混淆

Album是完全可以混淆的，如果混淆后相册出现了问题，请在混淆规则中添加：

-dontwarn com.yanzhenjie.album.**
-keep class com.yanzhenjie.album.**{*;}

Thanks

  1. PhotoView
  2. LoadingDrawable

在此特别感谢上述项目及作者。

关注我的微信公众号
公众号

License

Copyright 2017 Yan Zhenjie

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.