Deeplinks
此插件处理iOS和Android上的深层链接,用于自定义网址方案链接和通用应用链接。
Repo(备用): https://github.com/ionic-team/ionic-plugin-deeplinks
Installation(安装)
1.安装Cordova和Ionic原生插件:
$ ionic cordova plugin add ionic-plugin-deeplinks --variable URL_SCHEME=myapp --variable DEEPLINK_SCHEME=https --variable DEEPLINK_HOST=example.com --variable ANDROID_PATH_PREFIX=/
$ npm install --save @ionic-native/deeplinks
Supported platforms(支持平台)
Android
Browser
iOS
Usage(用法)
import { Deeplinks } from '@ionic-native/deeplinks';
constructor(private deeplinks: Deeplinks) { }
this.deeplinks.route({
'/about-us': AboutPage,
'/universal-links-test': AboutPage,
'/products/:productId': ProductPage
}).subscribe((match) => {
// match.$route - the route we matched, which is the matched entry from the arguments to route()
// match.$args - the args passed in the link
// match.$link - the full link data
console.log('Successfully matched route', match);
}, (nomatch) => {
// nomatch.$link - the full link data
console.error('Got a deeplink that didn\'t match', nomatch);
});
或者,如果您使用Ionic,则有一个方便的方法来引用NavController
并为您处理实际导航:
this.deeplinks.routeWithNavController(this.navController, {
'/about-us': AboutPage,
'/products/:productId': ProductPage
}).subscribe((match) => {
// match.$route - the route we matched, which is the matched entry from the arguments to route()
// match.$args - the args passed in the link
// match.$link - the full link data
console.log('Successfully matched route', match);
}, (nomatch) => {
// nomatch.$link - the full link data
console.error('Got a deeplink that didn\'t match', nomatch);
});
参见Ionic Deeplinks Demo有关如何检索NavController的示例
在运行时引用。
Instance Members(实例成员)
定义一组路径以匹配传入的深层链接。
参数 | 类型 | 详情 |
---|---|---|
paths | paths | 定义一组路径以匹配传入的深层链接。 路径采用{'path':data}形式的对象。 如果一个深层链接与路径匹配,则生成的路径数据对将在允诺结果中返回,然后您可以根据需要在应用中导航。 |
****Returns:** Observable<DeeplinkMatch>
返回一个Observable,每次深层链接都会被调用,并且当深层链接不符合给定的路径是会返回错误。
routeWithNavController(navController, paths)
这是路由的简单版本
它引用了来自Ionic的NavController或符合此协议的自定义类:
NavController.push = function(View, Params){}
当路由匹配时,此处理程序将自动导航。 如果需要对匹配的深层链接的行为进行更细粒度的控制,请使用普通路由
方法。
参数 | 类型 | 详情 |
---|---|---|
navController | Nav | 定义一组路径以匹配传入的深层链接。 路径采用{'path':data}形式的对象。 如果一个深层链接与路径匹配,则生成的路径数据对将在允诺结果中返回,然后您可以根据需要在应用中导航。 |
paths | Object |
****Returns:** Observable<DeeplinkMatch>
返回一个Observable,它可以在每次深入链接进行时解析,并且在深层链接不符合给定的路径时返回错误。
DeeplinkMatch
参数 | 类型 | 详情 |
---|---|---|
$route | any | 匹配路由的路由信息 |
$args | any | 任何参数都通过路由参数或GET参数传递 |
$link | any | 从插件处理的deeplink对象以及路由匹配时可用作“extras”的任何内部本地数据(例如,Facebook有时添加额外的数据) |