实战项目 10: 货物清单应用
這篇文章分享我的 Android 開發（入門）課程 的最后一個實戰項目：貨物清單應用。這個項目托管在我的 GitHub 上，具體是 InventoryApp Repository，項目介紹已詳細寫在 README 上，歡迎大家 star 和 fork。
這個實戰項目的主要目的是練習在 Android 中使用 SQLite 數據庫。與 實戰項目 9: 習慣記錄應用 直接在 Activity 中操作數據庫的做法不同，InventoryApp 采用了更符合 Android 設計規范的框架，即
- 數據庫端
（1）使用 Contract 類定義數據庫相關的常量，如 Content URI 及其 MIME 類型、數據庫的表格名稱以及各列名稱。
（2）使用自定義 SQLiteOpenHelper 類管理數據庫，如新建數據庫表格、升級數據庫架構。
（3）使用自定義 ContentProvider 類實現數據庫的 CRUD 操作，其中包括對數據庫更新和插入數據時的數據校驗。 - UI 端
通過 ContentResolver 對數據庫實現插入、更新、刪除數據的交互，而讀取數據通過 CursorLoader 在后臺線程實現。
由此可見，InventoryApp 的數據庫框架與課程中介紹的相同，所以這部分內容不再贅述，詳情可參考相關的學習筆記，如《課程 3: Content Providers 簡介》。值得一提的是，InventoryApp 的數據庫需要存儲圖片，但是沒有將圖片數據直接存入數據庫（如將圖片轉換為 byte[] 以 BLOB 原樣存入數據庫），而是存儲了圖片的 URI，這樣極大地降低了數據庫的體積，同時也減輕了應用處理數據的負擔。
除此之外，InventoryApp 還使用了很多其它有意思的 Android 組件，這篇文章按例分享給大家，希望對大家有幫助，歡迎互相交流。為了精簡篇幅，文中的代碼有刪減，請以 GitHub 中的代碼為準。
關鍵詞：RecyclerView & CursorLoader、Glide、Runtime Permissions、DialogFragment、通過相機應用拍攝照片以及在相冊中選取圖片、FileProvider、AsyncTask、Intent to Email with Attachment、InputFilter、RegEx、禁止設備屏幕旋轉、Drawable Resources、FloatingActionButton
RecyclerView 從 CursorLoader 接收數據以填充列表
雖然課程中介紹的 ListView 和 GridView 能夠輕松地與 CursorLoader 配合顯示列表，但是 RecyclerView 作為 ListView 的升級版，它是一個更靈活的 Android 組件，尤其是在列表的子項需要加載的數據量較大或者子項的數據需要頻繁更新的時候，RecyclerView 更適合這種應用場景。例如在 實戰項目 7&8 : 從 Web API 獲取數據 中，BookListing App 實現了可擴展 CardView 效果的 RecyclerView 列表，如下圖所示。
RecyclerView 的使用教程可以參考 這個 Android Developers 文檔。在 InventoryApp 中，首先在 CatalogActivity 中創建一個 RecyclerView 對象，并進行初始化設置，在這里主要是通過 setLayoutManager 將列表的布局模式設置為兩列的、交錯分布的垂直列表。其中，這種交錯網格布局 (StaggeredGridLayout) 也是 InventoryApp 使用 RecyclerView 的一個原因；GridView 默認情況下只能顯示對齊的網格，當子項之間的尺寸（寬或高）不同時，會以最大的那個對齊，這樣就會產生不必要的空隙。
In CatalogActivity.java
@Override protected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_catalog);RecyclerView recyclerView = findViewById(R.id.list);recyclerView.setLayoutManager(new StaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL));mAdapter = new InventoryAdapter(this, null);recyclerView.setAdapter(mAdapter);... } 復制代碼當然，RecyclerView 同樣采用適配器模式向列表填充數據，而且業務邏輯與 CursorAdapter 類似：首先通過 onCreateViewHolder 創建新的子項視圖，隨后通過 onBindViewHolder 將數據填充到視圖中；視圖回收時則直接通過 onBindViewHolder 將數據填充到回收的視圖中。不同的是，RecyclerView 列表的子項布局需要由自定義 RecyclerView.ViewHolder 類提供，具體的應用流程是
因此，在 InventoryApp 中的 RecyclerView 適配器自定義為 InventoryAdapter，注意類名后的 extends 參數為 RecyclerView.Adapter，其泛型參數為 VH，即自定義的 RecyclerView.ViewHolder，在這里作為適配器的內部類實現。
In InventoryAdapter.java
public class InventoryAdapter extends RecyclerView.Adapter<InventoryAdapter.MyViewHolder> {private Cursor mCursor;private Context mContext;public InventoryAdapter(Context context, Cursor cursor) {mContext = context;mCursor = cursor;}@Overridepublic int getItemCount() {if (mCursor == null) {return 0;} else {return mCursor.getCount();}}public class MyViewHolder extends RecyclerView.ViewHolder {private ImageView imageView;private TextView nameTextView, priceTextView, quantityTextView;private FloatingActionButton fab;private MyViewHolder(View view) {super(view);imageView = view.findViewById(R.id.item_image);nameTextView = view.findViewById(R.id.item_name);priceTextView = view.findViewById(R.id.item_price);quantityTextView = view.findViewById(R.id.item_quantity);fab = view.findViewById(R.id.fab_sell);}}... } 復制代碼有了上述基礎，InventoryAdapter 就可以根據自定義 ViewHolder 對象實現列表的數據填充了。首先在 onCreateViewHolder 中通過 LayoutInflater 根據列表子項的布局文件生成一個 View 對象，然后創建一個 MyViewHolder 對象，輸入參數即生成的 View 對象，最后返回該 MyViewHolder 對象。
In InventoryAdapter.java
@NonNull @Override public InventoryAdapter.MyViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {View itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.list_item, parent, false);MyViewHolder myViewHolder = new MyViewHolder(itemView);return myViewHolder; } 復制代碼然后在 onBindViewHolder 中根據傳入的 MyViewHolder 對象以及 Cursor 進行數據填充。注意在進行任何操作之前，需要將 Cursor 的位置移到當前位置上。
In InventoryAdapter.java
@Override public void onBindViewHolder(@NonNull final InventoryAdapter.MyViewHolder holder, int position) {if (mCursor.moveToPosition(position)) {...GlideApp.with(mContext).load(imageUriString).transforms(new CenterCrop(), new RoundedCorners((int) mContext.getResources().getDimension(R.dimen.background_corner_radius))).into(holder.imageView);...} } 復制代碼至此，RecyclerView 的適配器基本框架就已經實現了。不過在 InventoryApp 中的實際應用中，還有幾個需要注意的點。
一、Glide
對于 Android 來說，在列表中顯示多張圖片是一項既耗時又耗性能的工作，是否需要而又如何將讀取圖片資源、根據視圖大小裁剪圖片等工作放入后臺線程，這是 InventoryApp 在開發過程中踩過的大坑。在查閱 這篇 Android Developers 文檔 后，才了解到絕大多數情況下，Glide 庫 都能僅用一行代碼就完美地實現圖片抓取、解碼、顯示，它甚至支持 GIF 動圖以及視頻快照。
在 InventoryApp 中，使用了 Glide 目前最新的 v4 版本（已穩定，v3 版本已不維護）的 Generated API ，主要原因是需要利用 Glide 的 多重變換 設置圖片 centerCrop 的裁剪模式以及四周圓角 (RoundedCorners)。Glide 的文檔非常豐富，上手非常簡單，所以這里不再贅述。
二、swapCursor
由于在 InventoryApp 中 RecyclerView 需要從 CursorLoader 接收數據，在 onLoadFinished 和 onLoaderReset 需要調用適配器的 swapCursor 方法，而 RecyclerView 沒有提供類似 ListView 的相應方法，所以需要在適配器中自己實現。
In InventoryAdapter.java
public void swapCursor(Cursor cursor) {mCursor = cursor;notifyDataSetChanged(); } 復制代碼在這里，swapCursor 方法的輸入參數為一個 Cursor 對象；在方法內，更新適配器內的 Cursor 全局變量，完成后通知適配器列表的數據集發生了變化。
三、列表子項的點擊事件監聽器
在 onCreateViewHolder 中生成的 View 對象表示每一個列表子項，對其設置 OnClickListener 就可以響應列表子項的點擊事件。
In InventoryAdapter.java
@NonNull @Override public InventoryAdapter.MyViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {View itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.list_item, parent, false);final MyViewHolder myViewHolder = new MyViewHolder(itemView);// Setup each item listener here.itemView.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View view) {int position = myViewHolder.getAdapterPosition();if (mOnItemClickListener != null) {// Send the click event back to the host activity.mOnItemClickListener.onItemClick(view, position, getItemId(position));}}});return myViewHolder; }public long getItemId(int position) {if (mCursor != null) {if (mCursor.moveToPosition(position)) {int idColumnIndex = mCursor.getColumnIndex(InventoryEntry._ID);return mCursor.getLong(idColumnIndex);}}return 0; } 復制代碼在 InventoryApp 中，RecyclerView 列表的每一個子項的被點擊時的動作是由 CatalogActivity 跳轉到 DetailActivity 中，這里要用到 Intent 組件，所以在 CatalogActivity 中響應列表子項的點擊事件比較合理。不過 RecyclerView.Adapter 沒有默認的子項點擊事件監聽器，所以這里需要自己實現。
In InventoryAdapter.java
private OnItemClickListener mOnItemClickListener;public void setOnItemClickListener(OnItemClickListener onItemClickListener) {mOnItemClickListener = onItemClickListener; }public interface OnItemClickListener {void onItemClick(View view, int position, long id); } 復制代碼這種代碼結構體現了典型的 Java 繼承特性。在 CatalogActivity 中實現 RecyclerView 列表子項的點擊事件響應代碼如下，可見 RecyclerView 的適配器調用 setOnItemClickListener 方法，傳入一個新的 OnItemClickListener 對象，并在其中實現 onItemClick 方法。代碼結構與 ListView 的 AdapterView.OnItemClickListener 相同。
In CatalogActivity.java
@Override protected void onCreate(Bundle savedInstanceState) {...mAdapter.setOnItemClickListener(new InventoryAdapter.OnItemClickListener() {@Overridepublic void onItemClick(View view, int position, long id) {Intent intent = new Intent(CatalogActivity.this, DetailActivity.class);Uri currentItemUri = ContentUris.withAppendedId(InventoryEntry.CONTENT_URI, id);intent.setData(currentItemUri);startActivity(intent);}}); } 復制代碼四、Empty View
為 RecyclerView 列表添加一個空視圖是提升用戶體驗的必要之舉，由于 RecyclerView 從 CursorLoader 接收數據，所以可以利用 CursorLoader 在加載數據完畢后的 onLoadFinished 方法中判斷列表的狀態，如果列表為空，則顯示空視圖；如果列表中有數據，則消除空視圖。
In CatalogActivity.java
@Override public void onLoadFinished(Loader<Cursor> loader, Cursor data) {mAdapter.swapCursor(data);View emptyView = findViewById(R.id.empty_view);if (mAdapter.getItemCount() == 0) {emptyView.setVisibility(View.VISIBLE);} else {emptyView.setVisibility(View.GONE);} } 復制代碼運行時權限請求
在 InventoryApp 中包含讀寫圖片文件的操作，這涉及了 Android 危險權限，所以應用需要請求 STORAGE 這一個權限組，以獲得讀寫外部存儲器中的文件的權限。關于 Android 權限的更多介紹可參考《課程 2: HTTP 網絡》。
因此，首先在 AndroidManifest 中添加 參數，放在頂級元素 下面。在這里，只添加了一條 WRITE_EXTERNAL_STORAGE 參數，而沒有添加 READ_EXTERNAL_STORAGE 參數。這是因為兩者屬于同一個權限組，應用獲得前者的寫權限時會自動獲取后者的讀權限。
In AndroidManifest.xml
<manifest xmlns:android="http://schemas.android.com/apk/res/android"package="com.example.android.inventoryapp"><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /><application ...>...</application> </manifest> 復制代碼Note:
從 Android 4.4 KitKat (API level 19) 開始，應用通過 getExternalFilesDir(String) 與 getExternalCacheDir() 讀寫應用自身目錄下（僅應用本身可見）的文件時，不需要請求 STORAGE 權限組。
至此，對于運行在 Android 5.1 (API level 22) 或以下的設備，InventoryApp 在安裝時 (Install Time)，就會彈出對話框，顯示應用請求的 STORAGE 權限組，用戶必須同意該權限請求，否則無法安裝應用。而對于運行在 Android 6.0 (API level 23) 或以上的設備，需要在 InventoryApp 運行時 (Runtime)，彈出對話框請求 STORAGE 權限組；如果應用沒有相關的代碼處理運行時權限請求，那么默認不具有該權限。
因此，應用需要在恰當的時機向用戶請求權限。由于 InventoryApp 所需的 STORAGE 權限組僅在進行圖片相關的操作時涉及到，所以在 DetailActivity 中處理圖片的唯一入口處設置 OnClickListener 來處理運行時權限請求。
In DetailActivity.java
@Override protected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_detail);...View imageContainer = findViewById(R.id.item_image_container);imageContainer.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {// Check permission before anything happens.if (hasPermissionExternalStorage()) {// Permission has already been granted, then start the dialog fragment.startImageChooserDialogFragment();}}}); } 復制代碼當圖片編輯框被點擊時，監聽器內會調用一個輔助方法，判斷是否已獲得所需的權限，若是則返回 true，才進行下面的工作。值得注意的是，InventoryApp 在每一次圖片編輯框被點擊時都必須檢查是否已獲得所需的權限，因為從 Android 6.0 Marshmallow (API level 23) 開始，用戶可隨時撤回給予應用的權限。
In DetailActivity.java
private boolean hasPermissionExternalStorage() {if (ContextCompat.checkSelfPermission(getApplicationContext(),Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {// Permission is NOT granted.if (ActivityCompat.shouldShowRequestPermissionRationale(DetailActivity.this,Manifest.permission.WRITE_EXTERNAL_STORAGE)) {// Show an explanation with snack bar to user if needed.Snackbar snackbar = Snackbar.make(findViewById(R.id.editor_container),R.string.permission_required, Snackbar.LENGTH_LONG);// Prompt user a OK button to request permission.snackbar.setAction(android.R.string.ok, new View.OnClickListener() {@Overridepublic void onClick(View v) {// Request the permission.ActivityCompat.requestPermissions(DetailActivity.this,new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},PERMISSION_REQUEST_EXTERNAL_STORAGE);}});snackbar.show();} else {// Request the permission directly, if it doesn't need to explain.ActivityCompat.requestPermissions(DetailActivity.this,new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},PERMISSION_REQUEST_EXTERNAL_STORAGE);}return false;} else {// Permission has already been granted, then return true.return true;} } 復制代碼（1）activity: 請求權限的當前 Activity，在這里即 DetailActivity。
（2）permissions: 需要請求的權限列表，作為一個字符串列表對象傳入，不能為空。
（3）requestCode: 該權限請求的唯一標識符，通常定義為一個全局的整數常量，它在接收權限請求的結果時會用到。
應用發起權限請求后，用戶的選擇會通過 onRequestPermissionsResult 方法獲取，在這里響應不同的請求結果。
In DetailActivity.java
@Override public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions,@NonNull int[] grantResults) {if (requestCode == PERMISSION_REQUEST_EXTERNAL_STORAGE) {if (grantResults.length == 1 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {// For the first time, permission was granted, then start the dialog fragment.startImageChooserDialogFragment();} else {// Prompt to user that permission request was denied.Toast.makeText(this, R.string.toast_permission_denied, Toast.LENGTH_SHORT).show();}} else {super.onRequestPermissionsResult(requestCode, permissions, grantResults);} } 復制代碼至此，運行時權限請求基本上就完成了，處理流程如下圖所示。更多信息可參考 這個 Android Developers 文檔。
Note:
InventoryApp 也使用了相機應用拍攝照片，但是這里不需要請求訪問相機的權限，因為 InventoryApp 并非直接操控攝像頭硬件模塊，而是通過 Intent 利用相機應用來獲取圖片資源，這也是使用 Intent 的一個優勢。
DialogFragment
在 InventoryApp 中，應用獲得讀寫外部存儲器文件的權限后，用戶點擊 DetailActivity 中的圖片編輯框時，會調用一個輔助方法，彈出一個標簽為 imageChooser 的自定義對話框，提供了兩個選項。
In DetailActivity.java
private void startImageChooserDialogFragment() {DialogFragment fragment = new ImageChooserDialogFragment();fragment.show(getFragmentManager(), "imageChooser"); } 復制代碼上述對話框自定義為 ImageChooserDialogFragment，放在單獨的 Java 文件中，屬于 DialogFragment 的子類。首先在 onCreateDialog 方法中，創建并返回一個 Dialog 對象。
In ImageChooserDialogFragment.java
public class ImageChooserDialogFragment extends DialogFragment {@Overridepublic Dialog onCreateDialog(Bundle savedInstanceState) {LayoutInflater inflater = getActivity().getLayoutInflater();View view = inflater.inflate(R.layout.dialog_image_chooser, null);AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());builder.setView(view);return builder.create();}... } 復制代碼由于 ImageChooserDialogFragment 的兩個選項的點擊事件都需要使用 Intent 組件，所以與上述 RecyclerView.Adapter 的列表子項點擊事件監聽器相同，這里也要在調用 ImageChooserDialogFragment 的 DetailActivity 中響應其中兩個選項的點擊事件。類似地，在 ImageChooserDialogFragment 中定義點擊事件的接口，以及相關的變量與方法。
In ImageChooserDialogFragment.java
private ImageChooserDialogListener mListener;@Override public void onAttach(Activity activity) {super.onAttach(activity);try {mListener = (ImageChooserDialogListener) activity;} catch (ClassCastException e) {throw new ClassCastException(activity.toString()+ " must implement ImageChooserDialogListener.");} }public interface ImageChooserDialogListener {void onDialogCameraClick(DialogFragment dialog);void onDialogGalleryClick(DialogFragment dialog); } 復制代碼In ImageChooserDialogFragment.java
@Override public Dialog onCreateDialog(Bundle savedInstanceState) {LayoutInflater inflater = getActivity().getLayoutInflater();View view = inflater.inflate(R.layout.dialog_image_chooser, null);View cameraView = view.findViewById(R.id.action_camera);View galleryView = view.findViewById(R.id.action_gallery);cameraView.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {// Send the camera click event back to the host activity.mListener.onDialogCameraClick(ImageChooserDialogFragment.this);// Dismiss the dialog fragment.dismiss();}});galleryView.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {// Send the gallery click event back to the host activity.mListener.onDialogGalleryClick(ImageChooserDialogFragment.this);// Dismiss the dialog fragment.dismiss();}});... } 復制代碼關于 Dialog 的更多信息可參考?這個 Android Developers 文檔。
通過相機應用拍攝照片以及在相冊中選取圖片
在調用 ImageChooserDialogFragment 的 DetailActivity 中響應其中兩個選項的點擊事件，即實現 ImageChooserDialogListener 接口內的兩個方法，這里完成了通過相機應用拍攝照片以及在相冊中選取圖片的功能。
In DetailActivity.java
public class DetailActivity extends AppCompatActivityimplements ImageChooserDialogFragment.ImageChooserDialogListener {public static final String FILE_PROVIDER_AUTHORITY = "com.example.android.fileprovider.camera";private static final int REQUEST_IMAGE_CAPTURE = 0;private static final int REQUEST_IMAGE_SELECT = 1;@Overridepublic void onDialogGalleryClick(DialogFragment dialog) {Intent selectPictureIntent = new Intent();selectPictureIntent.setAction(Intent.ACTION_GET_CONTENT);selectPictureIntent.setType("image/*");if (selectPictureIntent.resolveActivity(getPackageManager()) != null) {startActivityForResult(selectPictureIntent, REQUEST_IMAGE_SELECT);}}@Overridepublic void onDialogCameraClick(DialogFragment dialog) {Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);if (takePictureIntent.resolveActivity(getPackageManager()) != null) {File imageFile = null;try {imageFile = createCameraImageFile();} catch (IOException e) {Log.e(LOG_TAG, "Error creating the File " + e);}if (imageFile != null) {Uri imageURI = FileProvider.getUriForFile(this,FILE_PROVIDER_AUTHORITY, imageFile);takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, imageURI);startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE);}}} } 復制代碼（1）intent: 上面配置好的 Intent 對象，在這里即 selectPictureIntent。
（2）requestCode: Intent 的唯一標識符，通常定義為一個全局的整數常量，它在接收 Intent 的回傳數據時會用到。
（1）首先設置 Intent 的 URI 為 MediaStore.ACTION_IMAGE_CAPTURE。
（2）然后通過輔助方法創建一個 File 對象，這里需要捕捉可能由創建文件產生的 IOException 異常。
（3）如果成功創建 File 對象，那么就通過 FileProvider 的 getUriForFile 方法獲取該文件的 URI，并作為 EXTRA_OUTPUT 數據傳入 Intent，在這里就指定了相機應用拍攝的照片的存儲位置。
（4）最后通過 startActivityForResult 方法啟動帶有回傳數據的 Intent，其中唯一標識符為 REQUEST_IMAGE_CAPTURE。
（1）首先通過 SimpleDateFormat 獲得一個固定格式的時間戳，再加上前后綴就構成了一個抗沖突 (collision-resistant) 的文件名。
（2）然后通過 Environment 的 getExternalStoragePublicDirectory 方法，以及 Environment.DIRECTORY_PICTURES 輸入參數，獲取一個公共的圖片目錄。這樣用戶通過相機應用拍攝的照片就能被所有應用訪問，這是符合 Android 設計規范的。
（3）最后通過 File 的 createTempFile 方法創建并返回一個 File 對象，其中輸入參數包括上述定義的文件名以及存儲目錄。
（4）另外通過 File 對象的 getAbsolutePath() 方法獲取新建的圖片文件的目錄路徑，它在接收 Intent 的回傳數據時會用到。
In DetailActivity.java
private String mCurrentPhotoPath;private File createCameraImageFile() throws IOException {String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss", Locale.getDefault()).format(new Date());String imageFileName = "JPEG_" + timeStamp + "_";File storageDirectory = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES);File imageFile = File.createTempFile(imageFileName, /* prefix */".jpg", /* suffix */storageDirectory /* directory */);mCurrentPhotoPath = imageFile.getAbsolutePath();return imageFile;} 復制代碼（1）context: 當前的應用環境，在這里即 this 表示當前的 DetailActivity。
（2）authority: FileProvider 的主機名，必須與 AndroidManifest 中的一致。
（3）file: 需要獲取 URI 的 File 對象，在這里即上面生成的圖片文件 imageFile。
顯然，這里使用了 Android 提供的 FileProvider，需要在 AndroidManifest 中聲明。
In AndroidManifest.xml
<application>...<providerandroid:name="android.support.v4.content.FileProvider"android:authorities="com.example.android.fileprovider.camera"android:exported="false"android:grantUriPermissions="true"><meta-dataandroid:name="android.support.FILE_PROVIDER_PATHS"android:resource="@xml/file_paths" /></provider> </application> 復制代碼其中元數據指定了文件的目錄，定義在 xml/file_paths 目錄下。
In res/xml/file_paths.xml
<paths><!-- Declare the path to the public Pictures directory. --><external-path name="item_images" path="." /> </paths> 復制代碼由于圖片文件放在公共目錄下，所以 FileProvider 指定的文件目錄與應用內部的不同，具體可參考 這個 stack overflow 帖子。
通過相機應用拍攝照片以及在相冊中選取圖片的兩個 Intent 都是帶有回傳數據的，因此通過 override onActivityResult 方法獲取 Intent 的回傳數據。
In DetailActivity.java
private Uri mLatestItemImageUri = null;@Override protected void onActivityResult(int requestCode, int resultCode, Intent intent) {if (resultCode == RESULT_OK) {switch (requestCode) {case REQUEST_IMAGE_CAPTURE:mLatestItemImageUri = Uri.fromFile(new File(mCurrentPhotoPath));GlideApp.with(this).load(mLatestItemImageUri).transforms(new CenterCrop(), new RoundedCorners((int) getResources().getDimension(R.dimen.background_corner_radius))).into(mImageView);break;case REQUEST_IMAGE_SELECT:Uri contentUri = intent.getData();GlideApp.with(this).load(contentUri).transforms(new CenterCrop(), new RoundedCorners((int) getResources().getDimension(R.dimen.background_corner_radius))).into(mImageView);new copyImageFileTask().execute(contentUri);break;}} } 復制代碼In DetailActivity.java
private class copyImageFileTask extends AsyncTask<Uri, Void, Uri> {@Overrideprotected Uri doInBackground(Uri... uris) {if (uris[0] == null) {return null;}try {File file = createCopyImageFile();InputStream input = getContentResolver().openInputStream(uris[0]);OutputStream output = new FileOutputStream(file);byte[] buffer = new byte[4 * 1024];int bytesRead;while ((bytesRead = input.read(buffer)) > 0) {output.write(buffer, 0, bytesRead);}input.close();output.close();return Uri.fromFile(file);} catch (IOException e) {Log.e(LOG_TAG, "Error creating the File " + e);}return null;}@Overrideprotected void onPostExecute(Uri uri) {if (uri != null) {mLatestItemImageUri = uri;}} } 復制代碼不同的是，因為這里是從相冊選擇圖片的場景，如果把圖片復制到公共目錄下會對用戶造成困擾，所以這里通過 getExternalFilesDir 方法以及 Environment.DIRECTORY_PICTURES 輸入參數獲取應用內部的目錄，使復制的圖片文件對其它應用不可見。另外，這里不需要獲取復制文件的目錄路徑，所以沒有用到 FileProvider。
In DetailActivity.java
private File createCopyImageFile() throws IOException {String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss", Locale.getDefault()).format(new Date());String imageFileName = "JPEG_" + timeStamp + "_";File storageDirectory = getExternalFilesDir(Environment.DIRECTORY_PICTURES);return File.createTempFile(imageFileName, /* prefix */".jpg", /* suffix */storageDirectory /* directory */); } 復制代碼至此，通過相機應用拍攝照片以及在相冊中選取圖片的功能就實現了，不過還有一個非常明顯的優化項，那就是每一次用戶通過相機應用拍攝照片或在相冊中選取圖片時，應用都會新建一個圖片文件，如果用戶連續使用相機應用拍攝照片，或者連續在相冊中選取圖片，這會產生多個圖片文件，但最終應用只采用了最后一張圖片，甚至如果用戶此時放棄編輯，之前操作產生的多個文件都作廢了，徒增設備和應用的占用內存。
因此，應用要能夠刪除無用的文件，分為三種情況處理。
一、在相機應用中途取消拍攝照片
對于通過相機應用拍攝照片的操作，只要用戶點擊了 ImageChooserDialogFragment 的相機選項，不管 Intent 請求是否成功，應用都會新建一個文件，所以需要在 onActivityResult 中添加 Intent 請求不成功時的執行代碼，例如用戶點擊了對話框的相機選項，跳轉到相機應用，但沒有成功拍攝照片就回到 InventoryApp，此時就需要刪除這個操作新建的圖片文件。
In DetailActivity.java
@Override protected void onActivityResult(int requestCode, int resultCode, Intent intent) {if (resultCode == RESULT_OK) {switch (requestCode) {case REQUEST_IMAGE_CAPTURE:...mCurrentPhotoPath = null;break;case REQUEST_IMAGE_SELECT:...}} else if (mCurrentPhotoPath != null) {File file = new File(mCurrentPhotoPath);if (file.delete()) {Toast.makeText(this, android.R.string.cancel, Toast.LENGTH_SHORT).show();}} } 復制代碼需要注意的是，在相冊中選取圖片的操作也會觸發 onActivityResult，例如用戶首先通過相機應用拍攝了一張照片，隨后又點擊了對話框的相冊選項，跳轉到相冊，但沒有選擇圖片就回到 InventoryApp；由于刪除動作是根據 mCurrentPhotoPath 是否為 null 來觸發的，如果上次通過相機應用拍攝照片返回的數據處理完畢后沒有清空 mCurrentPhotoPath 的話，就會誤刪用戶之前通過相機應用拍攝的照片。因此，在通過相機應用拍攝照片的 case 條目內，處理完返回數據后，要將 mCurrentPhotoPath 設為 null。
二、重復通過相機應用拍攝照片或重復在相冊中選取圖片
用戶連續使用相機應用拍攝照片，或者連續在相冊中選取圖片，這會產生多個圖片文件，但最終應用只采用了最后一張圖片，對此的策略是在更換新圖片之前刪除舊圖片。
In DetailActivity.java
@Override protected void onActivityResult(int requestCode, int resultCode, Intent intent) {if (resultCode == RESULT_OK) {deleteFile();...} }private void deleteFile() {if (mLatestItemImageUri != null) {File file = new File(mLatestItemImageUri.getPath());if (file.delete()) {Log.v(LOG_TAG, "Previous file deleted.");}} } 復制代碼三、用戶放棄編輯
用戶通過相機應用拍攝照片或從相冊選取圖片之后，沒有保存就點擊 BACK 或 UP 按鈕放棄編輯，這會導致新建的圖片文件無用，所以對策是在 BACK 或 UP 按鈕的點擊事件監聽器中調用輔助方法 deleteFile 刪除舊圖片。
Intent to Email with Attachment
在 DetailActivity 的編輯模式下，菜單欄有一個訂購按鈕可以 Intent 到郵箱應用，并且帶有當前貨物的信息，包括將圖片文件放入郵件的附件。
In DetailActivity.java
Intent intent = new Intent(Intent.ACTION_SENDTO); intent.setData(Uri.parse("mailto:"));String subject = "Order " + mCurrentItemName;intent.putExtra(Intent.EXTRA_SUBJECT, subject);StringBuilder text = new StringBuilder(getString(R.string.intent_email_text, mCurrentItemName)); text.append(System.getProperty("line.separator")); intent.putExtra(Intent.EXTRA_STREAM, Uri.parse(mCurrentItemImage));intent.putExtra(Intent.EXTRA_TEXT, text.toString());if (intent.resolveActivity(getPackageManager()) != null) {startActivity(intent); } 復制代碼InputFilter
與 實戰項目 9: 習慣記錄應用 類似，InventoryApp 中的價格 EditText 的輸入限制也是由一個自定義 InputFilter 類實現的。
private class DigitsInputFilter implements InputFilter {private Pattern mPattern;private DigitsInputFilter(int digitsBeforeDecimalPoint, int digitsAfterDecimalPoint) {mPattern = Pattern.compile(getString(R.string.price_pattern,digitsBeforeDecimalPoint - 1, digitsAfterDecimalPoint));}@Overridepublic CharSequence filter(CharSequence source, int start, int end,Spanned dest, int dstart, int dend) {String inputString = dest.toString().substring(0, dstart)+ source.toString().substring(start, end)+ dest.toString().substring(dend, dest.toString().length());Matcher matcher = mPattern.matcher(inputString);if (!matcher.matches()) {return "";}return null;} } 復制代碼（1）以 0 開頭，接下來僅接受小數點 (.) 輸入，不允許更多的 0 或 1～9 數字輸入；小數點后允許最多兩位 0～9 數字輸入。
（2）以 1～9 開頭，接下來可輸入小數點 (.) 或最多九位 0～9 數字輸入；小數點后允許最多兩位 0～9 數字輸入。
（3）不允許以小數點 (.) 開頭。
禁止設備屏幕旋轉
在 InventoryApp 中，存在一種情況，即用戶本來以垂直方向手持設備，但是在向貨物添加圖片時，用戶把設備橫放在相機應用拍攝照片，這會導致 InventoryApp 的 DetailActivity 在后臺被銷毀，用戶拍完照片回來時應用就奔潰了。因此，InventoryApp 的 DetailActivity 需要禁止設備屏幕旋轉，在 AndroidManifest 中設置相關參數。
In AndroidManifest.xml
<activityandroid:name=".DetailActivity"android:screenOrientation="sensorPortrait"android:configChanges="keyboardHidden|orientation|screenSize"android:parentActivityName=".CatalogActivity"android:theme="@style/AppTheme"android:windowSoftInputMode="stateHidden"><!-- Parent activity meta-data to support 4.0 and lower --><meta-dataandroid:name="android.support.PARENT_ACTIVITY"android:value=".CatalogActivity" /> </activity> 復制代碼Drawable Resources
在 Android 中 Drawable 資源除了由 png、jpg、gif 等文件提供的圖片文件之外，還有許多直接由 xml 文件提供的資源。例如在 InventoryApp 中，background_border.xml 提供了 CatalogActivity 的列表子項以及 DetailActivity 的圖片的邊框背景，它屬于 Shape Drawable；image_chooser_item_color_list.xml 則提供了添加圖片對話框中的選項在不同點按狀態下的顏色，它屬于 State List Drawable。Drawable Resources 的文檔非常詳盡，邏輯也不復雜，所以在此不再贅述。
FloatingActionButton
FloatingActionButton 的位置可以錨定 (anchor) 到某一個視圖上，如上圖所示，銷售按鈕錨定在貨物圖片的右下角，通過以下代碼可以實現。
In list_item.xml
<android.support.design.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"...><LinearLayout .../><android.support.design.widget.FloatingActionButton...android:layout_margin="@dimen/activity_spacing"android:src="@drawable/ic_sell_white_24dp"app:layout_anchor="@id/item_image"app:layout_anchorGravity="bottom|right|end" /> </android.support.design.widget.CoordinatorLayout> 復制代碼總結
以上是生活随笔為你收集整理的实战项目 10: 货物清单应用的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 数据分析方法有哪些？
- 下一篇： 一大波 Android 刘海屏来袭，全网