QDesktopServices Class

멤버 함수 설명서

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

지정된 url 을 사용자의 데스크톱 환경에 적합한 웹 브라우저에서 열고, 성공하면 true 을 반환하며, 그렇지 않으면 false 을 반환합니다.

URL이 로컬 파일을 참조하는 경우(즉, URL 스키마가 "file"인 경우), 웹 브라우저 대신 적절한 응용 프로그램으로 파일이 열립니다.

다음 예제는 공백이 포함된 경로에 있는 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로 호출될 경우, 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-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-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()도 참조하십시오 .