Album
is a MaterialDesign tyle open source album, the main function is: Album, Camera and Gallery
.
Image crop library Durban: https://github.com/yanzhenjie/Durban
- Perfect for Android7.0 FileUriExposedException.
- Support component:
Activity
、Fragment
. - UI style can be configured, for example:
Toolbar
、StatusBar
、NavigationBar
. - Album: Radio, multi-select, folder preview.
- Camera: call alone, as the item of the album.
- Gallery: Support zoom, browse local pictures and network pictures.
- Configure the album's number of columns, configure the album if there is a camera.
- Gallery preview multiple pictures, preview can be anti-election.
- Support for custom LocalImageLoader, such as:
Glide
,Picasso
,ImageLoder
. - Support and use the image crop library Durban.
Please experience download apk.
- Gradle:
compile 'com.yanzhenjie:album:1.0.6'
- Maven:
<dependency>
<groupId>com.yanzhenjie</groupId>
<artifactId>album</artifactId>
<version>1.0.6</version>
<type>pom</type>
</dependency>
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" />
<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. - The repository version of the
support-library
is25.3.1
, if your version is higher than25.3.1
, you need to explicitly specify the version ofCardView
.
Album's main function is: Album, Camera and Gallery
, the following are described separately.
Use Album.album(context).start()
to call up the Album
.
Album.album(context)
.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:
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if(requestCode == 999) {
if (resultCode == RESULT_OK) { // Successfully.
// Parse select result.
ArrayList<String> imageList = Album.parseResult(data);
} else if (resultCode == RESULT_CANCELED) {
// User canceled.
}
}
}
Cut the selection results, then use Durban.
Use the Album.camera(context).start ()
to call up the Camera
, has handled the RunTimePermissions and Android7.0 FileProvider
Album.camera(context)
.requestCode(666)
// .imagePath() // Specify the image path, optional.
.start();
Accept the result:
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if(requestCode == 666) {
if (resultCode == RESULT_OK) { // Successfully.
// The size of the pathList is 1.
List<String> pathList = Album.parseResult(data); // Parse path.
} else if (resultCode == RESULT_CANCELED) {
// User canceled.
}
}
}
Cut the selection results, then use Durban.
Use the Album.gallery(context).start ()
to call up the Gallery
, default support for previewing local images, preview the network pictures need to configure ImageLoader
, see below for details.
Call you only need to pass in a path set:
Album.gallery(context)
.requestCode(444) // 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:
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if(requestCode == 444) {
if (resultCode == RESULT_OK) { // Successfully.
// Parse select result.
ArrayList<String> imageList = Album.parseResult(data);
} else if (resultCode == RESULT_CANCELED) {
// User canceled.
}
}
}
This configuration is not necessary, not configured can also be used:
ImageLoader
, the default use of 'LocalImageLoader, you can use
Glideand
Picasso` and other third-party framework to achieve.Locale
, the default has been supported international, and support Simplified Chinese, Traditional Chinese, English. If you want to specify the language, you can use theLocale
configuration.
I recommend using the default ImageLoader
first, followed by Glide
, followed by Picasso
, and finally ImageLoader
, which does not support Fresco
for the time being.
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()
);
}
}
Use 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()
Use 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()
If there is a problem, add the rule to the proguard-rules:
-dontwarn com.yanzhenjie.album.**
-keep class com.yanzhenjie.album.**{*;}
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.