如何在Swift中打开.ics文件并实现日历事件创建功能

前置依赖配置 #

• 首先导入EventKit框架：import EventKit
• 在项目Info.plist中添加对应权限描述：
  • iOS 17及以上：添加NSCalendarsWriteOnlyUsageDescription，值填写向用户说明的权限用途，比如「用于导入日历事件」
  • iOS 16及以下：添加NSCalendarsUsageDescription

方案1：App内直接解析写入日历（无需跳转外部应用） #

该方案不需要用户跳转到日历App，权限申请通过后可以直接完成写入，代码如下：

import EventKit

func importICSDataToCalendar(_ icsData: Data) async {
    let eventStore = EKEventStore()
    // 请求日历写入权限
    var granted = false
    if #available(iOS 17.0, *) {
        granted = try await eventStore.requestWriteOnlyAccessToEvents()
    } else {
        granted = try await eventStore.requestAccess(to: .event)
    }
    guard granted else {
        print("日历权限未授权")
        return
    }
    // 解析ICS数据
    do {
        let calendarItems = try EKCalendarItem.items(fromiCalendarData: icsData, store: eventStore)
        // 过滤出事件类型（过滤掉待办提醒等其他类型）
        let events = calendarItems.compactMap { $0 as? EKEvent }
        // 逐个写入日历
        for event in events {
            // 可在此处修改事件属性，比如指定要写入的自定义日历
            event.calendar = eventStore.defaultCalendarForNewEvents
            try eventStore.save(event, span: .thisEvent)
        }
        print("成功导入\(events.count)个日历事件")
    } catch {
        print("ICS解析或写入失败：\(error.localizedDescription)")
    }
}

方案1注意事项 #

• 该API兼容iOS 5.0及以上版本，仅权限申请逻辑需要适配iOS17
• 若ICS数据包含重复事件、邀请等特殊格式，解析后属性会自动同步，无需额外处理

方案2：调用系统日历应用手动导入 #

如果不需要在App内完成写入，也可以将ICS数据写入临时文件后调起系统日历打开，由用户手动确认导入，无需申请日历权限：

import UIKit

func openICSWithSystemCalendar(_ icsData: Data) {
    // 生成临时文件路径
    let tempDir = NSTemporaryDirectory()
    let tempFilePath = (tempDir as NSString).appendingPathComponent("temp.ics")
    let tempFileUrl = URL(fileURLWithPath: tempFilePath)
    // 写入临时文件
    do {
        try icsData.write(to: tempFileUrl)
        // 创建文档交互控制器
        let docController = UIDocumentInteractionController(url: tempFileUrl)
        docController.uti = "text/calendar"
        // 弹出打开选项菜单
        docController.presentOpenInMenu(from: .zero, in: UIApplication.shared.keyWindow!.rootViewController!.view, animated: true)
    } catch {
        print("临时文件写入失败：\(error.localizedDescription)")
    }
}

方案2注意事项 #

• 用户需要在弹出的应用列表中选择「日历」App，即可进入系统日历的导入确认页面
• 临时文件会在系统自动清理周期内删除，无需手动处理

通用注意事项 #

• 确保你持有的ICS数据符合RFC5545规范，格式错误会导致解析失败
• 若需要导入到自定义日历，可以提前通过EKEventStore创建自定义日历，写入时指定event.calendar为对应实例即可

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