如何使用Ionic Capacitor向移动设备系统日历添加事件

首选实现方案（支持静默写入） #

目前Capacitor官方社区维护的@capacitor-community/calendar插件完全覆盖iOS、Android双端的日历读写需求，无需自行适配原生逻辑，具体实现步骤如下：

• 第一步：安装插件并同步原生项目
  执行以下命令安装依赖：

npm install @capacitor-community/calendar
npx cap sync

• 第二步：配置双端权限
  • Android端在android/app/src/main/AndroidManifest.xml中添加日历读写权限：

  <uses-permission android:name="android.permission.READ_CALENDAR" />
  <uses-permission android:name="android.permission.WRITE_CALENDAR" />
  

  • iOS端在ios/App/App/Info.plist中添加权限申请说明：

  <key>NSCalendarsUsageDescription</key>
  <string>需要日历权限以将活动保存到系统日历</string>
  

• 第三步：业务代码集成
  示例代码如下，可直接嵌入按钮点击事件的回调逻辑中：

import { Calendar } from '@capacitor-community/calendar';

// 按钮点击触发的保存事件方法
const saveEventToSystemCalendar = async (eventInfo: {
  title: string,
  startTime: Date,
  endTime: Date,
  location?: string,
  description?: string
}) => {
  // 先申请日历权限
  const authRes = await Calendar.requestPermissions();
  if (authRes.calendar !== 'granted') {
    // 自行补充权限被拒绝的提示逻辑
    return;
  }
  // 调用接口写入事件
  await Calendar.createEvent({
    title: eventInfo.title,
    startDate: eventInfo.startTime.toISOString(),
    endDate: eventInfo.endTime.toISOString(),
    location: eventInfo.location || '',
    notes: eventInfo.description || ''
  });
  // 自行补充保存成功的提示逻辑
}

该插件还支持重复事件设置、提前提醒配置、查询已有事件避免重复写入等功能，可直接调用对应接口实现。

无权限备选方案（需用户手动确认） #

如果你的应用不想申请日历读写权限，可以选择唤起系统日历应用的创建页，让用户手动确认保存：

• iOS端可构造标准的日历事件数据唤起系统日历应用，用户点击保存即可完成写入
• Android端可构造指向日历Provider的INSERT Intent，直接跳转系统日历的新建事件页
  这种方案不需要申请任何权限，但无法实现自动写入，需要用户手动操作确认，适合对权限申请比较敏感的场景。

内容的提问来源于stack exchange，提问作者buğracan