Skip to content

Latest commit

 

History

History
255 lines (190 loc) · 11 KB

README.md

File metadata and controls

255 lines (190 loc) · 11 KB
Raw

EasyPhotos

EasyPhotos会帮助你快速实现android的拍照、相册与文件夹中图片选择（单选/多选）、相册选择界面的广告View填充，展示图片宽高限制、图片预览（含缩放）、图片添加水印、拼图、保存图片到指定文件夹、把View画成Bitmap、媒体文件更新到媒体库、自定义UI等功能，而无需考虑运行时权限、无图片显示、工具库与应用UI不统一等问题。  

无选中状态 相册单选 相册多选
相册带相机 相册带相机带广告 专辑列表
专辑列表带广告 预览页 预览页单击图片转全屏模式
预览页缩放图片 预览页单击缩放图片显示操作栏 拼图界面

关于EasyPhotos的SDK及相关版本公示

compileSdkVersion 26
minSdkVersion 15
targetSdkVersion 26
buildToolsVersion '26.0.2'

获取EasyPhotos（通过Gradle方式）

首先，在项目的 build.gradle（project） 文件里面添加:

allprojects {
	repositories {  
	
	//EasyPhotos的  
        maven { url "https://jitpack.io" }
	
	//以下是Glide的
	mavenCentral()
  	maven { url 'https://maven.google.com' }
    }
}

最后，在你需要用到EasyPhotos的module中的 build.gradle（module） 文件里面添加：

dependencies {  

    //这个是EasyPhotos
    compile 'com.github.HuanTanSheng:EasyPhotos:1.3.2'  
    
    //以下是Glide
    compile 'com.github.bumptech.glide:glide:4.3.0'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.3.0'  
    
    //以下是PhotoView
    compile 'com.github.chrisbanes:PhotoView:2.1.3'
}

为什么要添加Glide和PhotoView的引用呢？
答：EasyPhotos使用了两个开源库的功能，他们是Glide 4.x和PhotoView。
因为他们足够热门，所以为了避免给你造成重复引用的可能，EasyPhotos中对他们进行了provided方式（只编译不打包场景的命令）的引用，可以理解为EasyPhotos并没有真正获取她们，所以需要你在项目中对她们进行引用依赖。        

  • 如果在引用的时候发生如下错误 ( 如果用android studio 3.0.0以上正式版，将不会出现这个问题 ) :     Error:Failed to resolve: annotationProcessor
    Error:Failed to resolve: com.android.support:support-annotations:26.0.2
    这个应该是引用Glide时发生的，推荐你将 android studio 升级到3.0.0以上正式版，或者在你所有的build.gradle（module）文件里面添加（我并不推荐这样做，还是建议你将 android studio 升级到3.0.0以上正式版）：  
configurations.all {
    resolutionStrategy.force 'com.android.support:support-annotations:23.1.1'
}
  • 如果你的 android studio 版本不同于3.0.1正式版，有可能会打不开我的Demo，只需要修改Demo里面 build.gradle（project） 文件中的：  
dependencies {
        classpath 'com.android.tools.build:gradle:3.0.1'
	//把3.0.1改成你对应的版本即可，如果不清楚对应版本可以看看你其他正常项目的这里是怎么写的  
	}

关于混淆    

EasyPhotos的混淆：

-keep class com.huantansheng.easyphotos.constant.** { *; }  
-keep class com.huantansheng.easyphotos.models.** { *; }

Glide 4.x的混淆：

-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public class * extends com.bumptech.glide.AppGlideModule
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
    **[] $VALUES;
    public *;
}

PhotoView的混淆：

不需要任何处理

EasyPhotos文档总录

EasyPhotos文档总录

感谢

Glide：我心目中最好的图像加载和缓存库，由Bump Technologies 团队编写    

PhotoView：一个强大的图片缩放库，由chrisbanes 大神编写

PuzzleView：一个强大的拼图库，我的拼图功能是在此基础上实现，这个库由wuapnjie 编写，因对其不了解，不妄作评价，推荐大家去关注一下。

编者语

EasyPhotos将在高颜值、高兼容、高性能、强功能的道路上持续更新，欢迎各种Issues，我将及时反馈，谢谢！

更新日志

1.3.2：  

  • 新增功能：
    • 拼图（最多对9张图片进行拼图，无需关心运行时权限，内部处理好了）    
    • 把View画成Bitmap
    • 保存bitmap到本地（可设置是否更新到媒体库，如果调用此方法前没有进入过EasyPhotos的相册或相机，则需要你自己处理读写权限）    
  • 更换相册单选的选中图标样式
  • 修复回调选中地址的key：RRESULT_PATHS 修复为 RESULT_PATHS。（ps：对如此智障的疏忽表示歉意。）
  • 修复永久不给权限情况下，退出相册时发生的错误
  • 修复调用系统权限设置页返回时，相册页面或拼图页面自销毁情况
  • 新增字符串：    
    <string name="done_easy_photos">完成</string>
    <string name="cancel_easy_photos">取消</string>
    <string name="template_easy_photos">模板</string>
  • 新增色值：
    <!--图片预览页-->
    <color name="preview_status_easy_photos">#d73c3d41</color>//api21以上预览页状态栏颜色为该色值；api19和api20状态栏为透明色；其余api状态栏或透明或黑或灰，取决于各家rom和有无实体按键等因素。注：其余页面状态栏根据你的主题走

    <!--拼图页-->
    <color name="puzzle_background_easy_photos">#000000</color>//拼图页面背景色
    <color name="puzzle_selected_frame_easy_photos">#57a457</color>//拼图页面当前处理item的边框颜色
    <color name="puzzle_selected_controller_easy_photos">#00AA00</color>//拼图页面当前处理item的操作bar颜色，就是item边框中凸起矩形的色值
    <color name="puzzle_menu_easy_photos">#969696</color>//拼图页面的文字按钮和示例图片颜色
    <color name="puzzle_menu_done_easy_photos">#009700</color>//拼图页面的完成按钮文字颜色
    <color name="puzzle_bottom_bar_line_easy_photos">#ee3a3a3e</color>//拼图的底部栏间隔颜色
    <color name="puzzle_photo_background">#ffffff</color>//图片的背景颜色

1.2.8：

  • 修复'选中图片列表'点击状态下与'大图列表和选择器'的联动错误

1.2.7：    

  • 大图预览页新增：大图列表与选中图片列表联动
  • 升级 classpath 'com.android.tools.build:gradle:3.0.1'
  • 新增色值：    
<color name="preview_bottom_bar_easy_photos">#eb212123</color>//预览页的底部栏和选中图片列表背景颜色    
<color name="preview_bottom_bar_line_easy_photos">#ee3a3a3e</color>//预览页的底部栏与选中图片列表的分割线颜色    

1.2.6：

  • 正式开放，投入使用
  • 广告view可以传空，适用于VIP不显示广告场景

1.2.3：

  • 优化图片限制方式：最小宽度、最小高度、最小文件大小
  • 如果单一设置，满足条件即过滤
  • 如果多项设置，满足一项即过滤    

1.2.2：

  • 新增返回结果：图片地址集合
  • 新增返回结果：用户是否选中原图选项
  • 新增返回结果：图片信息集合
  • 新增设置默认勾选图片集合方式：图片地址集合
  • 新增设置默认勾选图片集合方式：图片信息集合

1.2.1：

  • 优化预览界面全屏动效
  • 优化Photo实体对象

1.2.0：

  • 升级图片选取返回信息（图片地址/宽高/文件大小/文件修改时间/文件类型/用户是否点击原图选项/文件名）
  • 图片选择新增原图选项
  • 预览界面支持选择完成
  • 预览界面支持当前图片位置显示

1.1.1：  

  • 优化相机和相册的调用API，使之更加友好    

1.1.0：  

  • 增加图片添加水印功能  
  • 增加媒体文件更新到媒体库功能

1.0.9：  

  • 优化三星部分机型因图片更新到媒体库时没有更新宽高信息时EasyPhotos相册不显示该图片问题

1.0.8：  

  • 优化自定义UI和多语言

1.0.7：  

  • 性能优化

1.0.6：  

  • 修复华为VNS-L31机型拍照无返回问题

1.0.5：

  • 修复拍照切换横竖屏发生内存泄漏
  • 修复切换语言时产生错误
  • 升级glide为最新版4.3.0

1.0.4：

  • 直接启动相机
  • 相册单选
  • 相册多选
  • 相册中支持添加自定义广告
  • 图片预览（缩放/全屏）
  • UI可定制
  • 根据图片宽高进行过滤
  • 修复无图片显示时的异常
  • 内部处理权限问题，无需配置，无需处理运行时权限