suki-huang/album

Android MaterialDesign-style albums, gallery. Support multi-select, radio, camera support, support preview picture of the selected, preview can be configured whether the anti-election.

Album

Album is an MaterialDesign tyle open source album, the main function is: Album and Gallery.

Image upload recommended NoHttp：NoHttp Open source address.

中文文档

Features

1. Perfect for Android7.0 FileUriExposedException.
2. Support component：Activity、Fragment.
3. UI style can be configured, for example: Toolbar、StatusBar、NavigationBar.
4. Radio, multi-select, folder preview, gallery, gallery zoom.
5. Support setting album number.
6. Support for configuring whether to use the camera.
7. Gallery preview multiple pictures, preview can be anti-election.
8. Support for custom LocalImageLoader, such as: Glide, Picasso, ImageLoder.

Screenshot

Please experience download apk.

Dependencies

• 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>

Register in mainifest.xml

For your application to be better and more stable, a few properties are required, you can also add other, for example: android:screenOrientation="portrait".

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

Permission

<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"/>

• Developers do not need to worry about Android6.0 runtime permissions，Album has been very well handled.
• In addition Android6.0 runtime permissions recommended: AndPermission.

Usage

Album's main function is: Album and Gallery, the following are described separately.

Album

Use Album.album(this).start() to call up the album.

Album.album(this)
    .requestCode(999) // Request code.
    .toolBarColor(toolbarColor) // Toolbar color.
    .statusBarColor(statusBarColor) // StatusBar color.
    .navigationBarColor(navigationBarColor) // NavigationBar color.
    .title("Album") // Title.
    
    .selectCount(9) // Choose up to a few pictures.
    .columnCount(2) // Number of albums.
    .camera(true) // Have a camera function.
    .checkedList(mImageList) // Has selected the picture, automatically select.
    .start();

Accept the result：

ArrayList<String> mImageList;

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if(requestCode == 999) {
        if (resultCode == RESULT_OK) { // Successfully.
            // Parse select result.
            mImageList = Album.parseResult(data);
        } else if (resultCode == RESULT_CANCELED) {
            // User canceled.
        }
    }
}

Gallery

Use the Album.gallery(this).start () to call up the gallery.

Album.gallery(this)
    .requestCode(999) // Request code.
    .toolBarColor(toolbarColor) // Toolbar color.
    .statusBarColor(statusBarColor) // StatusBar color.
    .navigationBarColor(navigationBarColor) // NavigationBar color.
    
    .checkedList(mImageList) // List of pictures to preview.
    .currentPosition(position) // First display position image of the list.
    .checkFunction(true) // Anti-election function.
    .start();

Note:

• Be sure to pass in the collection of pictures you want to preview, otherwise it will return immediately after the start.
• It is recommended to call the gallery preview to judge if(currentPosition < mImageList.size()), to ensure that the entry of the position in the list.

If you need to have an anti-selection function at the time of preview，override the onActivityResult () method, after receiving the anti-selected picture List result:

ArrayList<String> mImageList;

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if(requestCode == 666) {
        if (resultCode == RESULT_OK) { // Successfully.
            // Parse select result.
            mImageList = Album.parseResult(data);
        } else if (resultCode == RESULT_CANCELED) {
            // User canceled.
        }
    }
}

Advanced configuration

This is not something that must be set.

Your application if use the image loading frame: Glide, Picasso, ImageLoader, you can use them to customize the picture loading interface for the album.

Album has provided a default ImageLoader, E.g:

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

        Album.initialize(new AlbumConfig.Build()
                .setImageLoader(new LocalImageLoader()) // Use default loader.
                .build()
        );
    }
}

According to the test, the recommended priority is as follows:

1. LocalImageLoader
2. Glide
3. Picasso

Here are examples of Glide and 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()

Proguard-rules

If there is a problem, add the rule to the proguard-rules:

-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.