Expo大作戰(三十八)--expo sdk api之 FileSystem(文件操作系統)

簡要：本系列文章講會對expo進行全面的介紹，本人從2017年6月份接觸expo以來，對expo的研究斷斷續續，一路走來將近10個月，廢話不多說，接下來你看到內容，講全部來與官網我猜去全部機翻+個人修改補充+demo測試的形式，對expo進行一次大補血！歡迎加入expo興趣學習交流群：597732 ...

簡要：本系列文章講會對expo進行全面的介紹，本人從2017年6月份接觸expo以來，對expo的研究斷斷續續，一路走來將近10個月，廢話不多說，接下來你看到內容，講全部來與官網

我猜去全部機翻+個人修改補充+demo測試的形式，對expo進行一次大補血！歡迎加入expo興趣學習交流群：597732981

【之前我寫過一些列關於expo和rn入門配置的東i西，大家可以點擊這裡查看：從零學習rn開發】

相關文章：

Expo大作戰(一)--什麼是expo，如何安裝expo clinet和xde，xde如何使用

Expo大作戰(二)--expo的生命周期，expo社區交流方式，expo學習必備資源，開發使用expo時關註的一些問題

Expo大作戰(三)--針對已經開發過react native項目開發人員有針對性的介紹了expo，expo的局限性，開發時項目選型註意點等

Expo大作戰(四)--快速用expo構建一個app，expo中的關鍵術語

Expo大作戰(五)--expo中app.json 文件的配置信息

Expo大作戰(六)--expo開發模式，expo中exp命令行工具，expo中如何查看日誌log，expo中的調試方式

Expo大作戰(七)--expo如何使用Genymotion模擬器

Expo大作戰(八)--expo中的publish以及expo中的link，對link這塊東西沒有詳細看，大家可以來和我交流

更多>>

寫在二十三章以後的話，之前的翻譯，不管如何，好與不好，終究是告一段落，也把expo基礎理論的東西又深入的理解了一遍，後續expo大作戰系列將主要介紹expo sdk的api。

文件系統

提供對本地存儲在設備上的文件系統的訪問。每個Expo應用程式都有獨立的文件系統，無法訪問其他Expo應用程式的文件系統。該API將file：// URI指向設備上的本地文件以識別文件。每個應用程式只能讀取和寫入以下目錄下的位置：

Expo.FileSystem.documentDirectory

file：// URI指向將存儲此應用程式的用戶文檔的目錄。存儲在這裡的文件將保留直到被應用程式明確刪除。尾隨/。示例用途用於用戶保存的文件，以便他們再次看到。

Expo.FileSystem.cacheDirectory

file：// URI指向存儲此應用程式使用的臨時文件的目錄。存儲空間不足時，此處存儲的文件可能會被系統自動刪除。示例用途用於應用程式只需要一次性使用的下載或生成的文件。

因此，例如，應用程式用戶文檔目錄中“myDirectory”下名為“myFile”的文件的URI將為Expo.FileSystem.documentDirectory +'myDirectory / myFile'。

創建文件的Expo API通常在這些目錄中運行。這包括音頻錄製，相機照片，ImagePicker結果，SQLite資料庫和takeSnapShotAsync（）結果。這允許它們與FileSystem API一起使用。

某些FileSystem功能可以讀取（但不寫入）其他位置。目前Expo.FileSystem.getInfoAsync（）和Expo.FileSystem.copyAsync（）能夠從React Native中的CameraRoll.getPhotos（）返回的URI中讀取。

Expo.FileSystem.getInfoAsync（fileUri，options）
獲取關於文件或目錄的元數據信息。

參數
fileUri（string） - file：//指向文件或目錄的URI，或CameraRoll.getPhotos（）返回的URI。

options(object) - 選項圖：

md5（boolean） - 是否返迴文件的MD5哈希值。預設為false。

size（boolean） - 如果在來自CameraRoll.getPhotos（）的源文件上操作，是否包含文件的大小（例如，如果文件存儲在iCloud中，則跳過這可以防止下載文件）。大小總是返回file：//locations。

返回
如果此URI不存在項目，則返回{exists：false，isDirectory：false}。否則返回包含以下欄位的對象：

exists（boolean） - true。

isDirectory（boolean） - 如果這是一個目錄，則為true;如果是文件，則為false

modificationTime (number)  - 自紀元以來以秒為單位表示的文件的最後修改時間。

size (number)  - 文件的大小（以位元組為單位）。如果在來自CameraRoll.getPhotos（）的源上進行操作，則僅在尺寸選項非常真實時才存在。

uri (string)  - 指向文件的file：// URI。這與fileUri輸入參數相同。

md5 (string)  - 如果md5選項真的存在，則顯示。包含文件的MD5哈希。

Expo.FileSystem.readAsStringAsync（fileURI）
以字元串形式讀取文件的全部內容。

參數
fileUri（string） - 文件：//文件或目錄的URI。

返回
包含文件全部內容的字元串。

Expo.FileSystem.writeAsStringAsync（fileUri，contents）
以字元串形式寫入文件的全部內容。

參數
fileUri（string） - file：//文件或目錄的URI。

contents（string） - 用來替換文件內容的字元串。

Expo.FileSystem.deleteAsync（fileUri，options）
刪除文件或目錄。如果URI指向一個目錄，則該目錄及其所有內容將被遞歸刪除。

參數
fileUri（string） - file：//文件或目錄的URI。

options(object) - 選項圖：

idempotent（boolean） - 如果為true，則在此URI沒有文件或目錄時不要拋出錯誤。預設為false。

Expo.FileSystem.moveAsync（options）
將文件或目錄移動到新位置。

參數
options(object) - 選項圖：

from (string)  - file：// URI到原始位置的文件或目錄。

to (string)  - file：// URI指向文件或目錄，該文件或目錄應該是其新位置。

Expo.FileSystem.copyAsync（options）
創建文件或目錄的副本。目錄以其所有內容遞歸複製。

參數
options(object) - 選項圖：

from(string) - file：// URI複製到要複製的文件或目錄，或由CameraRoll.getPhotos（）返回的URI。

to（string） - 要創建的新副本的file：// URI。

Expo.FileSystem.makeDirectoryAsync（fileUri，options）
創建一個新的空目錄。

參數
fileUri（string） - file：//創建新目錄的URI。

options(object) - 選項圖：

intermediates（boolean） - 如果為true，則在fileUri上創建目錄時創建任何不存在的父目錄。如果為false，則在任何中間父目錄不存在時引發錯誤。預設為false。

Expo.FileSystem.readDirectoryAsync（fileURI）
枚舉目錄的內容。

參數
fileUri（string） - file：//目錄的URI。

返回
一串字元串，每個字元串都包含文件或目錄名稱

Expo.FileSystem.downloadAsync（uri，fileUri，options）
將遠程URI處的內容下載到應用程式文件系統中的文件中。

例
FileSystem.downloadAsync(
  'http://techslides.com/demos/sample-videos/small.mp4',
  FileSystem.documentDirectory + 'small.mp4'
)
  .then(({ uri }) => {
    console.log('Finished downloading to ', uri);
  })
  .catch(error => {
    console.error(error);
  });
參數
url（string） - 要從其下載的遠程URI。

fileUri（string） - 要下載到的文件的本地URI。如果此URI沒有文件，則會創建一個新文件。如果這個URI有一個文件，它的內容將被替換。

options(object) - 選項圖：

md5（boolean） - 如果為true，則在返回的對象中包含文件的MD5哈希。預設為false。為方便起見，因為通常在下載後立即檢查文件的完整性。

返回
返回包含以下欄位的對象：

uri（string） - 指向文件的file：// URI。這與fileUri輸入參數相同。

status (number)  - 下載網路請求的HTTP狀態碼。

headers (object)  - 包含所有HTTP標頭欄位及其下載網路請求值的對象。對象的鍵和值分別是標題名稱和值。

md5 (string) - 如果md5選項真的存在，則顯示。包含文件的MD5哈希。

Expo.FileSystem.createDownloadResumable（uri，fileUri，options，callback，resumeData）
創建一個DownloadResumable對象，它可以啟動，暫停和恢復將遠程URI下載的內容下載到應用文件系統中的文件。請註意：您需要在DownloadResumable實例上調用downloadAsync（）以啟動下載。 DownloadResumable對象具有提供下載進度更新的回調。通過使用AsyncStorage存儲DownloadResumable.savable（）對象以供日後檢索，可以跨應用程式重新啟動恢復下載。可保存對象包含在重新啟動應用程式後初始化新的DownloadResumable對象以恢復下載所需的參數。

參數
url（string） - 要從其下載的遠程URI。

fileUri（string） - 要下載到的文件的本地URI。如果此URI沒有文件，則會創建一個新文件。如果這個URI有一個文件，它的內容將被替換。

options(object) - 選項圖：

md5（boolean） - 如果為true，則在返回的對象中包含文件的MD5哈希。預設為false。為方便起見，因為通常在下載後立即檢查文件的完整性。

headers (object)  - 包含請求所需的任何附加HTTP頭欄位的對象。對象的鍵和值分別是標題名稱和值。

callback(function) - 在每次寫入數據時調用此函數以更新下載進度。傳遞以下欄位的對象：

totalBytesWritten（number） - 下載操作寫入的總位元組數。

totalBytesExpectedToWrite（number） - 預計由下載操作寫入的位元組總數。

resumeData（string） - 允許api恢復暫停下載的字元串。這在下載暫停時自動設置在DownloadResumable對象上。初始化新的DownloadResumable時，它應該為空。

Expo.FileSystem.DownloadResumable.downloadAsync（）
將遠程URI處的內容下載到應用程式文件系統中的文件中。

返回
返回包含以下欄位的對象：

uri（string） - 指向文件的file：// URI。這與fileUri輸入參數相同。

status (number) - 下載網路請求的HTTP狀態碼。

headers (object)  - 包含所有HTTP標頭欄位及其下載網路請求值的對象。對象的鍵和值分別是標題名稱和值。

md5（string） - 如果md5選項真的存在，則顯示。包含文件的MD5哈希。

Expo.FileSystem.DownloadResumable.pauseAsync（）
暫停當前的下載操作。在成功暫停操作後，resumeData被添加到DownloadResumable對象中。返回可以使用AsyncStorage進行保存以供將來檢索的對象（與調用Expo.FileSystem.DownloadResumable.savable（）時返回的對象相同。請參見下麵的示例。

返回
返回包含以下欄位的對象：

url（string） - 要從其下載的遠程URI。

fileUri（string） - 要下載到的文件的本地URI。如果此URI沒有文件，則會創建一個新文件。如果這個URI有一個文件，它的內容將被替換。

options(object) - 選項圖：

md5（boolean） - 如果為true，則在返回的對象中包含文件的MD5哈希。預設為false。為方便起見，因為通常在下載後立即檢查文件的完整性。

resumeData（string） - 允許API恢復暫停下載的字元串。

Expo.FileSystem.DownloadResumable.resumeAsync（）
恢復暫停的下載操作。

返回
返回包含以下欄位的對象：

uri（string） - 指向文件的file：// URI。這與fileUri輸入參數相同。

status (number) - 下載網路請求的HTTP狀態碼。

headers (object)  - 包含所有HTTP標頭欄位及其下載網路請求值的對象。對象的鍵和值分別是標題名稱和值。

md5（string） - 如果md5選項真的存在，則顯示。包含文件的MD5哈希。

Expo.FileSystem.DownloadResumable.savable（）
返回可以與AsyncStorage一起保存的對象以供將來檢索。

返回
返回包含以下欄位的對象：

url（string） - 要從其下載的遠程URI。

fileUri（string） - 要下載到的文件的本地URI。如果此URI沒有文件，則會創建一個新文件。如果這個URI有一個文件，它的內容將被替換。

options(object) - 選項圖：

md5（boolean） - 如果為true，則在返回的對象中包含文件的MD5哈希。預設為false。為方便起見，因為通常在下載後立即檢查文件的完整性。

resumeData（string） - 允許api恢復暫停下載的字元串。

例
const callback = downloadProgress => {
  const progress =
    downloadProgress.totalBytesWritten /
    downloadProgress.totalBytesExpectedToWrite;
  this.setState({
    downloadProgress: progress,
  });
};

const downloadResumable = FileSystem.createDownloadResumable(
  'http://techslides.com/demos/sample-videos/small.mp4',
  FileSystem.documentDirectory + 'small.mp4',
  {},
  callback
);

try {
  const { uri } = await downloadResumable.downloadAsync();
  console.log('Finished downloading to ', uri);
} catch (e) {
  console.error(e);
}

try {
  await downloadResumable.pauseAsync();
  console.log('Paused download operation, saving for future retrieval');
  AsyncStorage.setItem(
    'pausedDownload',
    JSON.stringify(downloadResumable.savable())
  );
} catch (e) {
  console.error(e);
}

try {
  const { uri } = await downloadResumable.resumeAsync();
  console.log('Finished downloading to ', uri);
} catch (e) {
  console.error(e);
}

//To resume a download across app restarts, assuming the the DownloadResumable.savable() object was stored:
const downloadSnapshotJson = await AsyncStorage.getItem('pausedDownload');
const downloadSnapshot = JSON.parse(downloadJson);
const downloadResumable = new FileSystem.DownloadResumable(
  downloadSnapshot.url,
  downloadSnapshot.fileUri,
  downloadSnapshot.options,
  callback,
  downloadSnapshot.resumeData
);

try {
  const { uri } = await downloadResumable.resumeAsync();
  console.log('Finished downloading to ', uri);
} catch (e) {
  console.error(e);
}
下一張繼續介紹，這一篇主要介紹了：expo sdk api之 FileSystem(文件操作系統)！，歡迎大家關註我的微信公眾號，這篇文章是否被大家認可，我的衡量標準就是公眾號粉絲增長人數。歡迎大家轉載，但必須保留本人博客鏈接！