Swift/SwiftUI自定义UTI导入问题：如何自动唤起App并加载数据

问题背景 #

开发一款支持跨设备传输自定义结构体StageResult的App，要求通过Share Sheet发送数据，接收端自动唤起App导入（无网络时依赖AirDrop）。已实现Transferable协议、自定义UTI并配置info.plist，但接收端无法唤起App，也无手动打开选项，需明确SwiftUI中处理自定义UTI导入的正确方式及数据加载方法。

核心解决步骤 #

1. 完善Info.plist的UTI配置 #

除已配置项外，需确保以下关键配置正确：

• 声明导入UTI支持
• 关联自定义UTI到App的文档类型
• 补充UTI的合规性声明（如继承public.data）

示例Info.plist关键配置（可通过Xcode可视化界面或源码编辑）：

<key>CFBundleDocumentTypes</key>
<array>
    <dict>
        <key>CFBundleTypeName</key>
        <string>Stage Result Data</string>
        <key>CFBundleTypeRole</key>
        <string>Viewer</string>
        <key>LSHandlerRank</key>
        <string>Owner</string>
        <key>LSItemContentTypes</key>
        <array>
            <string>com.example.stageresult</string>
        </array>
    </dict>
</array>
<key>UTExportedTypeDeclarations</key>
<array>
    <dict>
        <key>UTTypeConformsTo</key>
        <array>
            <string>public.data</string>
        </array>
        <key>UTTypeDescription</key>
        <string>Stage Result Data</string>
        <key>UTTypeIdentifier</key>
        <string>com.example.stageresult</string>
        <key>UTTypeTagSpecification</key>
        <dict>
            <key>public.filename-extension</key>
            <array>
                <string>stageresult</string>
            </array>
        </dict>
    </dict>
</array>

2. SwiftUI中处理App唤起与数据接收 #

方法1：iOS 14+ App生命周期处理

在@main结构体中通过onOpenURL捕获传入的文件URL，解析并加载数据：

@main
struct StageResultApp: App {
    @State private var importedResult: StageResult?
    
    var body: some Scene {
        WindowGroup {
            ContentView(importedResult: $importedResult)
                .onOpenURL { url in
                    handleImportedURL(url) { result in
                        importedResult = result
                    }
                }
        }
    }
    
    private func handleImportedURL(_ url: URL, completion: @escaping (StageResult?) -> Void) {
        guard url.startAccessingSecurityScopedResource() else {
            completion(nil)
            return
        }
        defer { url.stopAccessingSecurityScopedResource() }
        
        do {
            let data = try Data(contentsOf: url)
            let result = try JSONDecoder().decode(StageResult.self, from: data)
            completion(result)
        } catch {
            print("解析失败: \(error.localizedDescription)")
            completion(nil)
        }
    }
}

在ContentView中监听导入数据并处理：

struct ContentView: View {
    @Binding var importedResult: StageResult?
    
    var body: some View {
        VStack {
            Text("Stage Result App")
                .font(.title)
            
            if let result = importedResult {
                Text("已导入数据: \(result.name)")
            }
        }
        .onChange(of: importedResult) { newResult in
            if let result = newResult {
                loadImportedData(result)
            }
        }
    }
    
    private func loadImportedData(_ result: StageResult) {
        // 实现数据加载逻辑，如存储到本地、展示内容等
        print("加载完成: \(result.recordings.count)条记录")
    }
}

方法2：iOS 16+ 直接接收Transferable数据（补充方案）

结合DropDelegate实现拖拽或Share Sheet直接接收：

struct ImportView: View {
    @State private var importedResult: StageResult?
    
    var body: some View {
        VStack {
            if let result = importedResult {
                Text("导入结果: \(result.name)")
            } else {
                Text("拖拽或通过Share Sheet导入数据")
            }
        }
        .onDrop(of: [.stageresult], delegate: DropViewDelegate(result: $importedResult))
    }
}

struct DropViewDelegate: DropDelegate {
    @Binding var result: StageResult?
    
    func performDrop(info: DropInfo) -> Bool {
        Task {
            if let receivedResult = try? await info.loadItem(forType: .stageresult) as StageResult {
                await MainActor.run {
                    result = receivedResult
                    loadImportedData(receivedResult)
                }
            }
        }
        return true
    }
    
    private func loadImportedData(_ result: StageResult) {
        // 处理数据逻辑
    }
}

3. 发送端Share Sheet调用优化 #

确保发送时正确关联自定义UTI，让系统识别分享类型：

struct ShareButtonView: View {
    let resultToShare: StageResult
    
    var body: some View {
        Button("分享数据") {
            let activityVC = UIActivityViewController(activityItems: [resultToShare], applicationActivities: nil)
            if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
               let rootVC = windowScene.windows.first?.rootViewController {
                rootVC.present(activityVC, animated: true)
            }
        }
    }
}

关键注意事项 #

• 发送端与接收端的UTI需完全一致（域名+类型名）
• AirDrop测试需确保两台设备在同一网络或联系人列表中
• iOS 13+必须处理安全作用域资源（startAccessingSecurityScopedResource/stopAccessingSecurityScopedResource）
• 若仍无法唤起App，检查Xcode Target的Info面板中Document Types和Exported UTIs配置，可尝试删除App重新安装

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