Qt 自定义 URL Scheme 传参方法

在传统的应用程序设计中，我们可以看到很多通过浏览器启动本地应用的案例，比如百度网盘、迅雷等工具，它们在浏览器访问非 http/https 协议开头的地址时，会自动打开其自身的应用程序并传递一定的参数。网络上提供了许多关于该功能实现方式的示例，在 Windows 和 macOS 不同平台下需要进行如下设置：

Windows 注册自定义 URL Scheme：

在程序安装包中，你需要写入如下注册表内容，告知系统我们要注册一个自定义 URL Scheme。在上面的例子中，

• MYSCHEME 是你自己定义的 URL Scheme 名称。
• E:\\Documents\\Repositories\\temporary\\MyApp\\bin\\MyApp.exe 是你应用安装后的实际路径。
• --argument=\"%1\" 是启动你应用后需要添加的参数。

当我们通过浏览器访问 MYSCHEME://auth?username=abc&password=def 时，将会启动 E:\\Documents\\Repositories\\temporary\\MyApp\\bin\\MyApp.exe 这个程序，并传递参数为 --argument=MYSCHEME://auth?username=abc&password=def。浏览器会先弹出提示，询问是否打开你注册的应用：

在选择打开应用后，程序自动启动，并且后面追加了命令行参数：

macOS 注册自定义 URL Scheme：

macOS 在自定义 URL 的实现上与 Windows 有所不同，你需要在应用的 bundle 中，修改 Info.plist 文件，添加如下字段：

在 Info.plist 文件中，添加如下内容：

<array>
    <dict>
        <key>CFBundleURLName</key>
        <string>com.company.group.app</string>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>MyApp</string>
        </array>
    </dict>
</array>

其中，MyApp 即为自动注册到系统中的自定义 URL Scheme。当你的应用安装在应用程序目录后，通过浏览器访问 MyApp:// 的地址时，会自动启动你的应用。