plus.calendar 是 uni-app App 端唯一稳定、跨 Android/iOS 且无需额外编译配置的日历操作路径，仅限真机运行于 Plus Mode 下，H5 和小程序不支持；需按平台分流调用 API 并处理权限与提醒逻辑。
直接用 plus.calendar，别绕路写原生插件或调第三方 SDK——这是 uni-app App 端唯一稳定、跨 Android/iOS 且无需额外编译配置的日历操作路径。
plus.calendar 在 App 端是否可用？
仅限 App 平台（即 uni-app 打包为 iOS/Android 原生 App 时），H5、小程序完全不支持。运行时必须处于 Plus Mode（即 uni.getSystemInfo 中 platform 为 "ios" 或 "android"，且 plus 对象存在）。
常见错误现象：Cannot read property 'calendar' of undefined —— 多因在 H5 环境调试、未真机运行、或未启用「使用原生渲染」导致 plus 未注入。
- 真机调试前确认 HBuilderX 已勾选「运行 → 运行到手机或模拟器 → 使用原生渲染」
- 打包 IPA/APK 后首次启动，iOS 需提前在
manifest.json的permissions中声明日历权限，否则plus.calendar.getCalendars()返回空数组 - Android 无需额外配置权限字段，但需确保 manifest 中已勾选「日历」权限（可视化界面或手动加
"calendar": {"description": "用于添加面试提醒"}）
如何正确创建带提醒的日历事件（iOS/Android 兼容写法）
iOS 和 Android 对提醒字段的处理逻辑不同：plus.calendar.createEvent 的 reminder 参数在 iOS 上生效，在 Android 上被忽略；Android 必须用 plus.calendar.addEvent（旧 API）并传入 reminder 字段才有效。
所以不能只写一个方法，得按平台分流：
- iOS：用
createEvent，startTime/endTime必须是 ISO 8601 字符串（如"2026-06-17T14:30:00Z"），且需提前调用plus.calendar.requestPermission检查授权 - Android：用
addEvent，时间用毫秒时间戳（new Date().getTime()），reminder是数字（单位：分钟），例如{minutes: 30} - 两者都必须先获取日历列表：
plus.calendar.getCalendars()，取第一个（默认日历），若返回空数组，说明权限未开或用户拒绝
示例片段：
function addEvent(title, start, end, desc = '') {
const calendars = plus.calendar.getCalendars();
if (!calendars || calendars.length === 0) {
uni.showToast({ title: '请开启日历权限', icon: 'none' });
return;
}
const cal = calendars[0];
if (plus.os.name === 'iOS') {
cal.createEvent({
title,
startTime: new Date(start).toISOString(),
endTime: new Date(end).toISOString(),
notes: desc,
reminder: 30 // 提前30分钟提醒
}, () => { console.log('iOS 添加成功'); }, (e) => { console.error(e); });
} else {
plus.calendar.addEvent({
title,
description: desc,
startTime: new Date(start).getTime(),
endTime: new Date(end).getTime(),
reminder: { minutes: 30 }
}, () => { console.log('Android 添加成功'); }, (e) => { console.error(e); });
}
}
权限拒绝后怎么引导用户跳转设置页？
iOS 和 Android 的跳转 schema 完全不同，且 iOS 17+ 已废弃 prefs://，必须用 App-Prefs:// 或更稳妥的 UIApplication.openSettingsURLString 等效方式。
uni-app 中统一用 plus.runtime.openURL：
- iOS：跳转到系统设置页，用
plus.runtime.openURL('app-settings:')（注意末尾冒号），iOS 会自动打开「设置 → 隐私与安全性 → 日历」 - Android：跳转到应用详情页，用
plus.runtime.openURL('package:' + plus.runtime.appid)，用户可手动开启「日历」权限 - 不要用
uni.openSetting—— 它只对小程序有效，App 端无响应
跳转前务必先调用 plus.calendar.hasPermission() 确认状态，避免重复弹窗。
为什么 iOS 添加成功却没收到提醒？
最常被忽略的点：iOS 日历事件的提醒依赖两个条件同时满足——事件本身带 reminder，且用户在系统「日历」App 中为该日历启用了「提醒通知」。
这个开关不在 app 权限里，而在系统设置中：设置 → 日历 → 默认日历 → 通知 → 提醒事项。如果用户关了这个全局开关，哪怕你代码里写了 reminder: 30，也不会弹通知。
所以实际交付时，要加一句提示文案：“如未收到提醒，请检查系统日历通知是否开启”。
另外，iOS 上 createEvent 不支持重复事件（recurrence），需要重复提醒只能靠服务端定时推送或客户端轮询补发——这不是 plus.calendar 能解决的。
