注：本文翻譯自Google官方的Android Developers Training文檔，譯者技術一般，由于喜愛安卓而產生了翻譯的念頭，純屬個人興趣愛好。
原文鏈接： http://developer.android.com/training/secure-file-sharing/share-file.html
一旦你配置了你的應用來使用URI共享文件，你可以響應其他應用關于這些文件的需求。一種響應的方法是在服務應用端提供一個文件選擇接口，它可以由其他應用激活。這種方法可以允許客戶應用端讓用戶從服務應用端選擇一個文件，然后接收這個文件的URI。
這節課將會向你展示如何在你的應用中創建一個用來選擇文件的 Activity ，來響應這些索取文件的需求。
一）. 接收文件需求
為了從客戶應用端接收一個文件索取需求，然后以URI形式進行響應，你的應用應該提供一個選擇文件的
Activity
。客戶應用端通過調用
startActivityForResult()
來啟動這個
Activity
。該方法包含了一個
Intent
，它具有
ACTION_PICK
行為。當客戶應用端調用了
startActivityForResult()
，你的應用可以向客戶應用端返回一個結果，該結果即用戶所選文件對應的URI。
學習如何在客戶應用端實現文件索取需求，閱讀： Requesting a Shared File 。
二）. 創建一個文件選擇Activity
為了配置文件選擇
Activity
，我們從在清單文件定義你的
Activity
開始，在其intent過濾器中，匹配
ACTION_PICK
行為，以及
CATEGORY_DEFAULT
和
CATEGORY_OPENABLE
類型。另外，為你的應用向其他應用所提供的文件設置MIME類型過濾器。下面的這段代碼展示了如何在清單文件中定義新的
Activity
和intent過濾器：
<
manifest
xmlns:android
="http://schemas.android.com/apk/res/android"
>
...
<
application
>
...
<
activity
android:name
=".FileSelectActivity"
android:label
="@"
File Selector"
>
<
intent-filter
>
<
action
android:name
="android.intent.action.PICK"
/>
<
category
android:name
="android.intent.category.DEFAULT"
/>
<
category
android:name
="android.intent.category.OPENABLE"
/>
<
data
android:mimeType
="text/plain"
/>
<
data
android:mimeType
="image/*"
/>
</
intent-filter
>
</
activity
>
在代碼中定義文件選擇Activity
下面，定義一個 Activity 子類它顯示在你內部存儲的“ files/images/ ”目錄下可以獲得的文件，然后允許用戶選擇期望的文件。下面的代碼顯示了如何定義這個 Activity 。并且響應用戶的選擇：
public
class
MainActivity
extends
Activity {
//
The path to the root of this app's internal storage
private
File mPrivateRootDir;
//
The path to the "images" subdirectory
private
File mImagesDir;
//
Array of files in the images subdirectory
File[] mImageFiles;
//
Array of filenames corresponding to mImageFiles
String[] mImageFilenames;
//
Initialize the Activity
@Override
protected
void
onCreate(Bundle savedInstanceState) {
...
//
Set up an Intent to send back to apps that request a file
mResultIntent =
new
Intent("com.example.myapp.ACTION_RETURN_FILE"
);
//
Get the files/ subdirectory of internal storage
mPrivateRootDir =
getFilesDir();
//
Get the files/images subdirectory;
mImagesDir =
new
File(mPrivateRootDir, "images"
);
//
Get the files in the images subdirectory
mImageFiles =
mImagesDir.listFiles();
//
Set the Activity's result to null to begin with
setResult(Activity.RESULT_CANCELED,
null
);
/*
* Display the file names in the ListView mFileListView.
* Back the ListView with the array mImageFilenames, which
* you can create by iterating through mImageFiles and
* calling File.getAbsolutePath() for each File
*/
...
}
...
}
三）. 響應一個文件選擇
一旦一個用戶選擇了一個共享的文件，你的應用必須明確哪個文件被選擇了，然后為這個文件生成一個對應的URI。若 Activity 在 ListView 中顯示了可獲得文件的清單，當用戶點擊了一個文件名時，系統調用了方法 onItemClick() ，在該方法中你可以獲取被選擇的文件。
在 onItemClick() 中，為選擇的文件文件名獲取一個 File 對象，然后將它作為參數傳遞給 getUriForFile() ，另外還需傳入的參數是你為 FileProvider 所指定的 <provider> 標簽值。這個結果URI包含了相應的被訪問權限，一個對應于文件目錄的路徑標記（如在XML meta-date中定義的），以及包含擴展名的文件名。有關 FileProvider 如何了解基于XML meta-data的目錄路徑的信息，可以閱讀： Specify Sharable Directories 。
下面的例子展示了你如何檢測選中的文件并且獲得一個URI： ?
protected
void
onCreate(Bundle savedInstanceState) {
...
//
Define a listener that responds to clicks on a file in the ListView
mFileListView.setOnItemClickListener(
new
AdapterView.OnItemClickListener() {
@Override
/*
* When a filename in the ListView is clicked, get its
* content URI and send it to the requesting app
*/
public
void
onItemClick(AdapterView<?>
adapterView,
View view,
int
position,
long
rowId) {
/*
* Get a File for the selected file name.
* Assume that the file names are in the
* mImageFilename array.
*/
File requestFile
=
new
File(mImageFilename[position]);
/*
* Most file-related method calls need to be in
* try-catch blocks.
*/
//
Use the FileProvider to get a content URI
try
{
fileUri
=
FileProvider.getUriForFile(
MainActivity.
this
,
"com.example.myapp.fileprovider"
,
requestFile);
}
catch
(IllegalArgumentException e) {
Log.e(
"File Selector"
,
"The selected file can't be shared: " +
clickedFilename);
}
...
}
});
...
}
?
記住，你能生成的那些URI所對應的文件，是那些在meta-data文件中包含 <paths>標簽的（即你定義的）目錄內的文件，這方面知識在 Specify Sharable Directories （博客鏈接： http://www.cnblogs.com/jdneo/p/3480405.html ）中已經討論過。如果你為一個在你沒有指定的目錄內的文件調用了 getUriForFile() 方法，你會收到一個 IllegalArgumentException 。
三）. 為文件授權 ?
現在你有了你想要共享給其他應用的文件URI，你需要允許客戶應用端訪問這個文件。為了允許訪問，可以通過將URI添加至一個 Intent ，然后為該 Intent 設置權限標記。你所授予的權限是臨時的，并且當接收應用的任務棧被完成后，會自動過期。
下面的例子展示了如何為文件設置讀權限：
protected
void
onCreate(Bundle savedInstanceState) {
...
//
Define a listener that responds to clicks in the ListView
mFileListView.setOnItemClickListener(
new
AdapterView.OnItemClickListener() {
@Override
public
void
onItemClick(AdapterView<?>
adapterView,
View view,
int
position,
long
rowId) {
...
if
(fileUri !=
null
) {
//
Grant temporary read permission to the content URI
mResultIntent.addFlags(
Intent.FLAG_GRANT_READ_URI_PERMISSION);
}
...
}
...
});
...
}
Caution：
調用 setFlags() 是唯一安全的方法，為你的文件授予臨時的被訪問權限。避免對文件URI調用 Context.grantUriPermission() ，因為通過該方法授予的權限，你只能通過調用 Context.revokeUriPermission() 來撤銷。
四）. 與需求應用共享文件
為了與需求應用共享其需要的文件，將包含了URI和響應權限的 Intent 傳遞給 setResult() 。當你定義的 Activity 被結束后，系統會把這個包含了URI的 Intent 傳遞給客戶端應用。下面的例子展示了你應該如何做：
protected
void
onCreate(Bundle savedInstanceState) {
...
//
Define a listener that responds to clicks on a file in the ListView
mFileListView.setOnItemClickListener(
new
AdapterView.OnItemClickListener() {
@Override
public
void
onItemClick(AdapterView<?>
adapterView,
View view,
int
position,
long
rowId) {
...
if
(fileUri !=
null
) {
...
//
Put the Uri and MIME type in the result Intent
mResultIntent.setDataAndType(
fileUri,
getContentResolver().getType(fileUri));
//
Set the result
MainActivity.
this
.setResult(Activity.RESULT_OK,
mResultIntent);
}
else
{
mResultIntent.setDataAndType(
null
, ""
);
MainActivity.
this
.setResult(RESULT_CANCELED,
mResultIntent);
}
}
});
?
向用戶提供一個一旦他們選擇了文件就能立即回到客戶應用的方法。一種實現的方法是提供一個勾選框或者一個 完成 按鈕。使用按鈕的 android:onClick 屬性字段為它關聯一個方法。在該方法中，調用 finish() 。例如：
public
void
onDoneClick(View v) {
//
Associate a method with the Done button
finish();
}
更多文章、技術交流、商務合作、聯系博主
微信掃碼或搜索：z360901061
微信掃一掃加我為好友
QQ號聯系： 360901061
您的支持是博主寫作最大的動力，如果您喜歡我的文章，感覺我的文章對您有幫助，請用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧，狠狠點擊下面給點支持吧，站長非常感激您！手機微信長按不能支付解決辦法：請將微信支付二維碼保存到相冊，切換到微信，然后點擊微信右上角掃一掃功能，選擇支付二維碼完成支付。
【本文對您有幫助就好】元
