publish v3.0.0

Author: crazycodeboy

README.md

@@ -20,15 +20,41 @@
 
 
 GitHub地址： [https://github.com/crazycodeboy/TakePhoto](https://github.com/crazycodeboy/TakePhoto)
+## 目录
 
-## 预览图  
+- [安装说明](#安装说明)
+- [演示](#演示)
+- [使用说明](#使用说明)
+- [API](#api)
+- [贡献](#贡献)
+
+## 安装说明  
+**Gradle:**  
+
+```groovy
+    compile 'com.jph.takephoto:takephoto_library:3.0.0'
+```
+
+**Maven:**  
+
+```groovy
+<dependency>
+  <groupId>com.jph.takephoto</groupId>
+  <artifactId>takephoto_library</artifactId>
+  <version>3.0.0</version>
+  <type>pom</type>
+</dependency>
+```  
 
-运行效果图：    
 
+## 演示 
+
+运行效果图：    
+![预览图](https://raw.githubusercontent.com/crazycodeboy/TakePhoto/master/Screenshots/takephoto_preview.png)
 ![运行效果图](https://raw.githubusercontent.com/crazycodeboy/TakePhoto/master/Screenshots/%E9%A2%84%E8%A7%88%E5%9B%BE.jpg)
 
 
-## 如何使用   
+## 使用说明   
 
 ### 使用TakePhoto有以下两种方式：
 **方式一：通过继承的方式**  
@@ -37,17 +63,61 @@ GitHub地址： [https://github.com/crazycodeboy/TakePhoto](https://github.com/c
 3. 重写以下方法获取结果        
 
 ```java
-void takeSuccess(String imagePath);  
-void takeFail(String msg);
-void takeCancel();
+ void takeSuccess(TResult result);
+ void takeFail(TResult result,String msg);
+ void takeCancel();
 ```  
-此方式使用简单，满足的大部分的使用需求，具体使用详见simple。如果通过继承的方式无法满足实际项目的使用，可以通过下面介绍的方式。  
+此方式使用简单，满足的大部分的使用需求，具体使用详见[simple](https://github.com/crazycodeboy/TakePhoto/blob/master/simple/src/main/java/com/jph/simple/SimpleActivity.java)。如果通过继承的方式无法满足实际项目的使用，可以通过下面介绍的方式。  
 
 **方式二：通过组装的方式**  
-1. 获取TakePhoto实例`TakePhoto takePhoto=new TakePhotoImpl(getActivity(),this);`  
-2. 在 `onCreate`,`onActivityResult`,`onSaveInstanceState`方法中调用TakePhoto对用的方法。  
-3. 调用TakePhoto实例进行相关操作。  
-4. 在`TakeResultListener`相关方法中获取结果。      
+
+可参照：[TakePhotoActivity](https://github.com/crazycodeboy/TakePhoto/blob/master/takephoto_library/src/main/java/com/jph/takephoto/app/TakePhotoActivity.java)，以下为主要步骤：  
+
+1.实现`TakePhoto.TakeResultListener,InvokeListener`接口。
+
+2.在 `onCreate`,`onActivityResult`,`onSaveInstanceState`方法中调用TakePhoto对用的方法。  
+
+3.重写`onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)`，添加如下代码。
+
+```java
+  @Override
+    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        //以下代码为处理Android6.0、7.0动态权限所需
+        TPermissionType type=PermissionManager.onRequestPermissionsResult(requestCode,permissions,grantResults);
+        PermissionManager.handlePermissionsResult(this,type,invokeParam,this);
+    }
+```    
+
+4.重写`TPermissionType invoke(InvokeParam invokeParam)`方法，添加如下代码：  
+
+```java
+ @Override
+    public TPermissionType invoke(InvokeParam invokeParam) {
+        TPermissionType type=PermissionManager.checkPermission(TContextWrap.of(this),invokeParam.getMethod());
+        if(TPermissionType.WAIT.equals(type)){
+            this.invokeParam=invokeParam;
+        }
+        return type;
+    }
+```
+
+5.添加如下代码获取TakePhoto实例：  
+
+```java
+   /**
+     *  获取TakePhoto实例
+     * @return
+     */
+    public TakePhoto getTakePhoto(){
+        if (takePhoto==null){
+            takePhoto= (TakePhoto) TakePhotoInvocationHandler.of(this).bind(new TakePhotoImpl(this,this));
+        }
+        return takePhoto;
+    }    
+```
+
+## API
 
 ### 获取图片
 TakePhoto提供拍照，从相册选择，从文件中选择三种方式获取图片。    
@@ -68,6 +138,11 @@ void onPickFromGallery();
  * @param outPutUri 图片保存的路径
  */
 void onPickFromCapture(Uri outPutUri);
+/**
+ * 图片多选
+ * @param limit 最多选择图片张数的限制
+ * */
+void onPickMultiple(int limit);
 ```
 以上三种方式均提供对应的裁剪API，详见：[裁剪图片](https://github.com/crazycodeboy/TakePhoto#裁剪图片)。    
 **注：**  
@@ -97,6 +172,12 @@ void onPickFromGalleryWithCrop(Uri outPutUri, CropOptions options);
  * @param options 裁剪配置
  */
 void onPickFromDocumentsWithCrop(Uri outPutUri, CropOptions options);
+/**
+ * 图片多选，并裁切
+ * @param limit 最多选择图片张数的限制
+ * @param options  裁剪配置
+ * /
+void onPickMultipleWithCrop(int limit, CropOptions options);
 ```   
 #### 对指定图片进行裁剪     
 另外，TakePhoto也支持你对指定图片进行裁剪：     
@@ -109,6 +190,12 @@ void onPickFromDocumentsWithCrop(Uri outPutUri, CropOptions options);
  * @param options 裁剪配置
  */
 void onCrop(Uri imageUri, Uri outPutUri, CropOptions options)throws TException;
+/**
+ * 裁剪多张图片
+ * @param multipleCrop 要裁切的图片的路径以及输出路径
+ * @param options 裁剪配置
+ */
+void onCrop(MultipleCrop multipleCrop, CropOptions options)throws TException;
 ```
 
 #### CropOptions
@@ -139,13 +226,15 @@ void onCrop(Uri imageUri, Uri outPutUri, CropOptions options)throws TException;
   * @param showCompressDialog 压缩时是否显示进度对话框
   * @return
   */
- TakePhoto onEnableCompress(CompressConfig config,boolean showCompressDialog);
+ void onEnableCompress(CompressConfig config,boolean showCompressDialog);
 ```
 
 **Usage:**  
 
 ```java
-getTakePhoto().onEnableCompress(compressConfig,true).onPickFromGalleryWithCrop(imageUri,cropOptions);
+TakePhoto takePhoto=getTakePhoto();
+takePhoto.onEnableCompress(compressConfig,true);
+takePhoto.onPickFromGallery();
 ```  
 如果你启用了图片压缩，`TakePhoto`会使用`CompressImage`对图片进行压缩处理，`CompressImage`目前支持对图片的尺寸以及图片的质量进行压缩。默认情况下，`CompressImage`开启了尺寸与质量双重压缩。  
 
@@ -154,16 +243,16 @@ getTakePhoto().onEnableCompress(compressConfig,true).onPickFromGalleryWithCrop(i
 **Usage:**  
 
 ```java
-new CompressImageImpl(compressConfig).compress(picturePath, new CompressImage.CompressListener() {
+new CompressImageImpl(compressConfig,result.getImages(), new CompressImage.CompressListener() {
     @Override
-    public void onCompressSuccess(String imgPath) {//图片压缩成功
-
+    public void onCompressSuccess(ArrayList<TImage> images) {
+        //图片压缩成功
     }
     @Override
-    public void onCompressFailed(String imagePath,String msg) {//图片压缩失败
-
+    public void onCompressFailed(ArrayList<TImage> images, String msg) {
+        //图片压缩失败
     }
-});
+}).compress();
 ```
 
 #### CompressConfig  
@@ -172,12 +261,18 @@ new CompressImageImpl(compressConfig).compress(picturePath, new CompressImage.Co
 
 ```java
 CompressConfig compressConfig=new CompressConfig.Builder().setMaxSize(50*1024).setMaxPixel(800).create();
-getTakePhoto().onEnableCompress(compressConfig,true).onPickFromGallery();
 ```
 
 
 ## 兼容性
 
+### Android6.0
+由于Android6.0新增了"运行时权限控制(Runtime Permissions)"，为了应对这一改变，TakePhoto加入和自动权限管理，当TakePhoto检测到需要权限时，TakePhoto会自动申请权限，所以小伙伴们不用担心，权限的使用问题。
+
+### Android7.0  
+
+在Android N中，Android 框架执行了 StrictMode，应用间共享文件和以前也有所区别。为了适配Android7.0的改变，同时也为了方便大家使用TakePhoto，TakePhoto会自动根据手机的Android版本自行适配，小伙伴们依旧可以向TakePhoto传递`Uri imageUri = Uri.fromFile(file);`类型的Uri而不用担心兼容性问题。
+
 ### TakePhoto在深度兼容性方面的测试    
 ![兼容性测试报告](https://raw.githubusercontent.com/crazycodeboy/TakePhoto/master/Screenshots/%E5%85%BC%E5%AE%B9%E6%80%A7%E6%B5%8B%E8%AF%95.jpg)
 
@@ -200,24 +295,6 @@ eg:
 </activity>
 ```
 
-## 在项目中使用    
-为方便大家使用，现已将TakePhoto V2.0.4发布到JCenter(如果你对如何将项目发布到JCenter感兴趣可以参考：《[教你轻松将Android library 发布到JCenter](http://blog.csdn.net/fengyuzhengfan/article/details/51407009))》  
-Gradle:  
-
-```groovy
-    compile 'com.jph.takephoto:takephoto_library:2.0.4'
-```
-
-Maven:  
-
-```groovy
-<dependency>
-  <groupId>com.jph.takephoto</groupId>
-  <artifactId>takephoto_library</artifactId>
-  <version>2.0.4</version>
-  <type>pom</type>
-</dependency>
-```  
 
-## 最后  
-如果你对[TakePhoto](https://github.com/crazycodeboy/TakePhoto)有更好的建议或想改造它，欢迎大家[Fork and Pull requests](https://github.com/crazycodeboy/TakePhoto)。  
+## 贡献  
+如果你在使用TakePhoto中遇到任何问题可以提[Issues](https://github.com/crazycodeboy/TakePhoto/issues)出来。另外欢迎大家为TakePhoto贡献智慧，欢迎大家[Fork and Pull requests](https://github.com/crazycodeboy/TakePhoto)。