前言
圖片選擇框架其實已有許多優秀成熟的框架,比如知乎開源的 Matisse,遵循Google提倡的MaterialDesign ,感興趣的朋友可以查看看下這篇文章,對Matisse的使用有一個粗略的認識。
簡述
既然已經有了這么優化的框架為啥還要重復造輪子呢,估計很多讀者都有這樣的疑問,對于這個問題我想說以下幾點。
我們去使用一個開源庫,可能我們只需要當中的某一塊功能,有一部分的功能其實我們是不需要的,但是因為某一個功能而去集成一個庫,總感覺怪怪的。
使用一個開源庫,那么對于這個庫的的依賴性就比較強,如果作者停止維護,后期新增的需求該框架滿足不了,如果引入的是源碼,那還可以修改作者的源碼,但是前期是得非常了解該框架的整體設計,邏輯等等。
個人認為以上兩點其實都不是最重要的,我覺得最重要的是可以去學習這些優秀框架的設計思想,代碼的健壯性,各種騷操作等等,可以增長自己的知識面,可以從中學習成長不少。
一、功能介紹
- 支持圖片多選,直接拍照,圖片剪裁,直接自定義圖片加載。
二、使用介紹
整個框架的入口為PictureSelector,使用方法如下:
- 圖片選擇屬性配置
//圖片選擇全部功能
PictureSelector.with(this)
.selectSpec() //圖片選擇屬性配置
.setImageLoader(new GlideImageLoader()) //圖片加載方案,默認提供了GlideImageLoader
.setSpanCount(3) //圖片一行顯示幾張圖片
.setOpenCamera() //開啟系統拍照功能
.needCrop() //是否是否需要剪裁
.setOutputX(200) //設置圖片剪裁的大小
.setOutputY(200) //設置圖片剪裁的大小
.setAuthority("org.lym.picture.selector.fileprovider") //適配Android7.0系統拍照
.setMaxSelectImage(single ? 1 : 9) //設置圖片多選
.startForResult(IMAGES_CODE); //開啟圖片選擇
//單選圖片
PictureSelector
.with(this)
.selectSpec()
.startForResult(IMAGES_CODE);
//單選圖片并開啟剪裁并設置圖片剪裁的大小
PictureSelector
.with(this)
.selectSpec()
.needCrop()
.setOutputX(200)
.setOutputY(200)
.startForResult(IMAGES_CODE);
//單選圖片并開啟相冊拍照
PictureSelector
.with(this)
.selectSpec()
.setOpenCamera()
//開啟拍照功能一定得設置該屬性,為了兼容Android7.0相機拍照問題
//在manifest文件中也需要注冊該provider
.setAuthority("org.lym.picture.selector.fileprovider")
.startForResult(IMAGES_CODE);
//圖片多選
PictureSelector.with(this)
.selectSpec()
.setOpenCamera()
.setMaxSelectImage(3)
.startForResult(IMAGES_CODE);
- 兼容Android7.0系統拍照FileProvider配置
<!-- 兼容android7.0 需配置xml文件路徑,可將該框架中的xml拷貝至你的項目下配置即可 -->
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="${applicationId}.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/external_path"/>
</provider>
- 接收圖片選擇后的結果
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == IMAGES_CODE && resultCode == Activity.RESULT_OK) {
if (null != data) {
//圖片單選和多選數據都是以ArrayList的字符串數組返回的。
List<String> paths = PictureSelector.obtainPathResult(data);
mResultAdapter.setNewData(paths);
}
}
}
三、注意事項
- 使用該框架需要訪問sdcard路徑,那么你需要在你的manifest注冊以下兩個權限,如果在Android6.0之后使用的話,那么則需要動態申請一下權限,關于動態權限申請可以使用AndPermission,這里就不贅述了。
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
- 如果你需要使用拍照功能的話,那么一定得在manifest中聲明一個FileProvider并配置name屬性的路徑,然后需要setAuthority該屬性。
<!-- 兼容android7.0 -->
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="${applicationId}.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/external_path"/>
</provider>
- 圖片加載策略,框架默認提供的是Glide,Glide版本為當前最新版本4.8.0,Glide在V4之后Api有所改變,詳情請訪問Glide官方文檔,如果你的項目使用的不是Glide那么,也沒關系,你只需要實現UIImageLoader然后通過setImageLoader設置即可。
結語
建議大家以源碼的形式導入到你的項目中,這樣你可以只提取你需要的功能,剔除對你無用的功能,也方便你的擴展,當然,你也可以在GitHub上提issues,(提了我也不改),哈哈,開個玩笑,只要提了我都會盡我能力去解決的,歡迎大家start,fork。