SuperPhotoTakePicker

Android 一个简单的头像选择工具 拍照 或者 从相册选择 裁切 最终拿到裁切后的文件，使用者可以调用自己的接口上传到自己的服务器，实现类似于头像上传的功能

特点

1.基于Android原生提供的接口，没有自建图片选择器，图片裁剪器及相机，大幅度降低适配难度
2.适配Android7.0及以上
3.包的体积非常小,代码简单，自定义容易
4.通过配置，可以只拿到相机或相册用户选择的照片而不裁切

Feature

1.Base on android api to camera take photo,album pick photo,crop photo.No third part jar.
2.Adapt Android 7.0+.
3.SuperPhotoTakePicker Jar is very small,very simple,custom easy.
4.Set param，you can get raw photo from camera or album,no crop.

使用方法 USE

1.添加gradle依赖 Add gradle dependencies

implementation 'com.shark:superphototakepicker:1.0.3'

2.由于Android7.0的原因在Manifest中创建自己的FileProvider.Create FileProvider in Manifest

如果有的话就不需要创建了，注意authorities的值，这里是本APP的包名，可以用其他名. Need not create，if you have file provider.Notice authorities value.You can use packageName or other string

 <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="${applicationId}"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths" />
  </provider>

3.设置Picker Setting picker

SuperPhotoTakePicker picker = new SuperPhotoTakePicker.Builder(this)
                .setAspectX(1)//设置裁剪后图片的横纵比例,x/y,square or rectangle
                .setAspectY(1)//设置裁剪后图片的横纵比例
                .setCropPhoto(true)//if false callback onRawPhotoReceived,if true callback onCropPhotoReceived
                .setCompressFormat(Bitmap.CompressFormat.JPEG)//裁剪后图片的存储格式，,crop photo format
                .setCropWidth(200)//裁剪后图片的大小,crop photo width
                .setCropHeight(200)//裁剪后图片的大小,,crop photo height
                .setAuthority(getPackageName())//本APP的FileProvider的Authority,use step 2 authorities value
                .setOnPhotoChangedListener(this)//callback
                .create();

4.onActivityResult in Activity or Fragment

    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        picker.onActivityResult(requestCode,resultCode,data);
    }

5.权限Permission

 <uses-permission android:name="android.permission.CAMERA" />
 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

6.权限主动请求 Permission Request

如果运行到Android 6.0及以上手机时，需要在调用这两个方法之前要主动向用户请求权限才行 If run on android 6.0+,You need request Permission before call these function

可以参考这个开源的权限请求库，you can reference PermissionsDispatcher library

• PermissionsDispatcher

需要Manifest.permission.WRITE_EXTERNAL_STORAGE权限

picker.startAlbum();

需要Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.CAMERA

picker.startCamera();

7.回调callback

public interface OnPhotoChangedListener {
    //收到用来裁切的图
    //Receive raw photo before crop
    void onRawPhotoReceived(File file);
    //收到裁切好的图，setCropPhoto如果为false，这个方法不会收到回调
    //Receive crop photo
    void onCropPhotoReceived(File file);

    void onError(Exception e);
}

8.其他问题看项目里的demo吧，Just look demo in project

9.适配清单 Adapt List

Brand	Model
小米	mix2
小米	note pro
小米	note
小米	4
小米	2s
红米	1s
红米	6
Vivo	Z1
华为	Mate10
华为	P20
华为	6x
荣耀	畅玩4C
荣耀	V9
三星	S7 edge
魅族	Note 6