如何使用Swift在iOS的Safari中打开file:///链接加载本地HTML文件

由于iOS沙盒机制限制，Safari无法直接通过file:///URL访问App私有目录下的文件，以下是两种可行的实现方案：

方案一：临时共享文件唤起Safari #

通过将HTML文件复制到系统可访问的共享目录，再引导用户用Safari打开：

1. 复制本地文件到临时共享目录
   先把Bundle里的HTML文件复制到NSTemporaryDirectory（系统临时目录，Safari可访问）：

   guard let sourceHTMLURL = Bundle.main.url(forResource: "index", withExtension: "html") else {
       print("找不到本地HTML文件")
       return
   }
   let tempDirPath = NSTemporaryDirectory()
   let targetHTMLURL = URL(fileURLWithPath: tempDirPath).appendingPathComponent("index.html")
   
   do {
       // 先删除已存在的同名文件，避免复制失败
       if FileManager.default.fileExists(atPath: targetHTMLURL.path) {
           try FileManager.default.removeItem(at: targetHTMLURL)
       }
       try FileManager.default.copyItem(at: sourceHTMLURL, to: targetHTMLURL)
   } catch {
       print("文件复制失败：\(error.localizedDescription)")
       return
   }
   

2. 唤起Safari打开文件
   使用UIDocumentInteractionController弹出选择菜单，让用户选择Safari：

   let docController = UIDocumentInteractionController(url: targetHTMLURL)
   docController.delegate = self
   // 在当前视图控制器的视图范围内弹出菜单
   docController.presentOpenInMenu(from: view.bounds, in: view, animated: true)
   

   必须实现UIDocumentInteractionControllerDelegate的代理方法，指定菜单的展示上下文：

   extension YourViewController: UIDocumentInteractionControllerDelegate {
       func documentInteractionControllerViewControllerForPreview(_ controller: UIDocumentInteractionController) -> UIViewController {
           return self
       }
   }
   

方案二：启动本地HTTP服务器（推荐） #

在App内启动轻量HTTP服务器，将本地HTML文件作为静态资源提供，Safari通过本地IP地址访问，这种方式能正常加载HTML关联的CSS、JS等资源：

1. 集成轻量HTTP库
   推荐使用GCDWebServer，可通过Swift Package Manager或CocoaPods集成：

   // Swift Package Manager添加依赖示例
   dependencies: [
       .package(url: "https://github.com/swisspol/GCDWebServer.git", from: "3.5.3")
   ]
   

2. 启动服务器并映射HTML文件
   在App中启动服务器，设置HTML文件的访问路径：

   import GCDWebServer
   
   class LocalHTTPServer {
       static let shared = LocalHTTPServer()
       private let webServer = GCDWebServer()
       
       func startServer() {
           guard let htmlFilePath = Bundle.main.path(forResource: "index", ofType: "html") else {
               print("本地HTML文件不存在")
               return
           }
           
           // 根路径映射到HTML文件
           webServer.addGETHandler(forPath: "/", filePath: htmlFilePath, isAttachment: false)
           // 启动服务器，使用8080端口
           do {
               try webServer.start(options: [
                   GCDWebServerOption_Port: 8080,
                   GCDWebServerOption_BonjourName: "Local HTML Server"
               ])
               print("服务器启动成功：\(webServer.serverURL!)")
           } catch {
               print("服务器启动失败：\(error.localizedDescription)")
           }
       }
       
       func stopServer() {
           webServer.stop()
       }
   }
   

3. 唤起Safari访问本地服务器
   在需要的地方启动服务器并打开Safari：

   LocalHTTPServer.shared.startServer()
   if let serverURL = LocalHTTPServer.shared.webServer.serverURL {
       UIApplication.shared.open(serverURL, options: [:], completionHandler: { success in
           if !success {
               print("唤起Safari失败")
           }
       })
   }
   

关键注意事项 #

• 方案一的临时文件需在App退出或使用完成后手动删除，避免占用存储空间。
• 方案二的服务器需在App进入后台时停止，回到前台再重启，符合iOS后台运行限制。
• 确保HTML文件已添加到App的Bundle中，且在Build Phases的Copy Bundle Resources列表里。

内容的提问来源于stack exchange，提问作者user19561542