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
- Perfect for Android7.0 FileUriExposedException.
- Support component:
Activity
、Fragment
. - UI style can be configured, for example:
Toolbar
、StatusBar
、NavigationBar
. - Radio, multi-select, folder preview, gallery, gallery zoom.
- Support setting album number.
- Support for configuring whether to use the camera.
- Gallery preview multiple pictures, preview can be anti-election.
- Support for custom LocalImageLoader, such as:
Glide
,Picasso
,ImageLoder
.
Screenshot
Please experience download apk.
Dependencies
- Gradle:
compile 'com.yanzhenjie:album:1.0.2'
- Maven:
<dependency>
<groupId>com.yanzhenjie</groupId>
<artifactId>album</artifactId>
<version>1.0.2</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 theposition
in thelist
.
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:
- LocalImageLoader
- Glide
- 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
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.