iOS 上的自动化手段,除了与 API 打交道,剩下的应该只有 URL Schemes 了,所以大多数有追求的软件基本上都支持 URL Schemes。而 Mac 上的自动化手段很多,有 User Automation 层面的 Apple Script 和 JXA,还有正在发展当中的 App Extensions。也许也正是因为这个原因,Mac 上大部分软件对 URL Schemes 的支持情况都不好,在一些需求下,借助 Script Editor,我们可以制作自己的 URL 协议和 handler。

基本原理很简单:当一个软件被注册到 LaunchServices(通常是在 Finder 中查看 App 所在文件夹时),LaunchServices 会读取其声明的支持的 URL 协议、文件类型以及MIME 类型等信息并记录下来。我们只要在 Script Editor 中将 Apple Script 代码保存为 Application 类型,然后修改其 Info.plist,在其中声明所能处理的 URL 类型,随后 LaunchServices  就会将我们的 APP 记录在案,未来遇到对应的 URL 时就交给我们的 App 处理。一般我们把这种程序称为 helper。

实践

制作 App 并登记到 LaunchServices

打开 Script Editor,新建一文件。要使 Apple Script 能够响应 URL Schemes,必须要包含处理 open location 事件的代码:

on open location this_URL

查看从 URL 传递来的参数:

display dialog "this URL: " & this_URL

然后将这段代码保存为 Application 类型,在右侧边栏中起一个 BundleIdentifier,然后在 Finder 中查看。

修改 Info.plist 文件,添加下面字段并保存:

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLName</key>
        <string>Open File</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>opener</string>
        </array>
    </dict>
</array>

如果按照我的写法,相当于告诉 macOS 将所有以 opener:// 开头的名为 Open File 的 URL 全部交给 org.oscar.opener 处理。

现在要把他登记到 LaunchServices,最简单的方法是直接 Command + O 运行一下。登记完成后,使用 LaunchBar 打开一段 URL(⌘ L)试一下,可以看到已经成功了。

请输入图片标题

解析处理参数

能够正确收到参数以后,下一步是解析参数。

以一个简单的需求做例子:我希望把硬盘中的一些文件连接到文字处理工具中,做为参考,然而对于 Quiver 这种从 Mac App Store 中下载的软件,因为沙盒限制,在笔记中把文字添加超链接: /Users/Oscar/Desktop/Apple Script/1.png,是无法打开的;有时因为软件自身的设计原因,如 Ulysses,不会将这种 POSIX 路径识别为链接。

之前,我可能通过将文件添加或者索引 (Index) 到 DEVONthink 中,复制其 Item Link 然后添加到笔记中,但是现在我们可以做一个小程序辅助解决这个问题,让 Quiver 能绕过沙盒限制,让 Ulysses 能正确识别笔记中添加的文件链接。
(不过添加到 DEVONthink 中有另一个好处,得到的 Item Link 在 iOS 上也能使用。)

假设一次只打开一个文件,即只传入一个参数:

set x to the offset of "://" in this_URL
set the argument_string to text from (x + 3) to -1 of this_URL
-- 找到「://」位置并记录到变量 x 中
-- 把 URL 中「://」后的所有字符保存为变量 argument_string

然后把获得的参数做一下 URL Decode 处理,把 POSIX 路径转换为 Apple Script 对象,最后使用 Finder 打开即可:

on open location this_URL
    set x to the offset of "://" in this_URL
    set the argument_string to text from (x + 3) to -1 of this_URL
    set decodedPath to urldecode(argument_string)
    set f to POSIX file decodedPath
    tell application "Finder" to open f
end open location

现在这个自定义 URL Scheme 就完成了。在 Quiver 中添加 URLopener:///Users/Oscar/Desktop/Apple Script/1.png 或者直接打开,macOS 会调用刚刚制作的程序处理,引导 Finder 打开对应的文件。

↓这是一段少数派显示不出来的 Youtube 视频↓

<iframe width="560" height="315" src="https://www.youtube.com/embed/F4wPALcc8bo" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>

你可以在 🔗这里 下载opener.app

欧陆词典

欧陆词典一直是我在全平台使用的词典工具,其 iOS 版早就支持了 URL Schemes ,但是 Mac 版缺一直迟迟只支持基础的 Apple Script。我的用法是:在 Evernote 和 DEVONthink 中遇到比较复杂的单词时,在文字上添加链接:eudic://dict/rapprochement ,希望能够直接跳转到欧陆词典中的对应词条。同样的,也可以制作一个 helper 帮助在 Mac 上实现这个动作。

前面的步骤与之前一样,区别在于,欧陆词典分为免费版和高级版,需要借助一点 Shell Script 来判断版本:

/usr/libexec/PlistBuddy -c "Print :CFBundleIdentifier" /Applications/Eudb_en.app/Contents/Info.plist

免费版的 Bundle Identifier 为 com.eusoft.freeeudic,高级版为 com.eusoft.eudic。二者的区别仅在 Apple Script 的 tell application 部分。

因为这段 Shell 命令格式比较复杂,如果想在 Apple Script 中通过 do shell script 直接执行,需要进行比较繁琐的转义和字符连接的操作,所以我索性直接把代码写在 Shell 脚本中,同时也算提供另一个思路:

#!/bin/bash
query=$1
eudic_version=$(/usr/libexec/PlistBuddy -c "Print :CFBundleIdentifier" /Applications/Eudb_en.app/Contents/Info.plist)
echo $query
if [ "$eudic_version" == "com.eusoft.eudic" ];then
    open -b 'com.eusoft.eudic'
osascript <<EOD
    tell application id "com.eusoft.eudic"
        activate
        show dic with word "$query"
    end tell
EOD
elif [ "$eudic_version" == "com.eusoft.freeeudic" ];then
    open -b 'com.eusoft.freeeudic'
osascript <<EOD
    tell application id "com.eusoft.freeeudic"
        activate
        show dic with word "$query"
    end tell
EOD
fi

将文件保存存为 shell.sh,通过 Terminal 为其添加可执行权限:

# chmod a+x shell.sh

将处理好的文件移动到 App Package 内的 Resources 文件夹中。

在主 Apple Script 中获取 shell.sh 的路径:

set scriptPath to path to resource "shell.sh"
set p to POSIX path of scriptPath

然后解析 URL,将参数传给  shell.sh 即可。

你可以在 🔗这里 下载 Eudic_helper.app

经过大家的反馈,欧陆词典官方已经在 3.7.3 版本中添加了对 URL Schemes 的支持,但是 Mac App Store 中的版本却迟迟不更新。

拓展

上面的内容中都仅仅只涉及到了处理一个参数,也只能执行一种动作。如:协议名://动作?参数1=数值2&参数2=数值2 这种较复杂的 URL Schemes 也是可以实现的。只需要逐步剥离出动作和各个参数,随后使用不同的 handler (method) 处理即可。

 set x to the offset of "?" in this_URL    
 set the argument_string to text from (x + 1) to -1 of this_URL  ''  
 set AppleScript's text item delimiters to "&"
 set these_arguments to every text item of the argument_string
 set AppleScript's text item delimiters to ""

Credit

AppleScript: Launching Scripts From Links

eudic_tools/sources/eudic_helper at master · cdpath/eudic_tools