ios App沙盒（sandbox）模型文件目录详解 Swift3版本

 iOS 中的沙盒机制介绍

iOS 中的沙盒机制（SandBox）是一种安全体系。
每个 iOS 应用程序都有一个单独的文件系统（存储空间），而且只能在对应的文件系统中进行操作，此区域被称为沙盒。所有的非代码文件都要保存在此，例如属性文件 plist、文本文件、图像、图标、媒体资源等。

iPhone沙箱模型的四个文件夹介绍和功能

1、Documents 目录：您应该将所有de应用程序数据文件写入到这个目录下。这个目录用于存储用户数据或其它应该定期备份的信息。用户自己保存的文件在documents文件里

2、AppName.app 目录：这是应用程序的程序包目录，包含应用程序的本身。由于应用程序必须经过签名，所以您在运行时不能对这个目录中的内容进行修改，否则可能会使应用程序无法启动。

3、Library 目录：这个目录下有两个子目录：Caches 和 Preferences
Preferences 目录：包含应用程序的偏好设置文件。您不应该直接创建偏好设置文件，而是应该使用NSUserDefaults类来取得和设置应用程序的偏好.
Caches 目录：用于存放应用程序专用的支持文件，保存应用程序再次启动过程中需要的信息。

4、tmp 目录：这个目录用于存放临时文件，保存应用程序再次启动过程中不需要的信息。

 

补充1：对于上述描述可以这样举例理解，一个记事本应用，用户写的东西需要保存起来，这些东西是用户自行生成的，则需要放在 Documents 目录里。一个新闻应用，如果需要从服务器下载东西展示给用户看，下载的东西就放在 Library/Caches 目录里。苹果审核对这个要求很严格，主要原因是 iCloud 的同步问题。

补充2：如果想知道真机或者模拟器 App 沙盒路径，可通过在项目中执行下述代码打印获取：

获取这些目录路径的方法

1，获取Home目录路径的函数：
let homeDir = NSHomeDirectory()

2，获取Documents目录路径的方法：（swift3）

路径结果：

3，获取Caches目录路径的方法：

 

路径结果：

4，获取tmp目录路径的方法：

let tmpDir = NSTemporaryDirectory();

5，获取应用程序程序包中资源文件路径的方法：

程序包（NSBundle）
iOS 应用都是通过 bundle 进行封装的，可以狭隘地将 bundle 理解为上述沙盒中的 AppName.app 文件。在 Finder 中，会把 bundle 当做一个文件显示从而防止用户误操作导致程序文件损坏，但其实内部是一个目录，包含了图像、媒体资源、编译好的代码、nib 文件等，这个目录称为 main bundle。
Cocoa 提供了 NSBundle 类封装了 bundle 操作。

通过NSBundle可以获取各种资源文件，注意在Build Phases - Copy Bundle Rresources下面需要有这个资源文件，有些类型的文件不会自动加在这里

 let paths3 = Bundle.main.path(forResource: "20160504182134006", ofType: "pcm")

代码中的mainBundle类方法用于返回一个代表应用程序包的对象。

NSFileManager文件管理介绍

使用 FileManager 可以对沙盒中的目录、文件进行操作。

使用NSFileManager创建文件夹和文件

使用FileManager在documents目录下创建文件夹和文件，方法如下:

执行结果为(Direct为文件夹，hi为Direct文件下的文件):

将对象写入文件

可以通过写（至:)方法，可以创建文件并将对象写入，对象包括字符串，的NSString，UIImage的，的NSArray，NSDictionary的等。

（1）把字符串保存到文件（其实执行的是创建文件并将字符串写入并保存到文件中）

（2）把图片保存到文件路径下，（1）（2）并列如下图：

1，遍历一个目录下的所有文件

假设用户文档下有如下文件和文件夹：test1.txt、fold1/test2.txt

 

 

（1）首先我们获取用户文档目录路径

1 2 3 4

let manager = FileManager.default let urlForDocument = manager.urls(for: .documentDirectory, in:.userDomainMask) let url = urlForDocument[0] as URL print(url)

 

 

（2）对指定路径执行浅搜索，返回指定目录路径下的文件、子目录及符号链接的列表

1 2	let contentsOfPath = try? manager.contentsOfDirectory(atPath: url.path) print("contentsOfPath: \(contentsOfPath)")

 

 

（3）类似上面的，对指定路径执行浅搜索，返回指定目录路径下的文件、子目录及符号链接的列表

1 2 3

let contentsOfURL = try? manager.contentsOfDirectory(at: url,                         includingPropertiesForKeys: nil, options: .skipsHiddenFiles) print("contentsOfURL: \(contentsOfURL)")

 

 

（4）深度遍历，会递归遍历子文件夹（但不会递归符号链接）

1 2	let enumeratorAtPath = manager.enumerator(atPath: url.path) print("enumeratorAtPath: \(enumeratorAtPath?.allObjects)")

 

 

（5）类似上面的，深度遍历，会递归遍历子文件夹（但不会递归符号链接）

1 2 3

let enumeratorAtURL = manager.enumerator(at: url, includingPropertiesForKeys: nil,                                          options: .skipsHiddenFiles, errorHandler:nil) print("enumeratorAtURL: \(enumeratorAtURL?.allObjects)")

 

 

（6）深度遍历，会递归遍历子文件夹（包括符号链接，所以要求性能的话用enumeratorAtPath）

1 2	let subPaths = manager.subpaths(atPath: url.path) print("subPaths: \(subPaths)")

 

 

2，判断文件或文件夹是否存在

1 2 3

let fileManager = FileManager.default let filePath:String = NSHomeDirectory() + "/Documents/hangge.txt" let exist = fileManager.fileExists(atPath: filePath)

 

3，复制文件 

（1）方法1

1 2 3 4 5

let fileManager = FileManager.default let homeDirectory = NSHomeDirectory() let srcUrl = homeDirectory + "/Documents/hangge.txt" let toUrl = homeDirectory + "/Documents/copyed.txt" try! fileManager.copyItem(atPath: srcUrl, toPath: toUrl)

 

（2）方法2

1 2 3 4 5 6 7 8 9 10

// 定位到用户文档目录 let manager = FileManager.default let urlForDocument = manager.urls( for:.documentDirectory, in:.userDomainMask) let url = urlForDocument[0]   // 将test.txt文件拷贝到文档目录根目录下的copyed.txt文件 let srcUrl = url.appendingPathComponent("test.txt") let toUrl = url.appendingPathComponent("copyed.txt")   try! manager.copyItem(at: srcUrl, to: toUrl)

 

4，移动文件

（1）方法1

1 2 3 4 5

let fileManager = FileManager.default let homeDirectory = NSHomeDirectory() let srcUrl = homeDirectory + "/Documents/hangge.txt" let toUrl = homeDirectory + "/Documents/moved/hangge.txt" try! fileManager.moveItem(atPath: srcUrl, toPath: toUrl)

 

（2）方法2

1 2 3 4 5 6 7 8 9

// 定位到用户文档目录 let manager = FileManager.default let urlForDocument = manager.urls( for: .documentDirectory, in:.userDomainMask) let url = urlForDocument[0]   let srcUrl = url.appendingPathComponent("test.txt") let toUrl = url.appendingPathComponent("copyed.txt") // 移动srcUrl中的文件（test.txt）到toUrl中（copyed.txt） try! manager.moveItem(at: srcUrl, to: toUrl)

 

5，删除文件

（1）方法1

1 2 3 4

let fileManager = FileManager.default let homeDirectory = NSHomeDirectory() let srcUrl = homeDirectory + "/Documents/hangge.txt" try! fileManager.removeItem(atPath: srcUrl)

 

（2）方法2

1 2 3 4 5 6 7 8

// 定位到用户文档目录 let manager = FileManager.default let urlForDocument = manager.urls(for: .documentDirectory, in:.userDomainMask) let url = urlForDocument[0]   let toUrl = url.appendingPathComponent("copyed.txt") // 删除文档根目录下的toUrl路径的文件（copyed.txt文件） try! manager.removeItem(at: toUrl)

 

6，删除目录下所有的文件

（1）方法1：获取所有文件，然后遍历删除

1 2 3 4 5 6

let fileManager = FileManager.default let myDirectory = NSHomeDirectory() + "/Documents/Files" let fileArray = fileManager.subpaths(atPath: myDirectory) for fn in fileArray!{     try! fileManager.removeItem(atPath: myDirectory + "/\(fn)") }

 

（2）方法2：删除目录后重新创建该目录

1 2 3 4 5

let fileManager = FileManager.default let myDirectory = NSHomeDirectory() + "/Documents/Files" try! fileManager.removeItem(atPath: myDirectory) try! fileManager.createDirectory(atPath: myDirectory, withIntermediateDirectories: true,                                  attributes: nil)

7，读取文件

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

let manager = FileManager.default let urlsForDocDirectory = manager.urls(for: .documentDirectory, in:.userDomainMask) let docPath = urlsForDocDirectory[0] let file = docPath.appendingPathComponent("test.txt")   //方法1 let readHandler = try! FileHandle(forReadingFrom:file) let data = readHandler.readDataToEndOfFile() let readString = String(data: data, encoding: String.Encoding.utf8) print("文件内容: \(readString)")   //方法2 let data2 = manager.contents(atPath: file.path) let readString2 = String(data: data2!, encoding: String.Encoding.utf8) print("文件内容: \(readString2)")

 

8，在任意位置写入数据

1 2 3 4 5 6 7 8 9 10

let manager = FileManager.default let urlsForDocDirectory = manager.urls(for:.documentDirectory, in:.userDomainMask) let docPath = urlsForDocDirectory[0] let file = docPath.appendingPathComponent("test.txt")   let string = "添加一些文字到文件末尾" let appendedData = string.data(using: String.Encoding.utf8, allowLossyConversion: true) let writeHandler = try? FileHandle(forWritingTo:file) writeHandler!.seekToEndOfFile() writeHandler!.write(appendedData!)

 

9，文件权限判断

1 2 3 4 5 6 7 8 9 10 11 12 13

let manager = FileManager.default let urlForDocument = manager.urls(for: .documentDirectory, in:.userDomainMask) let docPath = urlForDocument[0] let file = docPath.appendingPathComponent("test.txt")   let readable = manager.isReadableFile(atPath: file.path) print("可读: \(readable)") let writeable = manager.isWritableFile(atPath: file.path) print("可写: \(writeable)") let executable = manager.isExecutableFile(atPath: file.path) print("可执行: \(executable)") let deleteable = manager.isDeletableFile(atPath: file.path) print("可删除: \(deleteable)")

 

10，获取文件属性（创建时间，修改时间，文件大小，文件类型等信息）

1 2 3 4 5 6 7

let manager = FileManager.default let urlForDocument = manager.urls(for: .documentDirectory, in:.userDomainMask) let docPath = urlForDocument[0] let file = docPath.appendingPathComponent("test.txt")   let attributes = try? manager.attributesOfItem(atPath: file.path) //结果为Dictionary类型 print("attributes: \(attributes!)")

 

 

从 attributes 中获取具体的属性：

1 2 3

print("创建时间：\(attributes![FileAttributeKey.creationDate]!)") print("修改时间：\(attributes![FileAttributeKey.modificationDate]!)") print("文件大小：\(attributes![FileAttributeKey.size]!)")

 

 

11，文件/文件夹比较

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

let manager = FileManager.default let urlForDocument = manager.urls(for: .documentDirectory, in:.userDomainMask) let docPath = urlForDocument[0] let contents = try! manager.contentsOfDirectory(atPath: docPath.path)   //下面比较用户文档中前面两个文件是否内容相同（该方法也可以用来比较目录） let count = contents.count if count > 1 {     let path1 = docPath.path + "/" + (contents[0] as String)     let path2 = docPath.path + "/" + (contents[1] as String)     let equal = manager.contentsEqual(atPath: path1,andPath:path2)     print("path1：\(path1)")     print("path2：\(path2)")     print("比较结果： \(equal)") }

article end