Android最佳實踐之設置文件分享

原文鏈接:Setting Up File Sharing

本課程教你:

為了安全在應用之間分享文件,你需要設置你的應用提供一種處理文件的安全機制,該機制采用content URI的形式。Android FileProvider 組件基于你在XML中提供的內容來產生文件的content URIs。本課程教你怎樣在你的應用中添加一個默認的 FileProvider,怎樣指定你想提供給其他應用的文件。

注意:FileProvider 類是 v4 Support Library 的一部分。關于這個庫的更多信息,請參考 Support Library Setup.

指定FileProvider

為了你的應用定義一個 FileProvider ,你需要在manifest文件中設置一個入口。這個入口指定了使用content URIs需要的權限以及包含能夠分享的文件目錄的XML文件名稱。

下面這段代碼教你如何在manifest 文件中添加 <provider> 元素來指定一個 FileProvider 類,相關的權限以及XML文件名稱:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp">
    <application
         ...>
         <provider
              android:name="android.support.v4.content.FileProvider"
              android:authorities="com.example.myapp.fileprovider"
              android:grantUriPermissions="true"
              android:exported="false">
              <meta-data
                  android:name="android.support.FILE_PROVIDER_PATHS"
                  android:resource="@xml/filepaths" />
        </provider>
        ...
     </application>
</manifest>

在這個例子中, android:authorities
屬性定義了由 FileProvider 產生的content URIs使用時需要的授權。這本例子中,這個權限是com.example.myapp.fileprovider。對于你自己的應用,指定一個由應用的 android:package 值加上"fileprovider"字符串作為授權。關于授權的更多內容,請參考 Content URIsandroid:authorities 相關的文檔。

<provider> 的子元素 <meta-data> 指向一個XML文件,該文件包含你希望分享的文件目錄。android:resource屬性是文件的路徑和名字,不需要加上.xml的擴展名。文件的內容將在寫一部分介紹。

指定可分享的目錄

一旦你在應用的manifest文件中添加了 FileProvider,你需要指定包含你希望分享的文件的路徑。為了指定這個路徑,在你的工程res/xml/子目錄下創建filepaths.xml文件。在這個文件里面為每一個路徑添加一個XML元素。下面這段代碼顯示了一個res/xml/filepaths.xml具體內容的例子。這段代碼也顯示了如何在內部存儲器的files/目錄下分享一個子目錄的路徑。

<paths>
    <files-path path="images/" name="myimages" />
</paths>

在這個例子中,<files-path>標簽分享了在你的應用的內部存儲器中的files/路徑。path屬性分享了files/下面的images/子目錄。name屬性告訴 FileProvider 對于files/images/子目錄在content URIs中添加一個myimages路徑段。

<paths>元素可以有多個子元素,每個子元素指定一個不同的分享路徑。除了<files-path>元素之外,你也可以使用<external-path>來分享外部存儲器的路徑,使用<cache-path>來分享內部緩存路徑。關于指定分享路徑的子元素的更多信息,參見 FileProvider 相關文檔。

注意:這個XML文件是唯一能指定分享路徑的方法,你不能在程序中動態的添加一個路徑。

現在,對于你的應用內部存儲器的files路徑以及files子路徑下的文件,你已經完成了使用 FileProvider 為它們生成對應的content URIs。當你的應用為文件生成一個content URI時,它包含指定在 <provider> 元素中的授權、myimages/路徑以及該文件的名字。

例如,如果你根據本課程的代碼定義一個 FileProvider,如果你請求default_image.jpg的content URI,FileProvider 會返回下面的URI:

content://com.example.myapp.fileprovider/myimages/default_image.jpg

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,702評論 6 534
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,615評論 3 419
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,606評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,044評論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,826評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,227評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,307評論 3 442
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,447評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,992評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,807評論 3 355
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,001評論 1 370
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,550評論 5 361
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,243評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,667評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,930評論 1 287
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,709評論 3 393
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,996評論 2 374

推薦閱讀更多精彩內容