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을 지정하면 웹 브라우저에서 mailto 링크가 처리되는 방식과 유사하게 사용자의 이메일 클라이언트를 사용하여 URL에 지정된 옵션이 포함된 작성기 창을 엽니다.

예를 들어 다음 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 ()가 지정된 scheme URL과 함께 호출되면 외부 애플리케이션을 실행하는 QDesktopServices 대신 receiver 객체의 지정된 method 가 호출됩니다.

제공된 메서드는 하나의 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>

자세한 내용은 앱의 사용자 지정 URL 구성표 정의에 대한 Apple 개발자 문서를 참조하세요.

http 및 https에 대한 지원을 요청하려면 Info.plist 파일에서 위의 항목은 허용되지 않습니다. 이는 자격 파일에 도메인을 추가할 때만 가능합니다:

<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-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 앱에서 해당 콘텐츠를 즉시 열려면 링크를 인증해야 합니다. 확인을 활성화하려면 의도 필터에 추가 매개 변수를 추가합니다:

<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"]
  }
}]

자세한 내용은 안드로이드 앱 링크 확인에 대한 안드로이드 개발자 문서를 참조하세요.

openUrl() 및 unsetUrlHandler()도 참조하세요 .

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

지정된 scheme 에 대해 이전에 설정된 URL 핸들러를 제거합니다.

scheme 에 등록된 핸들러 객체가 소멸되기 전에 이 함수를 호출하면 동시 openUrl() 호출이 소멸된 핸들러 객체를 계속 호출하는 것을 방지할 수 있습니다.

setUrlHandler()도 참조하세요 .