QDesktopServices Class

成员函数文档

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

在适合用户桌面环境的网络浏览器中打开给定的url ，如果成功则返回true ，否则返回false 。

如果 URL 是对本地文件的引用（即 URL 方案为 "文件"），则将使用合适的应用程序而不是网络浏览器打开该文件。

下面的示例将打开 Windows 文件系统中包含空格的路径上的一个文件：

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

如果指定了mailto URL，用户的电子邮件客户端将被用来打开一个包含 URL 中指定选项的作曲家窗口，类似于网络浏览器处理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() 行为的方法。如果使用带有指定scheme 的 URL 调用openUrl() ，则会调用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 DeveloperDocumentation for Defining a Custom URL Scheme for Your App。

要声称支持 http 和 https，Info.plist 文件中的上述条目是不允许的。只有将域名添加到 "权限 "文件中时，才可以这样做：

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

安装应用程序时，iOS/macOS 会在你的域上搜索 /.owned/apple-app-site-association。如果要收听https://your.domain.com/help?topic=ABCDEF ，需要在其中提供以下内容：

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

有关详细信息，请参阅 Apple Developer Documentation forSupporting Associated Domains。

安卓

要使用此功能从 Android 上的其他应用程序接收数据，需要在应用程序清单的activity 中添加一个或多个意图过滤器：

<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 Developer Documentation forCreate Deep Links to App Content。

要立即打开 Android 应用中的相应内容，而不需要用户选择应用，您需要验证您的链接。要启用验证，请在意图过滤器中添加一个附加参数：

<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 Developer Documentation forVerify Android App Links。

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

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

删除先前为指定scheme 设置的 URL 处理程序。

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

另请参阅 setUrlHandler()。