1# 应用链接说明
2
3## uris标签说明
4当在[module.json5](../quick-start/module-configuration-file.md)文件的[skills字段](../quick-start/module-configuration-file.md#skills标签)中声明uris时，主要包含如下字段。
5
6> **说明：**
7>
8> - 通过浏览器拉起应用页面时，浏览器会将uri中scheme和host中的大写字母自动转化为小写字母，导致无法正确匹配应用。因此建议scheme和host中不要包含大写字母。
9> - path、pathStartWith、pathRegex的取值前后均不需要加斜杠`/`。例如对于应用链接`https://developer.huawei.com/consumer/cn/support`，path字段应配置为`consumer/cn/support`。
10
11- scheme：协议名称。常见的取值有http、https、file、ftp等，也可以自定义。
12- host：域名或IP地址。例如域名`developer.huawei.com`或IP地址`127.0.0.1`。
13- port：端口号。例如`developer.huawei.com:80`后面的80即为端口号。
14- path：路径，表示域名服务器上的目录或文件路径，该字段在scheme存在时才有意义。path字段不支持通配符，如果需要使用通配符，可以采用pathRegex字段。
15
16
17- pathStartWith：路径前缀，该字段在scheme存在时才有意义，表示域名服务器上的目录或文件路径的前缀，用于前缀匹配。
18- pathRegex：路径正则，该字段在scheme存在时才有意义，表示域名服务器上的目录或文件路径的正则表达式，用于正则匹配。
19- [linkFeature](#linkfeature标签说明)：应用的功能类型（如文件打开、分享、导航等）。取值为长度不超过127字节的字符串，不支持中文。
20
21### URL的基本格式
22
23按照配置的字段不同，uris可以拼接为不同的URL表达式。其中，scheme为必选字段，其他字段仅当scheme存在时才有意义。
24
25- 只配置scheme：`scheme://`
26- 只配置scheme和host：`scheme://host`
27- 只配置scheme、host和port：`scheme://host:port`
28- 当配置了path、pathStartWith或pathRegex字段时，组成的表达式如下。
29    三方应用组件配置的scheme不能与系统应用重复，否则会导致无法通过该uri拉起三方应用组件。
30    - **全路径表达式**：`scheme://host:port/path`
31    - **路径前缀表达式**：`scheme://host:port/pathStartWith`
32    - **路径正则表达式**：`scheme://host:port/pathRegex`
33
34> **说明：**
35> - 三方应用组件配置的scheme不能与系统应用重复，否则会导致无法通过该uri拉起三方应用组件。
36> - 如果多个应用的URL配置相同，应用跳转时匹配到同多个应用，则会拉起应用选择框。为了更好的用户体验，开发者可以通过链接的path字段去区分同一域名下的不同应用，如链接`https://www.example.com/path1`拉起目标应用1，链接`https://www.example.com/path2`拉起目标应用2。
37
38
39### linkFeature标签说明
40
41目标应用在linkFeature字段中申明功能类型，并通过应用市场上架审核后，可以提升应用跳转体验。主要用于以下两种场景：
42
431. 支持系统识别同类应用：当调用方拉起垂类应用（例如导航类应用）时，系统会根据linkFeature字段识别到匹配的应用，并在应用面板中展现。
44
45    |值|说明|
46    |---|---|
47    |AppStorageMgmt|指示清理应用沙箱目录中缓存数据的功能|
48    |FileOpen|指示打开处理文件的功能|
49    |Navigation|指示导航功能|
50    |RoutePlan|指示路线规划功能|
51    |PlaceSearch|指示地点搜索功能|
52
532. 跳转一键返回能力：用户从A应用跳转至B应用的某个功能界面后，B应用调用[一键返回能力](../reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextbacktocallerabilitywithresult12)，可以支持用户直接返回A应用，无问询弹窗。例如：A应用跳转至B应用的支付界面，若B应用已申请了支付的linkfeature，则用户在B应用内完成操作后，可一键返回A应用。
54
55    |值|说明|
56    |---|---|
57    |Login|指示登录、授权登录等功能|
58    |Pay|指示支付页面、收银台等功能|
59    |Share|指示分享功能|
60
61## 配置示例
62
63
64下面以授权登录场景举例说明：
65
66```json
67"uris": [
68    {
69        "scheme": "https",
70        "host": "developer.huawei.com",
71        "path": "consumer",
72        "linkFeature": "Login"
73    }
74]
75```
76