应用链接说明
uris标签说明
当在module.json5文件的skills字段中声明uris时,主要包含如下字段。
说明:
- 通过浏览器拉起应用页面时,浏览器会将uri中scheme和host中的大写字母自动转化为小写字母,导致无法正确匹配应用。因此建议scheme和host中不要包含大写字母。
- path、pathStartWith、pathRegex的取值前后均不需要加斜杠
/。例如对于应用链接https://developer.huawei.com/consumer/cn/support,path字段应配置为consumer/cn/support。
-
scheme:协议名称。常见的取值有http、https、file、ftp等,也可以自定义。
-
host:域名或IP地址。例如域名
developer.huawei.com或IP地址127.0.0.1。 -
port:端口号。例如
developer.huawei.com:80后面的80即为端口号。 -
path:路径,表示域名服务器上的目录或文件路径,该字段在scheme存在时才有意义。path字段不支持通配符,如果需要使用通配符,可以采用pathRegex字段。
-
pathStartWith:路径前缀,该字段在scheme存在时才有意义,表示域名服务器上的目录或文件路径的前缀,用于前缀匹配。
-
pathRegex:路径正则,该字段在scheme存在时才有意义,表示域名服务器上的目录或文件路径的正则表达式,用于正则匹配。
-
linkFeature:应用的功能类型(如文件打开、分享、导航等)。取值为长度不超过127字节的字符串,不支持中文。
URL的基本格式
按照配置的字段不同,uris可以拼接为不同的URL表达式。其中,scheme为必选字段,其他字段仅当scheme存在时才有意义。
- 只配置scheme:
scheme:// - 只配置scheme和host:
scheme://host - 只配置scheme、host和port:
scheme://host:port - 当配置了path、pathStartWith或pathRegex字段时,组成的表达式如下。
三方应用组件配置的scheme不能与系统应用重复,否则会导致无法通过该uri拉起三方应用组件。
- 全路径表达式:
scheme://host:port/path - 路径前缀表达式:
scheme://host:port/pathStartWith - 路径正则表达式:
scheme://host:port/pathRegex
- 全路径表达式:
说明:
- 三方应用组件配置的scheme不能与系统应用重复,否则会导致无法通过该uri拉起三方应用组件。
- 如果多个应用的URL配置相同,应用跳转时匹配到同多个应用,则会拉起应用选择框。为了更好的用户体验,开发者可以通过链接的path字段去区分同一域名下的不同应用,如链接
https://www.example.com/path1拉起目标应用1,链接https://www.example.com/path2拉起目标应用2。
linkFeature标签说明
说明:
同一Bundle中声明的linkFeature数量不能超过150个。
目标应用在linkFeature字段中申明功能类型,并通过应用市场上架审核后,可以提升应用跳转体验。主要用于以下两种场景:
-
支持系统识别同类应用:当调用方拉起垂类应用(例如导航类应用)时,系统会根据linkFeature字段识别到匹配的应用,并在应用面板中展现。
值 说明 AppStorageMgmt 指示清理应用沙箱目录中缓存数据的功能 FileOpen 指示打开处理文件的功能 Navigation 指示导航功能 RoutePlan 指示路线规划功能 PlaceSearch 指示地点搜索功能 -
跳转一键返回能力:用户从A应用跳转至B应用的某个功能界面后,B应用调用一键返回能力,可以支持用户直接返回A应用,无问询弹窗。例如:A应用跳转至B应用的支付界面,若B应用已申请了支付的linkfeature,则用户在B应用内完成操作后,可一键返回A应用。
值 说明 Login 指示登录、授权登录等功能 Pay 指示支付页面、收银台等功能 Share 指示分享功能
配置示例
下面以授权登录场景举例说明:
"uris": [
{
"scheme": "https",
"host": "developer.huawei.com",
"path": "consumer",
"linkFeature": "Login"
}
]