Protocol Launcher

简体中文

English

简体中文

English

Appearance

BusyCal ​

BusyCal 是一款适用于 macOS 和 iOS 的日历应用。Protocol Launcher 允许你生成 BusyCal 深度链接，用于创建事件和任务、打开日期以及切换视图。

使用 ​

这个库有两种使用方式：

  • 从子路径按需导入，支持 Tree Shaking 并保持较小的包体积。
  • 从根包完整导入更适合快速脚本或演示，但会包含所有应用模块。

生产构建建议选择按需导入；完整导入适合快速脚本或演示。

选择安装方式

按需加载
推荐使用。生产环境优化。
全量导入
使用便捷。适合快速脚本。

macOS：新建事件和任务 ​

使用 BusyCal 的 busycalevent://new/ URL 搭配自然语言字符串。像 /Work 这样的日历名和尖括号中的 URL 都放在描述字符串里，完全遵循 BusyCal 文档；helper 只负责对路径段进行 percent-encoding。

On-Demand
ts
import { newEvent, newTask } from 'protocol-launcher/busycal'

const eventUrl = newEvent({
  description: 'Staff meeting Thursday at 10am',
})

const taskUrl = newTask({
  description: 'Pay Taxes April 15!!! /Personal',
})
创建 BusyCal 事件

macOS：查找、日期和筛选器 ​

find() 对应 busycalevent://find/<Calendar>/<Title>/<DateTime> 或 busycalevent://find/<Calendar>/<Title>/<Date>。不传 calendar 时会按官方格式搜索所有日历。openFilter() 使用 BusyCal 对 Calendar Set 和 Smart Filter 共用的 handler。

On-Demand
ts
import { find, openDate, openFilter } from 'protocol-launcher/busycal'

const findUrl = find({
  title: 'Buy Toner',
})

const dateUrl = openDate({
  date: '2021-05-31',
})

const filterUrl = openFilter({
  name: 'home',
})
查找项目打开日期打开筛选器

macOS：快速输入和订阅 ​

BusyCal 官方文档列出了用于新建事件或任务的 Quick Entry URL，也列出了通过 webcal:// URL 订阅日历。

On-Demand
ts
import { openEventQuickEntry, openTaskQuickEntry, subscribeCalendar } from 'protocol-launcher/busycal'

const eventQuickEntryUrl = openEventQuickEntry()
const taskQuickEntryUrl = openTaskQuickEntry()
const subscriptionUrl = subscribeCalendar({
  url: 'webcal://example.com/calendar.ics',
})
事件快速输入任务快速输入订阅日历

macOS：同步、DND 和设置 ​

BusyCal 还官方记录了强制同步、设置 Do Not Disturb 分钟数、日志级别和崩溃报告开关的 URL handler。这些 URL 会改变 BusyCal 状态，因此这里只展示生成的字符串，不提供启动按钮。

On-Demand
ts
import { syncCalDAV, syncWebDAV, setDoNotDisturb, setLogLevel, setCrashReporting } from 'protocol-launcher/busycal'

const caldavUrl = syncCalDAV()
const webdavUrl = syncWebDAV()
const dndUrl = setDoNotDisturb({ minutes: 15 })
const loggingUrl = setLogLevel({ level: 3 })
const crashReportingUrl = setCrashReporting({ option: 1 })

iOS ​

BusyCal for iOS 使用 busycal://new/、busycal://date/ 和 busycal://launch/。对于 newIosEvent() 和 newIosTask()，只有在需要官方文档里的自动保存行为时才传入 autosave: true 或 autosave: 1。

On-Demand
ts
import { newIosEvent, newIosTask, openIosDate, launchIosView } from 'protocol-launcher/busycal'

const eventUrl = newIosEvent({
  description: 'Baseball game tomorrow',
})

const taskUrl = newIosTask({
  description: 'Call Bob tomorrow',
})

const dateUrl = openIosDate({
  date: '2021-05-31',
})

const launchUrl = launchIosView({
  view: 'day',
})
新建 iOS 事件打开 iOS 日期打开 iOS 视图

生成的 URL ​

ts
newEvent({ description: 'Staff meeting Thursday at 10am' })
// => 'busycalevent://new/Staff%20meeting%20Thursday%20at%2010am'

newTask({ description: 'Pay Taxes April 15!!! /Personal' })
// => 'busycalevent://new/-Pay%20Taxes%20April%2015!!!%20%2FPersonal'

find({ title: 'Buy Toner' })
// => 'busycalevent://find//Buy%20Toner'

openDate({ date: '2021-05-31' })
// => 'busycalevent://date/2021-05-31'

openFilter({ name: 'home' })
// => 'busycal://filter/home'

openEventQuickEntry()
// => 'busycal://newEvent'

openTaskQuickEntry()
// => 'busycal://newTask'

subscribeCalendar({ url: 'webcal://example.com/calendar.ics' })
// => 'webcal://example.com/calendar.ics'

syncCalDAV()
// => 'busycalsync://caldav'

syncWebDAV()
// => 'busycalsync://webdav'

setDoNotDisturb({ minutes: 15 })
// => 'busycaldnd://15'

setLogLevel({ level: 3 })
// => 'busycalsetting://loglevel/3'

setCrashReporting({ option: 1 })
// => 'busycalsetting://crashreporting/1'

newIosEvent({ description: 'Project review 3pm /Work', autosave: 1 })
// => 'busycal://new/Project%20review%203pm%20%2FWork//1'

newIosTask({ description: 'Call Bob tomorrow' })
// => 'busycal://new/-Call%20Bob%20tomorrow'

newIosTask({ description: 'Buy Toner /Shopping <www.amazon.com>', autosave: true })
// => 'busycal://new/-Buy%20Toner%20%2FShopping%20%3Cwww.amazon.com%3E/true'

openIosDate({ date: 'now' })
// => 'busycal://date/now'

launchIosView({ view: 'tasks' })
// => 'busycal://launch/tasks'

参考 ​