一個非常好用的Android圖片選擇框架

前言

幾乎每個APP都需要圖片選擇和裁剪功能，因爲涉及到相機和存儲，所以該功能還是要考慮很多兼容性的。這也是github上有一大堆圖片選擇框架的原因，但是你會發現github上找的圖片選擇框架並不是簡單的只有圖片選擇， 它還包含視頻選擇、視頻錄製、圖片壓縮等等一大堆功能。其實你只需要一個頭像選擇的功能，那些框架很多功能你根本用不到，而且代碼至少也幾十個類，後期有問題改起來也是麻煩事。所以我就封裝了一個代碼及其簡潔的圖片選擇框架，沒有任何多餘的功能，涉及的主要功能類只有3個，使用也是非常簡單。

效果圖如下：

功能特點

• 支持通過拍照獲取圖片
• 支持通過相冊獲取圖片
• 支持圖片裁剪
• 支持仿IOS底部彈出選擇菜單ActionSheet效果
• 支持6.0動態授予權限
• 解決圖片有黑邊問題
• 解決7.0調用相機報FileUriExposedException的問題
• 解決小米miui系統調用系統裁剪圖片功能crash問題

使用

Step 1. 添加JitPack倉庫

在項目的build.gradle添加JitPack倉庫

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

Step 2. 添加依賴

在需要使用的module中添加依賴

dependencies {
    compile 'com.github.wildma:PictureSelector:1.0.0'
}

或者引用本地lib

compile project(':pictureselector')

Step 3. 配置清單文件所需activity

        <activity
            android:name="com.wildma.pictureselector.PictureSelectActivity"
            android:theme="@android:style/Theme.Translucent.NoTitleBar"/>

Step 4. 拍照或者從相冊選擇圖片

        /**
         * create方法參數一是上下文，在activity中傳activity.this，在fragment中傳fragment.this。參數二爲請求碼，用於結果回調onActivityResult中判斷
         * selectPicture方法參數分別爲圖片的裁剪寬、裁剪高、寬比例、高比例。默認不傳則爲寬200，高200，寬高比例爲1：1。
         */
        PictureSelector
                .create(MainActivity.this, PictureSelector.SELECT_REQUEST_CODE)
                .selectPicture(200, 200, 1, 1);

Step 5. 獲取裁剪後的圖片地址

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        /*結果回調*/
        if (requestCode == PictureSelector.SELECT_REQUEST_CODE) {
            if (data != null) {
                String picturePath = data.getStringExtra(PictureSelector.PICTURE_PATH);
            }
        }
    }

代碼

每個類的註釋我都寫的很清楚了，所以這裏只貼出主要的圖片工具類，其他可以到我的Github上查看源碼（見文末）。

選擇圖片工具類

package com.wildma.pictureselector;

import android.app.Activity;
import android.content.Context;
import android.content.Intent;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.net.Uri;
import android.os.Build;
import android.provider.MediaStore;
import android.support.v4.content.FileProvider;
import android.widget.Toast;

import java.io.File;
import java.io.FileNotFoundException;


/**
 * Author       wildma
 * Github       https://github.com/wildma
 * CreateDate   2018/6/10
 * Desc         ${選擇圖片工具類}
 * 使用方法：
 * 1. 調用getByCamera()、getByAlbum()可通過拍照或相冊獲取圖片
 * 2. 在onActivityResult中調用本工具類的onActivityResult方法處理通過相冊或拍照獲取的圖片
 */
public class PictureSelectUtils {

    public static final int GET_BY_ALBUM  = 0x11;//相冊標記
    public static final int GET_BY_CAMERA = 0x12;//拍照標記
    public static final int CROP          = 0x13;//裁剪標記
    private static Uri takePictureUri;//拍照圖片uri
    public static Uri cropPictureTempUri;//裁剪圖片uri

    /**
     * 通過相冊獲取圖片
     * @param activity
     */
    public static void getByAlbum(Activity activity) {
        Intent intent = new Intent(Intent.ACTION_PICK,
                MediaStore.Images.Media.EXTERNAL_CONTENT_URI);
        intent.setType("image/*");
        activity.startActivityForResult(intent, GET_BY_ALBUM);
    }

    /**
     * 通過拍照獲取圖片
     * @param activity
     */
    public static void getByCamera(Activity activity) {
        takePictureUri = createImagePathUri(activity);
        if (takePictureUri != null) {
            Intent i = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
            i.putExtra(MediaStore.EXTRA_OUTPUT, takePictureUri);//輸出路徑（拍照後的保存路徑）
            activity.startActivityForResult(i, GET_BY_CAMERA);
        } else {
            Toast.makeText(activity, "無法保存到相冊", Toast.LENGTH_LONG).show();
        }
    }

    /**
     * 創建一個圖片地址uri,用於保存拍照後的照片
     *
     * @param activity
     * @return          圖片的uri
     */
    public static Uri createImagePathUri(Activity activity) {

        try {
            FileUtils.createOrExistsDir(Constant.DIR_ROOT);
            StringBuffer buffer = new StringBuffer();
            String pathName = buffer.append(Constant.DIR_ROOT).append(Constant.APP_NAME).append(".").append(System.currentTimeMillis()).append(".jpg").toString();
            File file = new File(pathName);

            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { //解決Android 7.0 拍照出現FileUriExposedException的問題
                String authority = activity.getPackageName() + ".fileProvider";
                takePictureUri = FileProvider.getUriForFile(activity, authority, file);
            } else {
                takePictureUri = Uri.fromFile(file);
            }
        } catch (Exception e) {
            e.printStackTrace();
            Toast.makeText(activity, "無法保存到相冊", Toast.LENGTH_LONG).show();
        }
        return takePictureUri;
    }

    /**
     * 處理拍照或相冊獲取的圖片，默認大小480*480，比例1:1
     * @param activity      上下文
     * @param requestCode   請求碼
     * @param resultCode    結果碼
     * @param data          Intent
     * @return
     */
    public static Bitmap onActivityResult(Activity activity, int requestCode, int resultCode, Intent data) {
        return onActivityResult(activity, requestCode, resultCode, data, 0, 0, 0, 0);
    }

    /**
     * 處理拍照或相冊獲取的圖片
     * @param activity      上下文
     * @param requestCode   請求碼
     * @param resultCode    結果碼
     * @param data          Intent
     * @param w             輸出寬
     * @param h             輸出高
     * @param aspectX       寬比例
     * @param aspectY       高比例
     * @return
     */
    public static Bitmap onActivityResult(Activity activity, int requestCode, int resultCode, Intent data,
                                          int w, int h, int aspectX, int aspectY) {
        Bitmap bm = null;
        if (resultCode == Activity.RESULT_OK) {
            Uri uri = null;
            switch (requestCode) {
                case GET_BY_ALBUM:
                    uri = data.getData();
                    activity.startActivityForResult(crop(uri, w, h, aspectX, aspectY), CROP);
                    break;
                case GET_BY_CAMERA:
                    uri = takePictureUri;
                    activity.startActivityForResult(crop(uri, w, h, aspectX, aspectY), CROP);
                    break;
                case CROP:
                    bm = dealCrop(activity);
                    break;
            }
        }
        return bm;
    }

    /**
     * 裁剪,默認裁剪輸出480*480，比例1:1
     * @param uri   圖片的uri
     * @return
     */
    public static Intent crop(Uri uri) {
        return crop(uri, 480, 480, 1, 1);
    }

    /**
     * 裁剪，例如：輸出100*100大小的圖片，寬高比例是1:1
     * @param uri     圖片的uri
     * @param w       輸出寬
     * @param h       輸出高
     * @param aspectX 寬比例
     * @param aspectY 高比例
     * @return
     */
    public static Intent crop(Uri uri, int w, int h, int aspectX, int aspectY) {
        if (w == 0 && h == 0) {
            w = h = 480;
        }
        if (aspectX == 0 && aspectY == 0) {
            aspectX = aspectY = 1;
        }
        Intent intent = new Intent("com.android.camera.action.CROP");
        intent.setDataAndType(uri, "image/*");
        intent.putExtra("crop", "true");
        intent.putExtra("aspectX", aspectX);
        intent.putExtra("aspectY", aspectY);
        intent.putExtra("outputX", w);
        intent.putExtra("outputY", h);

        /*解決圖片有黑邊問題*/
        intent.putExtra("scale", true);
        intent.putExtra("scaleUpIfNeeded", true);

        /*解決跳轉到裁剪提示“圖片加載失敗”問題*/
        intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
        intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

        /*解決小米miui系統調用系統裁剪圖片功能camera.action.CROP後崩潰或重新打開app的問題*/
        StringBuffer buffer = new StringBuffer();
        String pathName = buffer.append("file:///").append(FileUtils.getRootPath()).append(File.separator).append(Constant.APP_NAME).append(".temp.jpg").toString();
        cropPictureTempUri = Uri.parse(pathName);
        intent.putExtra(MediaStore.EXTRA_OUTPUT, cropPictureTempUri);//輸出路徑(裁剪後的保存路徑)
        // 輸出格式
        intent.putExtra("outputFormat", "JPEG");
        // 不啓用人臉識別
        intent.putExtra("noFaceDetection", true);
        //是否將數據保留在Bitmap中返回
        intent.putExtra("return-data", false);
        return intent;
    }

    /**
     * 處理裁剪，獲取裁剪後的圖片
     * @param context   上下文
     * @return
     */
    public static Bitmap dealCrop(Context context) {
        Bitmap bitmap = null;
        try {
            bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(cropPictureTempUri));
        } catch (FileNotFoundException e) {
            e.printStackTrace();
        }
        return bitmap;
    }

}

github地址：PictureSelector
ps：如果對你有幫助，點下喜歡就是對我最大的認可。