【亲测免费】 开源项目 shortcuts-js 使用教程

项目介绍

shortcuts-js 是一个用于创建 iOS 12 快捷方式的 JavaScript 库。该项目允许开发者通过编写代码来生成快捷方式，而不是依赖于 iOS 快捷方式应用的拖放界面。这为自动化任务提供了更大的灵活性和可编程性。

项目快速启动

安装

首先，你需要安装 shortcuts-js 库。你可以通过 npm 来安装：

npm install @joshfarrant/shortcuts-js

创建一个简单的快捷方式

以下是一个简单的示例，展示如何使用 shortcuts-js 创建一个快捷方式：

const { buildShortcut, withVariables } = require('@joshfarrant/shortcuts-js');
const { showResult } = require('@joshfarrant/shortcuts-js/actions');

const actions = [
  showResult({
    text: withVariables`Hello, world!`
  })
];

const shortcut = buildShortcut(actions);

// 将生成的快捷方式保存到文件
const fs = require('fs');
fs.writeFileSync('hello-world.shortcut', shortcut);

应用案例和最佳实践

创建电池监控快捷方式

以下是一个应用案例，展示如何创建一个监控电池电量的快捷方式，并在电量低于20%时提醒用户充电：

const { buildShortcut, withVariables } = require('@joshfarrant/shortcuts-js');
const { getBatteryLevel, setLowPowerMode, showResult } = require('@joshfarrant/shortcuts-js/actions');

const batteryLevel = actionOutput();

const actions = [
  getBatteryLevel([], batteryLevel),
  conditional({
    input: '<',
    value: 20,
    ifTrue: [
      setLowPowerMode({ value: true }),
      showResult({
        text: withVariables`Your battery is at $[batteryLevel]%, you might want to charge it.`
      })
    ],
    ifFalse: [
      showResult({
        text: withVariables`Your battery is at $[batteryLevel]%, you're probably fine for now.`
      })
    ]
  })
];

const shortcut = buildShortcut(actions);

// 将生成的快捷方式保存到文件
const fs = require('fs');
fs.writeFileSync('battery-monitor.shortcut', shortcut);

典型生态项目

相关项目

1. ShortcutsGallery: 一个收集和分享快捷方式的社区，用户可以在这里找到各种有趣的快捷方式。
2. Scriptable: 一个允许用户编写 JavaScript 脚本来创建自定义小部件和自动化任务的应用。

通过这些项目，你可以进一步扩展和定制你的快捷方式，使其更加符合你的需求。