QDesktopServices Class

成员函数文档

[static] bool QDesktopServices::openUrl(const QUrl &url)

在用户桌面环境对应的 Web 浏览器中打开指定的url ，如果成功则返回true ；否则返回false 。

如果 URL 指向本地文件（即 URL 方案为“file”），则将使用合适的应用程序而非 Web 浏览器打开该文件。

以下示例将打开 Windows 文件系统中位于包含空格的路径上的文件：

QDesktopServices::openUrl(QUrl("file:///C:/Program Files", QUrl::TolerantMode));

如果指定了mailto 格式的 URL，则将使用用户的电子邮件客户端打开一个包含 URL 中指定选项的撰写窗口，这与 Web 浏览器处理mailto 链接的方式类似。

例如，以下 URL 包含收件人（user@foo.com ）、主题（Test ）和邮件正文（Just a test ）：

mailto:user@foo.com?subject=Test&body=Just a test

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>https</string>
</array>

另请参阅 setUrlHandler()。

[static] void QDesktopServices::setUrlHandler(const QString &scheme, QObject *receiver, const char *method)

将给定的scheme 的处理程序设置为由receiver 对象提供的处理程序method 。

此函数提供了一种自定义openUrl() 行为的方法。如果调用openUrl() 时传入的 URL 包含指定的scheme ，则会调用receiver 对象上的指定method ，而不是由QDesktopServices 启动外部应用程序。

所提供的方法必须作为仅接受单个QUrl 参数的槽来实现。

class MyHelpHandler : public QObject
{
    Q_OBJECT
public:
    // ...
public slots:
    void showHelp(const QUrl &url);
};

如果使用 setUrlHandler() 为已有处理程序的方案设置新的处理程序，则现有处理程序将被新处理程序直接替换。由于QDesktopServices 不持有处理程序的所有权，因此在替换处理程序时不会删除任何对象。

请注意，处理程序始终会在调用 `QDesktopServices::openUrl()` 的同一线程内被调用。

在销毁处理程序对象之前，必须先调用unsetUrlHandler()，以确保处理程序对象的销毁不会与正在使用该对象的openUrl() 的并发调用发生冲突。

iOS 和 macOS

若要在 iOS/macOS 上使用此函数接收来自其他应用的数据，您还需要将自定义方案添加到 Info.plist 文件中的CFBundleURLSchemes 列表中：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>myapp</string>
        </array>
    </dict>
</array>

有关详细信息，请参阅 Apple 开发者文档中的《为您的应用定义自定义 URL 方案》。

若要声明支持 http 和 https，则不允许在 Info.plist 文件中添加上述条目。只有将您的域名添加到 Entitlements 文件中时，才允许这样做：

<key>com.apple.developer.associated-domains</key>
<array>
    <string>applinks:your.domain.com</string>
</array>

当应用程序安装时，iOS/macOS 会搜索您域名下的 /.well-known/apple-app-site-association 文件。如果您希望监听https://your.domain.com/help?topic=ABCDEF ，则需要在此处提供以下内容：

{
    "applinks": {
        "apps": [],
        "details": [{
            "appIDs" : [ "ABCDE12345.com.example.app" ],
            "components": [{
                "/": "/help",
                "?": { "topic": "?*"}
            }]
        }]
    }
}

有关更多信息，请参阅 Apple 开发者文档中关于“支持关联域名”的部分。

Android

要在 Android 上使用此功能接收来自其他应用的数据，您需要在应用清单中的 `activity ` 中添加一个或多个 intent 过滤器：

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="https" android:host="your.domain.com" android:port="1337" android:path="/help"/>
</intent-filter>

有关更多信息，请参阅《Android 开发者文档》中的“创建应用内容的深度链接”。

若要在 Android 应用中立即打开相应内容（无需用户选择应用），则需要验证您的链接。要启用验证，请在 intent 过滤器中添加一个额外参数：

<intent-filter android:autoVerify="true">

当应用安装时，Android 会查找 `https://your.domain.com/.well-known/assetlinks.json`。若要监听 `https://your.domain.com:1337/help`，您需要在此处提供以下内容：

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example.app",
    "sha256_cert_fingerprints":
    ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
  }
}]

有关更多信息，请参阅《Android 开发者文档》中的“验证 Android 应用链接”部分。

另请参阅 openUrl() 和unsetUrlHandler()。

[static] void QDesktopServices::unsetUrlHandler(const QString &scheme)

移除为指定的scheme 此前设置的URL处理程序。

请在为scheme 注册的处理程序对象被销毁之前调用此函数，以防止并发调用的openUrl()继续调用已被销毁的处理程序对象。

另请参阅 setUrlHandler()。