简要:本系列文章讲会对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(文件操作系统)!,欢迎大家关注我的微信公众号,这篇文章是否被大家认可,我的衡量标准就是公众号粉丝增长人数。欢迎大家转载,但必须保留本人博客链接!