**目录** [什么是 App Linking](#%E4%BB%80%E4%B9%88%E6%98%AF%20App%20Linking) [使用场景](#%E4%BD%BF%E7%94%A8%E5%9C%BA%E6%99%AF) [工作原理](#%E5%B7%A5%E4%BD%9C%E5%8E%9F%E7%90%86) [如何开发](#%E5%A6%82%E4%BD%95%E5%BC%80%E5%8F%91) [1.开通 App Linking](#1.%E5%BC%80%E9%80%9A%20App%20Linking) [2.确定域名](#2.%E7%A1%AE%E5%AE%9A%E5%9F%9F%E5%90%8D) [3.服务端部署 applinking.json 文件](#3.%E6%9C%8D%E5%8A%A1%E7%AB%AF%E9%83%A8%E7%BD%B2%20applinking.json%20%E6%96%87%E4%BB%B6) [4.AGC绑定域名 ](#4.AGC%E7%BB%91%E5%AE%9A%E5%9F%9F%E5%90%8D%C2%A0) [5.项目配置](#5.%E9%A1%B9%E7%9B%AE%E9%85%8D%E7%BD%AE) [6.组装聚合链接](#6.%E7%BB%84%E8%A3%85%E8%81%9A%E5%90%88%E9%93%BE%E6%8E%A5) [7.解析聚合链接中的参数](#7.%E8%8E%B7%E5%8F%96%E8%81%9A%E5%90%88%E9%93%BE%E6%8E%A5%E4%B8%AD%E7%9A%84%E5%8F%82%E6%95%B0) [其他](#%E5%85%B6%E4%BB%96) [如何获取应用ID](#%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%BA%94%E7%94%A8ID) [如何在应用未安装时点击链接跳转至应用市场](#%E5%A6%82%E4%BD%95%E5%9C%A8%E5%BA%94%E7%94%A8%E6%9C%AA%E5%AE%89%E8%A3%85%E6%97%B6%E7%82%B9%E5%87%BB%E9%93%BE%E6%8E%A5%E8%B7%B3%E8%BD%AC%E8%87%B3%E5%BA%94%E7%94%A8%E5%B8%82%E5%9C%BA) *** ## 什么是 App Linking App Linking 是一款创建跨平台的深度聚合链接。通过为用户提供无缝的内容浏览体验，提升用户转化率。 * 若用户已安装应用，点击点击链接后将直达应用内指定页面。 * 若未安装，且已配置跳转应用市场，则跳转应用市场进行下载，待安装完成后用户首次打开应用，仍将跳转至该页面（可查看文章结尾如何配置）。如果未配置跳转应用市场，则自动打开浏览器加载对应的网页内容。 ![](https://p0-xtjj-private.juejin.cn/tos-cn-i-73owjymdk6/52778e1a76df4d819b8069b9ab5d1fbf~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5rex5rW355qE6bK45ZCM5a2mbHV2aQ==:q75.awebp?policy=eyJ2bSI6MywidWlkIjoiMzE4MjQxMzM2MTk3ODI1MCJ9&rk3s=f64ab15b&x-orig-authkey=f32326d3454f2ac7e96d3d06cdbb035152127018&x-orig-expires=1747907157&x-orig-sign=SAlTakk52OsaxHmmGXz%2FTzZ%2BE1s%3D) **链接分享** ![](<> "点击并拖拽以移动") ![](https://p0-xtjj-private.juejin.cn/tos-cn-i-73owjymdk6/a7099f833b504af4b9bbbc7b6d38d325~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5rex5rW355qE6bK45ZCM5a2mbHV2aQ==:q75.awebp?policy=eyJ2bSI6MywidWlkIjoiMzE4MjQxMzM2MTk3ODI1MCJ9&rk3s=f64ab15b&x-orig-authkey=f32326d3454f2ac7e96d3d06cdbb035152127018&x-orig-expires=1747907157&x-orig-sign=fybNLOWSiar%2F%2FkuvM7YdMQUvIC4%3D) **扫码直达** ![](<> "点击并拖拽以移动") ## 使用场景扫码直达、短信链接直达、社交平台卡片分享等场景。 ## 工作原理 ![](https://p0-xtjj-private.juejin.cn/tos-cn-i-73owjymdk6/0ed9a26575234e71b5754b9effe1030d~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5rex5rW355qE6bK45ZCM5a2mbHV2aQ==:q75.awebp?policy=eyJ2bSI6MywidWlkIjoiMzE4MjQxMzM2MTk3ODI1MCJ9&rk3s=f64ab15b&x-orig-authkey=f32326d3454f2ac7e96d3d06cdbb035152127018&x-orig-expires=1747907157&x-orig-sign=d%2FLbXXw0WDnHdDNx4aK9IjSLr1E%3D)![](<> "点击并拖拽以移动") ## 如何开发开发前注意事项：使用 App Linking 需使用手动生成签名，自动签名将无法启动应用。 ### 1.开通 App Linking * 登录[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html "AppGallery Connect")，点击“我的项目”。 * 在项目列表中打开对应项目。 * 在左侧导航栏中选择“增长 > App Linking”，进入App Linking页面，点击“立即开通”。 []()[]() ![](https://p0-xtjj-private.juejin.cn/tos-cn-i-73owjymdk6/a1de29e62d1b4f1fbbea8fe8eeb16300~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5rex5rW355qE6bK45ZCM5a2mbHV2aQ==:q75.awebp?policy=eyJ2bSI6MywidWlkIjoiMzE4MjQxMzM2MTk3ODI1MCJ9&rk3s=f64ab15b&x-orig-authkey=f32326d3454f2ac7e96d3d06cdbb035152127018&x-orig-expires=1747907157&x-orig-sign=Qni0kRFgA5d6agZrAIHrBHb4%2FC4%3D) ![](<> "点击并拖拽以移动") ### 2.确定域名在配置前需确定域名，并确保域名完成https配置且能正常访问，后续在 AGC 与项目中需进行相关配置。 ### 3.服务端部署 applinking.json 文件在服务端部署 applinking.json 文件至指定目录，这里我们手动创建即可，确保能通过我们配置的域名地址：访问到 applinking 配置，如何获取应用ID可查看文章末尾。 ![](https://p0-xtjj-private.juejin.cn/tos-cn-i-73owjymdk6/916db37ea87a4402839b984ef9ac46d8~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5rex5rW355qE6bK45ZCM5a2mbHV2aQ==:q75.awebp?policy=eyJ2bSI6MywidWlkIjoiMzE4MjQxMzM2MTk3ODI1MCJ9&rk3s=f64ab15b&x-orig-authkey=f32326d3454f2ac7e96d3d06cdbb035152127018&x-orig-expires=1747907157&x-orig-sign=XBSNw7wNAz7Xtkkzk9N%2Fh80naDI%3D) ![](<> "点击并拖拽以移动") { "applinking": { "apps": [ { "appIdentifier": "你的应用id" } ] } } ![](<> "点击并拖拽以移动") ### 4.AGC绑定域名在第 1 步开通 App Linking 后，选择“应用链接-创建”，填入域名地址进行发布，发布后，若第 3 步的配置文件可正常访问，等待几分钟后看到“成功”状态，则代表域名配置成功。若出现其他错误状态，需检查配置文件是否可被访问。 ![](https://p0-xtjj-private.juejin.cn/tos-cn-i-73owjymdk6/9c80d63ae2384e7e941fe7c08a5d0b64~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5rex5rW355qE6bK45ZCM5a2mbHV2aQ==:q75.awebp?policy=eyJ2bSI6MywidWlkIjoiMzE4MjQxMzM2MTk3ODI1MCJ9&rk3s=f64ab15b&x-orig-authkey=f32326d3454f2ac7e96d3d06cdbb035152127018&x-orig-expires=1747907157&x-orig-sign=rIgGpw8MPf80rjJPIEbFPGISzqw%3D) ![](<> "点击并拖拽以移动") ![](https://p0-xtjj-private.juejin.cn/tos-cn-i-73owjymdk6/60f504731df04d888b95bd4fe3535486~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5rex5rW355qE6bK45ZCM5a2mbHV2aQ==:q75.awebp?policy=eyJ2bSI6MywidWlkIjoiMzE4MjQxMzM2MTk3ODI1MCJ9&rk3s=f64ab15b&x-orig-authkey=f32326d3454f2ac7e96d3d06cdbb035152127018&x-orig-expires=1747907157&x-orig-sign=Nylb1ANvJSt9g8ejAFqoQOpoGw8%3D) ![](<> "点击并拖拽以移动") ### 5.项目配置进入项目的 entry 模块下的 module.json5 文件，新增 App Linking 的 skills 配置。 ![](https://p0-xtjj-private.juejin.cn/tos-cn-i-73owjymdk6/1ce9476e9ae14885a83f5ac59609a88b~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5rex5rW355qE6bK45ZCM5a2mbHV2aQ==:q75.awebp?policy=eyJ2bSI6MywidWlkIjoiMzE4MjQxMzM2MTk3ODI1MCJ9&rk3s=f64ab15b&x-orig-authkey=f32326d3454f2ac7e96d3d06cdbb035152127018&x-orig-expires=1747907157&x-orig-sign=nVqLubSWoVLR4ZkA7DZrn9P3yVg%3D)![](<> "点击并拖拽以移动") 示例代码： { "entities": [ // entities必须包含"entity.system.browsable" "entity.system.browsable" ], "actions": [ // actions必须包含"ohos.want.action.viewData" "ohos.want.action.viewData" ], "uris": [ { // scheme须配置为https "scheme": "https", // host须配置为关联的域名，替换为你AGC配置的域名 "host": "www.eeeo.cc", // path可选，表示域名服务器上的目录或文件路径，例如www.example.com/path1中的path1 // 如果应用只能处理部分特定的path，则此处应该配置应用所支持的path，避免出现应用不能处理的path链接也被引流到应用中的问题，替换为你的二级path，用于精确分流 "path": "share" } ], // domainVerify须设置为true "domainVerify": true } ![](<> "点击并拖拽以移动") ### 6.组装聚合链接上述配置中，path用于精确分流，可用于指定二级地址，当前项目中配置的path为share，即当我们在鸿蒙设备中点击链接后会优先启动应用，当我们需要传递参数时，可使用 ? + & 的形式拼接 KeyValue 即可。 https://www.eeeo.cc/share?pageId=2025&channel=web ![](<> "点击并拖拽以移动") ### 7.解析聚合链接中的参数通过聚合链接启动应用后，参数会进入到 Ability 的 onCreate 生命周期的 Want.uri 中，若应用已经启动，则会进入到 onNewWant 生命周期的 Want.uri 中。此时我们解析 uri 中的 KeyValue 即可。示例代码如下： import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit'; import { url } from '@kit.ArkTS'; export default class EntryAbility extends UIAbility { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { // 从want中获取传入的链接信息。 // 如传入的url为：https://www.example.com/programs?action=showall let uri = want?.uri if (uri) { // 从链接中解析query参数，拿到参数后，可根据自己的业务需求进行后续的处理。 let urlObject = url.URL.parseURL(want?.uri); let pageId = urlObject.params.get('pageId') let channel= urlObject.params.get('channel') } } } ![](<> "点击并拖拽以移动") ## 其他 ### 如何获取应用ID 登录[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html "AppGallery Connect")，点击“我的项目”，若已创建项目，可直接在首页查看到应用ID。若未创建项目，手动创建后则会自动生成。 ![](https://p0-xtjj-private.juejin.cn/tos-cn-i-73owjymdk6/7634dd47db4246a9800057958d716af5~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5rex5rW355qE6bK45ZCM5a2mbHV2aQ==:q75.awebp?policy=eyJ2bSI6MywidWlkIjoiMzE4MjQxMzM2MTk3ODI1MCJ9&rk3s=f64ab15b&x-orig-authkey=f32326d3454f2ac7e96d3d06cdbb035152127018&x-orig-expires=1747907157&x-orig-sign=FPARrF1NgEqxIcXcpgix8RoLsgs%3D) ![](<> "点击并拖拽以移动") ### 如何在应用未安装时点击链接跳转至应用市场项目的 module.json5 配置完 AppLinking 的 skills 后，等待应用上架，上架后前往 AGC 配置AppLinking 域名的地方，点击“直达应用市场”的选项，开启直达应用市场即可。 ![](https://p0-xtjj-private.juejin.cn/tos-cn-i-73owjymdk6/e1fb87f358f44f31bc506d1876c73b09~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5rex5rW355qE6bK45ZCM5a2mbHV2aQ==:q75.awebp?policy=eyJ2bSI6MywidWlkIjoiMzE4MjQxMzM2MTk3ODI1MCJ9&rk3s=f64ab15b&x-orig-authkey=f32326d3454f2ac7e96d3d06cdbb035152127018&x-orig-expires=1747907157&x-orig-sign=GxHOUt9NVcNDRy11eODLchL%2Bpow%3D)![](<> "点击并拖拽以移动") ![](https://p0-xtjj-private.juejin.cn/tos-cn-i-73owjymdk6/2810af1317d84122ad78c534ca2d6e14~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5rex5rW355qE6bK45ZCM5a2mbHV2aQ==:q75.awebp?policy=eyJ2bSI6MywidWlkIjoiMzE4MjQxMzM2MTk3ODI1MCJ9&rk3s=f64ab15b&x-orig-authkey=f32326d3454f2ac7e96d3d06cdbb035152127018&x-orig-expires=1747907157&x-orig-sign=srsjN0LAMUfg%2FoYuUoHCc7o9Q6g%3D)![](<> "点击并拖拽以移动")