{"id":439,"date":"2022-09-28T21:37:52","date_gmt":"2022-09-28T13:37:52","guid":{"rendered":"https:\/\/blog.osvlabs.com\/?p=439"},"modified":"2022-09-28T21:37:52","modified_gmt":"2022-09-28T13:37:52","slug":"flutter-universal-links-%e7%ae%80%e5%8d%95%e4%bb%8b%e7%bb%8d%e4%b8%8e%e4%bd%bf%e7%94%a8","status":"publish","type":"post","link":"https:\/\/blog.osvlabs.com\/?p=439","title":{"rendered":"Flutter Universal Links \u7b80\u5355\u4ecb\u7ecd\u4e0e\u4f7f\u7528"},"content":{"rendered":"

\u4ecb\u7ecd<\/h2>\n

Universal Link, URL Schemes \u662f iOS \u7cfb\u7edf\u4e2d\u7528\u4e8e\u4ece\u5916\u90e8\u6253\u5f00 app \u8fdb\u884c\u8df3\u8f6c\u7684\u4e00\u79cd\u65b9\u5f0f; AppLink \u548c DeepLink \u5219\u662f Android \u7cfb\u7edf\u4e2d\u7528\u4e8e\u4ece\u5916\u90e8\u6253\u5f00 app \u8fdb\u884c\u8df3\u8f6c\u7684\u65b9\u5f0f\u3002<\/p>\n

URL Schemes<\/h3>\n

URL Schemes \u662f iOS9 \u4e4b\u524d\u4e00\u76f4\u5728\u4f7f\u7528\u7684\u8df3\u8f6c\u65b9\u5f0f\uff0c\u53ef\u4ee5\u5728 App \u95f4\u8df3\u8f6c\uff0c\u4e5f\u53ef\u4ee5\u901a\u8fc7\u5728 Safari \u4e2d\u8f93\u5165 schema:\/\/<\/code> \u8fdb\u884c\u8df3\u8f6c\u3002\u8fd9\u79cd\u65b9\u5f0f\u4f1a\u5728\u7f51\u9875\u4e2d\u663e\u793a\u4e00\u4e2a: \u5728 APPName \u4e2d\u6253\u5f00\u94fe\u63a5\u5417<\/code> \u7684\u5f39\u7a97\uff0c\u5982\u679c\u672a\u627e\u5230\u5bf9\u5e94\u7684 schemes url, \u5219\u4f1a\u63d0\u793a Safari\u6d4f\u89c8\u5668\u6253\u4e0d\u5f00\u8be5\u7f51\u9875\uff0c\u56e0\u4e3a\u7f51\u5740\u65e0\u6548\u3002<\/code>\u3002 \u9700\u8981\u5728 info.plist<\/code> \u91cc\u914d\u7f6eapp \u7684 scheme url<\/p>\n

Universal Link<\/h3>\n

Universal Link \u662f iOS9 \u4e4b\u540e\u51fa\u73b0\u7684\u65b0\u6280\u672f\uff0c\u5fc5\u987b\u901a\u8fc7 https:\/\/<\/code> \u8fdb\u884c\u8df3\u8f6c\u3002\u5982\u679c\u5728\u624b\u673a\u4e2d\u627e\u5230\u8981\u8df3\u8f6c\u7684 app, \u5219\u4f1a\u5728\u9876\u90e8\u663e\u793a\u4e2a\u662f\u5426\u6253\u5f00app \u7684\u6761\u5e45\uff1b\u5982\u679c\u672a\u627e\u5230app, \u5219\u6b63\u5e38\u663e\u793a\u8be5\u7f51\u9875\u3002\u8fd9\u79cd\u65b9\u5f0f\u9664\u4e86\u9700\u8981\u5728 xcode \u4e2d\u5bf9\u9879\u76ee\u8fdb\u884c\u914d\u7f6e\u5916\uff0c\u8fd8\u9700\u8981\u521b\u5efa\u4e00\u4e2a apple-app-site-association<\/code> \u6587\u4ef6\u4e0a\u4f20\u5230\u9879\u76ee\u7684\u670d\u52a1\u5668\u4e0a\u3002<\/p>\n

DeepLink<\/h3>\n

DeepLink \u662f\u5728 Android \u4e0a\u7c7b\u4f3c\u4e8e iOS \u4e0aURL Schemes \u7684\u65b9\u5f0f\u3002DeepLink \u53ef\u4ee5\u8ba9\u7528\u6237\u8fdb\u5165\u5230\u6307\u5b9a\u7684 Activity, \u7cfb\u7edf\u53ef\u80fd\u4f1a\u5f39\u51fa\u4e00\u4e2a\u9009\u62e9\u53ef\u4ee5\u5904\u7406\u6b64\u7c7b\u94fe\u63a5\u7684\u5e94\u7528\u5217\u8868\u3002<\/p>\n

AppLink<\/h3>\n

AppLink \u662f\u5728 Android \u4e0a\u7c7b\u4f3c\u4e8e iOS \u4e0aUniversal Link \u7684\u65b9\u5f0f, \u53ef\u4ee5\u76f4\u63a5\u4ece\u7f51\u7ad9\u6253\u5f00app \u800c\u65e0\u9700\u7528\u6237\u9009\u62e9\uff0cAppLink \u4e5f\u662f\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u6587\u4ef6\u4e0a\u4f20\u5230\u670d\u52a1\u5668\u3002<\/p>\n

\u4f7f\u7528<\/h2>\n

\u5b89\u88c5<\/h3>\n
\n

\u8fd9\u91cc\u4ecb\u7ecd\u4e0b uni_link<\/a>\u63d2\u4ef6\u7684\u4f7f\u7528.<\/p>\n<\/blockquote>\n

flutter pub add uni_links<\/code><\/p>\n

\u914d\u7f6e<\/h3>\n

URL Scheme<\/h4>\n

\u4fee\u6539 ios\/Runner\/Info.plist<\/code><\/p>\n

<?xml ...>\n<!-- ... other tags -->\n<plist>\n<dict>\n  <!-- ... other tags -->\n  <key>CFBundleURLTypes<\/key>\n  <array>\n    <dict>\n      <key>CFBundleTypeRole<\/key>\n      <string>Editor<\/string>\n      <key>CFBundleURLName<\/key>\n      <string>[ANY_URL_NAME]<\/string>\n      <key>CFBundleURLSchemes<\/key>\n      <array>\n        <string>[YOUR_SCHEME]<\/string>\n      <\/array>\n    <\/dict>\n  <\/array>\n  <!-- ... other tags -->\n<\/dict>\n<\/plist><\/code><\/pre>\n
\u6b64\u65f6\u5c31\u53ef\u4ee5\u4f7f\u7528 YOUR_SCHEME:\/\/ANYTHING<\/code> \u6253\u5f00app<\/p>\n
Universal Link<\/h4>\n
    \n
  1. \u521b\u5efa com.apple.developer.associated-domains<\/code> entitlement \u6587\u4ef6\n
    <?xml version="1.0" encoding="UTF-8"?>\n<!DOCTYPE plist PUBLIC "-\/\/Apple\/\/DTD PLIST 1.0\/\/EN" "http:\/\/www.apple.com\/DTDs\/PropertyList-1.0.dtd">\n<plist version="1.0">\n<dict>\n<!-- ... other keys -->\n<key>com.apple.developer.associated-domains<\/key>\n<array>\n<string>applinks:[YOUR_HOST]<\/string>\n<\/array>\n<!-- ... other keys -->\n<\/dict>\n<\/plist><\/code><\/pre>\n<\/li>\n
  2. \u521b\u5efa apple-app-site-association<\/code> \u6587\u4ef6\uff0c\u65e0\u540e\u7f00\uff0c\u5185\u5bb9\u662f\u4e2ajson<\/code>\u683c\u5f0f,\u7c7b\u4f3c\u8fd9\u79cd\n
    {\n"applinks": {\n    "apps": [],\n    "details": [\n        {\n            "appID": "TEAMIDSHSAUX.com.test.bundle",\n            "paths": [ "*" ]\n        }\n    ]\n}\n}<\/code><\/pre>\n<\/li>\n
  3. \u5c06\u4e0a\u9762\u751f\u6210\u597d\u7684 apple-app-site-association \u4e0a\u4f20\u5230 web server<\/li>\n
  4. \u7b49\u5f85\u751f\u6548(\u6709\u65f6\u5f88\u4e45\u6709\u65f6\u5f88\u5feb\uff0c\u6700\u957f24h)\uff0c \u53ef\u4ee5\u5728 https:\/\/search.developer.apple.com\/appsearch-validation-tool\/<\/code> \u5b98\u65b9\u7f51\u7ad9\u67e5\u770b\u72b6\u6001.
    \n
    \n
    \u9700\u8981\u628a app \u5220\u6389\u91cd\u88c5.
    \n\u9700\u8981\u628a app \u5220\u6389\u91cd\u88c5.
    \n\u9700\u8981\u628a app \u5220\u6389\u91cd\u88c5.<\/p>\n<\/blockquote>\n<\/li>\n
  5. \u5728safari \u4e2d\u6253\u5f00\u4f60\u914d\u7f6e\u7684\u57df\u540d\u5c31\u53ef\u4ee5\u4e86
    \n
    APPLinks \u548c Deep Links<\/h4>\n<\/li>\n
  6. \n
    \u4fee\u6539  android\/app\/src\/main\/AndroidManifest.xml<\/code> \u6587\u4ef6<\/p>\n
    <manifest ...>\n<!-- ... other tags -->\n<application ...>\n<activity ...>\n  <!-- ... other tags -->\n\n  <!-- Deep Links -->\n  <intent-filter>\n    <action android:name="android.intent.action.VIEW" \/>\n    <category android:name="android.intent.category.DEFAULT" \/>\n    <category android:name="android.intent.category.BROWSABLE" \/>\n    <!-- Accepts URIs that begin with YOUR_SCHEME:\/\/YOUR_HOST -->\n    <data\n      android:scheme="[YOUR_SCHEME]"\n      android:host="[YOUR_HOST]" \/>\n  <\/intent-filter>\n\n  <!-- App Links -->\n  <intent-filter android:autoVerify="true">\n    <action android:name="android.intent.action.VIEW" \/>\n    <category android:name="android.intent.category.DEFAULT" \/>\n    <category android:name="android.intent.category.BROWSABLE" \/>\n    <!-- Accepts URIs that begin with https:\/\/YOUR_HOST -->\n    <data\n      android:scheme="https"\n      android:host="[YOUR_HOST]" \/>\n  <\/intent-filter>\n<\/activity>\n<\/application>\n<\/manifest><\/code><\/pre>\n<\/li>\n
  7. AppLink \u7684\u8bdd\u8fd8\u9700\u8981 \u4e0a\u4f20 \/.well-known\/assetlinks.json<\/code> \u6587\u4ef6\u5230\u670d\u52a1\u5668(https:\/\/domain.name\/.well-known\/assetlinks.json<\/code>)\n
    [\n{\n    "relation": [\n        "delegate_permission\/common.handle_all_urls"\n    ],\n    "target": {\n        "namespace": "android_app",\n        "package_name": "fr.smarquis.applinks",\n        "sha256_cert_fingerprints": [\n            "6B:41:26:A6:1E:D8:BD:91:D3:8B:57:10:5F:07:5C:2D:AB:3E:26:A4:D1:3C:9C:97:15:78:9E:0D:56:0A:CE:DC"\n        ]\n    }\n}\n]<\/code><\/pre>\n<\/li>\n
  8. \u5728 Chrome \u4e2d\u6253\u5f00\u4f60\u914d\u597d\u7684\u94fe\u63a5
    \n
    \n
    AppLink\u4e0d\u80fd\u76f4\u63a5\u5728\u5730\u5740\u680f\u91cc\u8f93\u5165\uff0c\u9700\u8981\u7528 location.href=<\/code> \u8fd9\u79cd\u8df3\u8f6c\u7684\u65b9\u5f0f\u624d\u80fd\u6253\u5f00app<\/strong>
    \nAppLink\u4e0d\u80fd\u76f4\u63a5\u5728\u5730\u5740\u680f\u91cc\u8f93\u5165\uff0c\u9700\u8981\u7528 location.href=<\/code> \u8fd9\u79cd\u8df3\u8f6c\u7684\u65b9\u5f0f\u624d\u80fd\u6253\u5f00app<\/strong>
    \nAppLink\u4e0d\u80fd\u76f4\u63a5\u5728\u5730\u5740\u680f\u91cc\u8f93\u5165\uff0c\u9700\u8981\u7528 location.href=<\/code> \u8fd9\u79cd\u8df3\u8f6c\u7684\u65b9\u5f0f\u624d\u80fd\u6253\u5f00app<\/strong><\/p>\n<\/blockquote>\n<\/li>\n<\/ol>\n
    \u63a5\u6536\u6570\u636e<\/h3>\n
    \nimport 'dart:async';\nimport 'dart:io';\n\nimport 'package:uni_links\/uni_links.dart';\n\n\/\/ ...\n\n  StreamSubscription _sub;\n\n  Future<void> initUniLinks() async {\n    \/\/ ... check initialUri\n\n    \/\/ Attach a listener to the stream\n    _sub = uriLinkStream.listen((Uri? uri) {\n      \/\/ Use the uri and warn the user, if it is not correct\n    }, onError: (err) {\n      \/\/ Handle exception by warning the user their action did not succeed\n    });\n\n    \/\/ NOTE: Don't forget to call _sub.cancel() in dispose()\n  }\n\n\/\/ ...<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"
    \u4ecb\u7ecd Universal Link, URL Schemes \u662f iOS \u7cfb\u7edf\u4e2d\u7528\u4e8e\u4ece\u5916\u90e8\u6253\u5f00 app \u8fdb\u884c\u8df3\u8f6c\u7684\u4e00\u79cd\u65b9\u5f0f; AppLink \u548c DeepLink \u5219\u662f Android \u7cfb\u7edf\u4e2d\u7528\u4e8e\u4ece\u5916\u2026<\/p>\n","protected":false},"author":4,"featured_media":250,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[2],"tags":[],"blocksy_meta":{"styles_descriptor":{"styles":{"desktop":"","tablet":"","mobile":""},"google_fonts":[],"version":5}},"_links":{"self":[{"href":"https:\/\/blog.osvlabs.com\/index.php?rest_route=\/wp\/v2\/posts\/439"}],"collection":[{"href":"https:\/\/blog.osvlabs.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.osvlabs.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.osvlabs.com\/index.php?rest_route=\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.osvlabs.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=439"}],"version-history":[{"count":1,"href":"https:\/\/blog.osvlabs.com\/index.php?rest_route=\/wp\/v2\/posts\/439\/revisions"}],"predecessor-version":[{"id":440,"href":"https:\/\/blog.osvlabs.com\/index.php?rest_route=\/wp\/v2\/posts\/439\/revisions\/440"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.osvlabs.com\/index.php?rest_route=\/wp\/v2\/media\/250"}],"wp:attachment":[{"href":"https:\/\/blog.osvlabs.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=439"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.osvlabs.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=439"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.osvlabs.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=439"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}