圖片選擇器在手機應用中屢見不鮮，設定頭像、聊天傳圖等常見類似場景都需要使用。為了保持不同裝置上體驗的一致性和較好的相容性，比較穩妥的做法是在應用內自實現相機拍照、相簿選圖和圖片裁剪功能。但是，這個實現過程比較複雜，費時費力。更多時候，或者說在專案初期，我們都會選擇直接呼叫系統提供的這些功能來完成一個圖片選擇器。然而，由於安卓裝置的多樣性，總會遇到各種各樣的相容問題。本文就來總結總結，呼叫系統相機、相簿和裁剪功能實現圖片選擇器的過程中，我們需要注意的一些地方。
示例程式碼
這裡簡單使用一個示例程式碼，演示呼叫系統相機或相簿，獲取圖片，然後使用系統裁剪功能處理圖片，並顯示到一個 ImageButton 檢視裡面：
public class MainActivity extends FragmentActivity {
public static final int REQUEST_CAMERA = 1;
public static final int REQUEST_ALBUM = 2;
public static final int REQUEST_CROP = 3;
public static final String IMAGE_UNSPECIFIED = "image/*";
private ImageButton mPictureIb;
private File mImageFile;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mPictureIb = (ImageButton) findViewById(R.id.ib_picture);
}
public void onClickPicker(View v) {
new AlertDialog.Builder(this)
.setTitle("選擇照片")
.setItems(new String[]{"拍照", "相簿"}, new OnClickListener() {
@Override
public void onClick(DialogInterface dialogInterface, int i) {
if (i == 0) {
selectCamera();
} else {
selectAlbum();
}
}
})
.create()
.show();
}
private void selectCamera() {
createImageFile();
if (!mImageFile.exists()) {
return;
}
Intent cameraIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
cameraIntent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(mImageFile));
startActivityForResult(cameraIntent, REQUEST_CAMERA);
}
private void selectAlbum() {
Intent albumIntent = new Intent(Intent.ACTION_PICK);
albumIntent.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, IMAGE_UNSPECIFIED);
startActivityForResult(albumIntent, REQUEST_ALBUM);
}
private void cropImage(Uri uri){
Intent intent = new Intent("com.android.camera.action.CROP");
intent.setDataAndType(uri, IMAGE_UNSPECIFIED);
intent.putExtra("crop", "true");
intent.putExtra("aspectX", 1);
intent.putExtra("aspectY", 1);
intent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(mImageFile));
startActivityForResult(intent, REQUEST_CROP);
}
private void createImageFile() {
mImageFile = new File(Environment.getExternalStorageDirectory(), System.currentTimeMillis() + ".jpg");
try {
mImageFile.createNewFile();
} catch (IOException e) {
e.printStackTrace();
Toast.makeText(this, "出錯啦", Toast.LENGTH_SHORT).show();
}
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (RESULT_OK != resultCode) {
return;
}
switch (requestCode) {
case REQUEST_CAMERA:
cropImage(Uri.fromFile(mImageFile));
break;
case REQUEST_ALBUM:
createImageFile();
if (!mImageFile.exists()) {
return;
}
Uri uri = data.getData();
if (uri != null) {
cropImage(uri);
}
break;
case REQUEST_CROP:
mPictureIb.setImageURI(Uri.fromFile(mImageFile));
break;
}
}
}複製程式碼效果如圖（不同裝置，系統功能呈現有所不同）：
看似完美，你以為上述程式碼就能結束了的話，那就大錯特錯啦！這裡面還有一些相容問題要處理，還有一些地方需要特殊說明。
拍照圖片儲存問題
呼叫系統相機實現拍照功能的核心程式碼如下：
Intent cameraIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
cameraIntent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(mImageFile));
startActivityForResult(cameraIntent, REQUEST_CAMERA);複製程式碼其中 MediaStore.EXTRA_OUTPUT 資料表示，拍照所得圖片儲存到指定目錄下的檔案（一般會在 SD 卡中建立當前應用的目錄，並建立臨時檔案儲存圖片）。然後，在 onActivityResult 方法中根據檔案路徑獲取圖片。
如果不為 intent 新增該資料的話，將在 onActivityResult 的 intent 物件中返回一個 Bitmap 物件，通過如下程式碼獲取：
Bitmap bmp = data.getParcelableExtra("data");複製程式碼值得注意的是，這裡的 Bitmap 物件是拍照所得圖片的一個縮圖，尺寸很小！系統這麼做也是充分考慮到應用的記憶體佔用問題。試想一下，如今手機裝置中高清相機拍出來的照片，一張圖的大小高達十幾兆，如果返回這麼大的圖片，記憶體佔用相當嚴重，何況很多時候知識臨時使用而已。所以，呼叫系統相機時，一般都會新增 MediaStore.EXTRA_OUTPUT 引數，避免返回 Bitmap 物件。當然，這麼做也能保證應用產生的資料，包括檔案，都能儲存在應用目錄下，方便清理快取時統一清除。
拍照圖片旋轉問題
部分手機，比如三星手機，呼叫系統相機拍照所得的照片可能會發生自動旋轉問題，常見為旋轉 90°。所以，要求我們在拍照之後，使用圖片之前，判斷圖片是否發生過旋轉，如果是，要將照片旋轉回來。
這是獲取圖片旋轉角度的程式碼：
/**
* 獲取圖片旋轉角度
* @param path 圖片路徑
* @return
*/
private int parseImageDegree(String path) {
int degree = 0;
try {
ExifInterface exifInterface = new ExifInterface(path);
int orientation = exifInterface.getAttributeInt(ExifInterface.TAG_ORIENTATION, ExifInterface.ORIENTATION_NORMAL);
switch (orientation) {
case ExifInterface.ORIENTATION_ROTATE_90:
degree = 90;
break;
case ExifInterface.ORIENTATION_ROTATE_180:
degree = 180;
break;
case ExifInterface.ORIENTATION_ROTATE_270:
degree = 270;
break;
}
} catch (IOException e) {
e.printStackTrace();
}
return degree;
}複製程式碼這是根據指定角度旋轉圖片的程式碼：
/**
* 圖片旋轉操作
*
* @param bm 需要旋轉的圖片
* @param degree 旋轉角度
* @return 旋轉後的圖片
*/
private Bitmap rotateBitmap(Bitmap bm, int degree) {
Bitmap returnBm = null;
Matrix matrix = new Matrix();
matrix.postRotate(degree);
try {
returnBm = Bitmap.createBitmap(bm, 0, 0, bm.getWidth(), bm.getHeight(), matrix, true);
} catch (OutOfMemoryError e) {
}
if (returnBm == null) {
returnBm = bm;
}
if (bm != returnBm) {
bm.recycle();
}
return returnBm;
}複製程式碼橫豎屏切換問題
在部分手機，呼叫系統拍照功能時，可能會發生橫豎屏切換過程，導致返回應用時當前 Activity 發生銷燬重建，各個生命週期又重新走了一遍。此時，一些應用內的變數資料可能丟失，使用時容易發生空值異常，進而導致 app 崩潰退出。
為了避免這種現象，我們需要在 AndroidManifest.xml 檔案的對應 <activity> 標籤中新增屬性:
android:configChanges="orientation|screenSize"複製程式碼這樣，當發生螢幕旋轉時，不會導致 Activity 銷燬重建，而是執行 onConfigurationChanged() 方法：
@Override
public void onConfigurationChanged(Configuration newConfig) {
super.onConfigurationChanged(newConfig);
}複製程式碼呼叫系統裁剪問題
示例中呼叫系統裁剪的程式碼如下：
Intent intent = new Intent("com.android.camera.action.CROP");
intent.setDataAndType(uri, IMAGE_UNSPECIFIED);
intent.putExtra("crop", "true");
intent.putExtra("aspectX", 1);
intent.putExtra("aspectY", 1);
intent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(mImageFile));
startActivityForResult(intent, REQUEST_CROP);複製程式碼可以看出，呼叫系統裁剪功能，需要設定一些 Extra 引數，很多人容易在這裡產生疑惑，不知如何取捨，如何設值。這裡列舉一下常用的 Extra 名字、值型別和作用：
- crop：String 型別資料，傳送裁剪訊號
- aspectX 和 aspectY：int 型別資料，設定裁剪框的 X 與 Y 值比例
- outputX 和 outputY：int 型別資料，設定裁剪輸出的圖片大小
- scale：boolean 型別資料，設定是否支援裁剪縮放
- return-data：boolean 型別資料，設定是否在 onActivityResult 方法的 intent 值中返回 Bitmap 物件
- MediaStore.EXTRA_OUTPUT：Uri 型別資料，設定是否將裁剪結果儲存到指定檔案中
需要注意的是：
第一，設定 return-data 引數為 true 時，返回的 Bitmap 物件也為縮圖，獲取方式與前面所述相機拍照獲取 Bitmap 的方式一致；
第二，呼叫系統相簿並裁剪時，如果使用MediaStore.EXTRA_OUTPUT引數，Uri 儘量不要設定為原始檔對應的 Uri 值，另做儲存，不損壞系統相簿中的源圖檔案；
第三，根據經驗，outputX 與 outputY 值設定太大時，容易出現卡屏現象；
第四，可以不設定 outputX 與 outputY 引數，使使用者根據自身按比例自由裁剪，就像示例程式碼這樣。
setImageURI() 注意事項
你可能會用到 setImageURI() 方法給 ImageView 設定圖片內容，這裡也有一個地方需要注意。我們先看一下這個方法的原始碼：
public void setImageURI(Uri uri) {
if (mResource != 0 ||
(mUri != uri &&
(uri == null || mUri == null || !uri.equals(mUri)))) {
updateDrawable(null);
mResource = 0;
mUri = uri;
final int oldWidth = mDrawableWidth;
final int oldHeight = mDrawableHeight;
resolveUri();
if (oldWidth != mDrawableWidth || oldHeight != mDrawableHeight) {
requestLayout();
}
invalidate();
}
}複製程式碼可以看到，這裡的 uri 引數在內部持有快取變數，當多次呼叫該方法而 uri 引數值不變時，圖片展示內容不變。問題就在這，如果你多次拍照或裁剪儲存的圖片檔案路徑相同時，雖然每次處理過後實際儲存的檔案內容發生變化，但由於路徑相同，uri 引數一致，導致多次呼叫 setImageURI() 設定圖片內容時，ImageView 顯示內容不變！這也是為什麼示例程式碼中我用時間戳處理圖片檔名的原因所在，保證每次儲存的圖片路徑不同。
根據 Uri 獲取檔案地址
有時候，我們需要根據 Uri 獲取檔案路徑。比如如果你不需要使用裁剪功能的話，呼叫系統相簿選擇圖片後返回的就是一個 Uri 物件，我們需要從這個 Uri 物件中解析出對應的圖片檔案路徑，便於上傳至伺服器等後續處理。
比如，這個 Uri 物件可能是：
content://media/external/images/media/3066
很多朋友相信有過這樣的經驗，使用 toString() 或者 getPath() 方法獲取 Uri 物件所對應的檔案路徑，其實這是錯誤的！通過 getPath() 獲取的結果字串是：
media/external/images/media/3066
而正確的獲取方式是：
private String parseFilePath(Uri uri) {
String[] filePathColumn = { MediaStore.Images.Media.DATA };
Cursor cursor = getContentResolver().query(uri, filePathColumn, null, null, null);
cursor.moveToFirst();
int columnIndex = cursor.getColumnIndex(filePathColumn[0]);
String picturePath = cursor.getString(columnIndex);
cursor.close();
return picturePath;
}複製程式碼其對應的檔案路徑應該是這個樣子的：
/storage/emulated/0/Pictures/Screenshots/S70302-131606.jpg
Base64 檔案編碼處理
現在很多網路框架內部都做了封裝處理，上傳圖片時只需要傳遞一個檔案路徑即可。但是，少數情況下，根據伺服器需要，我們要對圖片檔案位元組流編碼後再上傳。這是使用 Base64 編碼並根據位元組陣列獲取字串的處理過程：
public static String fileToBase64String(String filePath) {
File photoFile = new File(filePath);
try {
FileInputStream fis = new FileInputStream(photoFile);
ByteArrayOutputStream baos = new ByteArrayOutputStream(10000);
byte[] buffer = new byte[1000];
while (fis.read(buffer)!=-1) {
baos.write(buffer);
}
baos.close();
fis.close();
return Arrays.toString(Base64.encode(baos.toByteArray(), Base64.DEFAULT));
}catch (IOException e) {
e.printStackTrace();
}
return null;
}複製程式碼zip 壓縮檔案處理
當上傳多張圖片至伺服器時，為了提升傳輸效率，往往會採用 zip 格式壓縮處理。這裡提供一個遞迴壓縮程式碼，方便大家有需要的時候借鑑參考：
public String zipCompass(String filePath){
File zipFile = new File(Environment.getExternalStorageDirectory(), System.currentTimeMillis() + ".zip");
try{
//指定了兩個待壓縮的檔案，都在assets目錄中
String[] filenames = new String[]{ "activity_main.xml", "strings.xml" };
FileOutputStream fos = new FileOutputStream(zipFile);
ZipOutputStream zos = new ZipOutputStream(fos);
int i = 1;
//列舉filenames中的所有待壓縮檔案
while (i <= filenames.length){
//從filenames陣列中取出當前待壓縮的檔名，作為壓縮後的名稱，以保證壓縮前後檔名一致
ZipEntry zipEntry = new ZipEntry(filenames[i - 1]);
//開啟當前的zipEntry物件
zos.putNextEntry(zipEntry);
FileInputStream is = new FileInputStream(filePath);
byte[] buffer = new byte[8192];
int count = 0;
//寫入資料
while ((count = is.read(buffer)) >= 0){
zos.write(buffer, 0, count);
}
zos.flush();
zos.closeEntry();
is.close();
i++;
}
zos.finish();
zos.close();
return zipFile.getAbsolutePath();
}
catch (Exception e){
Toast.makeText(this, e.getMessage(), Toast.LENGTH_LONG).show();
return null;
}
}複製程式碼新增系統許可權
說了這麼多，別忘了在 AndroidManifest.xml 檔案中新增系統許可權（前面示例程式碼中沒有考慮到 Android 6.0 執行時許可權的問題，實際使用時注意新增處理）：
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />複製程式碼歡迎關注我的微信公眾號
安卓筆記俠：專注於 Android 開發，和程式設計師的感悟~
