自定義 Android 圖片庫

PicturePicker

github:https://github.com/sundevin/PicturePicker

一個仿微信朋友圈圖片選擇的相冊庫

項目為高仿微信圖片選擇模塊,目前可實現圖片的單選,多選,拍照,預覽,或者只拍照不選圖,選擇后刪除等

圖片裁剪功能支持自定義裁剪框樣式,大小,形狀,方向旋轉,裁剪后圖片的尺寸等

后期將會添加自定義主題

項目參考了其他類似開源項目的部分實現,并針對一些邊界問題做了修復,例如初始時無圖片或者圖片過多導致的問題,并針對特殊機型的拍照 crash 問題做了修復,代碼更加簡潔。

效果演示:

效果

效果

效果

效果

更新日志

  • 2.0.0
    2017/12/12
    修復已知的 bug
    不再強制進行全局初始化
    圖庫支持 gif 過濾選項
    預覽圖片時 api 調用更方便
    將查看圖片的邏輯放在 fragment 里,方便自定義。
  • 1.0.4
     2017/7/14
     修復裁剪圖片時 crash 的問題;
     拍攝完成后不再跳轉到預覽頁面,直接返回圖片。
  • 1.0.3
    2017/7/13
    修復 Fragment 導包不統一的問題,增加對 Fragment 和 v4.Fragment 的支持。

使用:

適用版本 minSdkVersion 19及以上

添加依賴

1,gradle

dependencies {
    // lastVersion 替換為最新版本號
    compile 'com.sundevin:picturepicker:{lastVersion}'
}

2,下載 library,以 module 的方式導入。

初始化全局配置(非必須)

    @Override
    public void onCreate() {
        super.onCreate();
        //初始化全局配置(如果不需要指定存儲路徑,可省略)
        PickerGlobalConfig config = new PickerGlobalConfig.Builder()
            .setCacheFolderPath("xxxx")//設置拍照的路徑,默認sdcard/data/data/package/files
            .build();
        PicturePicker.getInstance().init(config);
        //...
    }

打開圖片選擇頁面

        PickOptions options = new PickOptions.Builder()
                //是否僅拍照 默認false
                .setJustTakePhoto(rgPickType.getCheckedRadioButtonId() == R.id.rb_just_take_photo)
                //是否可多選 默認true
                .setMultiMode(rgPickType.getCheckedRadioButtonId() == R.id.rb_multi)
                //多選時最大選擇數量 默認 9
                .setPickMaxCount(seekBar.getProgress())
                //選擇圖片時點擊是否可查看大圖,默認true(多選模式有效)
                .setCanPreviewImg(cbCanPreview.isChecked())
                //選擇圖片時是否可拍照 默認true
                .setShowCamera(cbShowCamera.isChecked())
                //是否顯示 gif ,默認true
                .setSelectGif(cbShowGif.isChecked())
                .build();

        //默認配置
//        PicturePicker.getInstance().startPickPicture(MainActivity.this, PICK_IMG_REQUEST);
          PicturePicker.getInstance().startPickPicture(MainActivity.this, PICK_IMG_REQUEST, options);

獲取選擇的圖片

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (data != null && requestCode == PICK_IMG_REQUEST && resultCode == Activity.RESULT_OK) {
        List<PictureItem> tempList = (List<PictureItem>) data.getSerializableExtra(PictureGridActivity.EXTRA_RESULT_PICK_IMAGES);
        //...
    }
}

進入裁剪功能

DisplayMetrics displayMetrics = getResources().getDisplayMetrics();
//具體方法看注釋和demo
CropOptions cropOptions = new CropOptions.Builder()
    .setOutPutX(800)
    .setOutPutY(800)
    .setStyle(CropImageView.Style.RECTANGLE)
    .setFocusWidth(displayMetrics.widthPixels)
    .setFocusHeight(displayMetrics.widthPixels)
    .setSaveRectangle(false)
    .build();
//(支持activity,app.fragment,v4.fragment 進入)
PictureCropActivity.startPictureCropActivity(MainActivity.this, pictureItemList.get(0).pictureAbsPath, cropOptions, CROP_IMG_REQUEST);

獲取裁剪后的圖片

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (data != null && requestCode == CROP_IMG_REQUEST && resultCode == Activity.RESULT_OK) {
        String cropImgPath = data.getStringExtra(PictureCropActivity.EXTRA_NAME_CROP_IMG_PATH);
        //...
    }
}

查看圖片

//僅查看圖片時
PicturePreviewActivity.startActivityWithOnlyPreview(...);

//預覽且圖片可刪除時(支持activity,app.fragment,v4.fragment 進入)
PicturePreviewActivity.startActivityWithPreviewDel(...)

如果需要對圖片進行長按或者自定義 ui,可自己創建 Activity,加入 PreviewPictureFragment,調用其監聽方法即可,具體參見 demo 的實現。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。