Android(安卓)Activity URL Scheme的介绍与应用

有可能说到URL Scheme，很多还不太了解，甚至根本就不知道是什么东西。下面我们来好好认识一下它。

什么是URL Scheme

URL Scheme 是Android中一种页面内跳转的协议；也可以被称为 URLRouter。它可以通过匹配 URI 去打开对应的Activity。就类似网页中，我们打开网页的方式去打开一个Activity。当然这是一种通过Intent隐式打开Activity的方式。现在模块化开发时，遇到特别复杂的模块组合，也有可能会用的它。

URL Scheme 协议格式

我们通过Scheme启动Activity时，是通过Intent.setData(Uri uri)启动Activity的。它需要的参数是一个URI。所以URL Scheme的协议的格式其实就是 URI的格式。

一个完整的Scheme的协议格式由 scheme、userInfo、host、port、path、query和fragment 组成。结构如下：

scheme://userInfo@host:port/path?query#fragment

其中 scheme://是固定的格式。userInfo@ 可以省略，host 是必须的。port 、query 和 fragment 也是可以省略的。

其中scheme既可以是Android已经定义好的协议，也可使用我们自定义的。Android 常见的scheme 协议有：content 、file、http 等。如果我们自定义协议就可以随意使用一些字符串来限定协议。当然最好是有一定含义的字符串。如下面的协议:

xieyi://ricky@me.ricky.sample:8080/userDetails?param1=参数1¶m2=参数2#片段"

xieyi : 即为 Scheme ，即我们自定义的Scheme 协议名称
ricky :即为用户信息，注意它跟host 之间一定要跟上 @ 符号
me.ricky.sample : 即为 host ；这里我用了一个包名
8080 ：即为 port ；自定义协议的端口号
userDetails: 即为path ，路径；代表scheme的指定的页面，我们匹配页面的时候，这里就是匹配的重点
param1 和 param2：即为 query ,代表我们跳转到指定界面后传递的参数
片段：即为fragment，也可以把它看成跳转到指定界面后传递的参数，只不过它只能传递一个，而query 可以传递多个它会把 #后的所有的内容都看成一个片段。

Activity中Scheme的使用方式

首先我们可以确定的是，通过 scheme启动Activity 是通过Intent 隐式启动的；隐式调用需要在 AndroidManifest 里的标签下添加来设置；使用scheme的时候需要在标签里面设置我们需要的 URL Scheme 信息。

Scheme相关标签介绍

接下来我们介绍一下里的关于scheme的各个标签的含义：

常用的几个

//对应的就是我们上面提到 hostandroid:host="me.ricky.sample"//路径，必须以 / 开头android:path="/path"//端口android:port="8080"//协议android:scheme="xieyi"

不太常用的几个

//路径的前缀，必须以 /  开头android:pathPrefix="/path"//匹配路径的正则android:pathPattern=".*path"

了解上面的这些，那scheme到底应该怎么用呢？

简单使用Scheme

首先我们新建一个Activity，命名为 SchemeActivity；然后在AndroidManifest里作如下配置：

<activity android:name=".SchemeActivity">    <intent-filter>        <action android:name="me.ricky.sample.action"/>        <category android:name="android.intent.category.DEFAULT"/>        <data            android:host="me.ricky.sample"            android:scheme="xieyi"            />    intent-filter>activity>

这里我们设置最简单的Scheme设置。如果我们要启动该Activity，应该怎么办呢？

intent.setAction("me.ricky.sample.action");startActivity(intent);

上面的代码是通过隐式的Action去启动Activity，如果你只是这样简单去启动Activity，一定是不行的，因为我们设置标签，系统无法匹配到特定的Activity，那它就会报出以下的异常：

android.content.ActivityNotFoundException: No Activity found to handle Intent { act=me.ricky.sample.action }

如果我们想完全匹配那么就需要给设置该action的Activity，指定data数据：

Uri uri = Uri.parse("xieyi://me.ricky.sample");intent.setAction("me.ricky.sample.action");intent.setData(uri);startActivity(intent);

xieyi://me.ricky.sample 其中的scheme就是 xieyi对应的是我们在 AndroidManifest中设定的android:scheme="xieyi"；;me.ricky.sample对应的是我们在 AndroidManifest中设定的 android:host="me.ricky.sample"

这样就能匹配我们设定Activity了。

当然这是最简单的Scheme的使用。没有什么难度。我们启动Activity时，完全匹配了我们在AndroidManifest里设置的scheme信息。

通过SchemeURL 传递参数

xieyi://ricky@me.ricky.sample:8080/userDetails?param1=参数1¶m2=参数2#片段"

这URI 几乎包含了URI的所有的组成。其中包含了一些参数。那么我们如何在被启动的Activity中获取这些参数呢？它的用法跟通过Intent获取额外的参数是一样的。只不过我们是通过解析URI 来获取。

如果我们将这个URI作为参数启动Activity，

Intent intent = new Intent();Uri uri = Uri.parse("xieyi://ricky@me.ricky.sample:8080/userDetails?param1=参数1¶m2=参数2#片段");intent.setAction("me.ricky.sample.action");intent.setData(uri);startActivity(intent);

那我们可以在被启动的SchemeActivity的onCreate()方法中通过下面的方法获取URI的各个部分。

Uri uri = getIntent().getData();String host = uri.getHost();String authority = uri.getAuthority();//authority包括host和port两部分String scheme = uri.getScheme();String query = uri.getQuery();//获取的是 “param1=参数1¶m2=参数2”String path = uri.getPath();int port = uri.getPort();String frag = uri.getFragment();String userInfo = uri.getUserInfo();String param1 = uri.getQueryParameter("param1");String param2 = uri.getQueryParameter("param2");

这样我们就可以通过scheme 来进行Activity之间的信息传递了。

Scheme 的匹配规则

除了上提到的 AndroidManifest中的设置数据和我们在Intent.setData(Uri uri)；设定的一一对应之外。还有几个简单的依赖规则。

如果没有指定scheme ,那么URI所有的参数都会无效的。也就是说它忽略data里设置其它关于Scheme的信息；而且在AndroidStudio会有报错。
如果没有指定host,也是可以的；但是port参数会被忽略；

当我们通过Intent将URI参数与中的标签中指定的URI对比时，系统会只对比标签指定的部分。

如果你指定了，那么所有带有该的URI 都能匹配到该。
如果你指定了和authority(authority包括host和port两部分)，那么所有具有相同scheme和authority的URI都能匹配到该intent-filter，而不用考虑path为何值。
如果你指定了、、和，那么只有具有相同scheme、authority和path的URI才能匹配到该intent-filter。

需要注意，这里path设定时还可以通过下面的属性设置

//路径的前缀，必须以 /  开头android:pathPrefix="/path"//匹配路径的正则android:pathPattern=".*path"

pathPrefix指定是前缀，只要我们设定的path的前缀pathPrefix设置一致就可以通过path打开特定的Activity；同理下面的pathPattern；是通过正则来匹配path,只要能匹配通过就可以通过path打开特定的Activity。

通过Scheme跨应用启动Activity

如果要通过scheme跨应用启动Activity，其实也很简单:

Intent intent = new Intent();Uri uri = Uri.parse("xieyi://ricky@me.ricky.sample:8080/userDetails?param1=参数1¶m2=参数2#片段");intent.setAction("me.ricky.sample.action");intent.setData(uri);startActivity(intent);

跟上面同一个应用中启动Activity时一样的，这里需要注意的是：如果不希望启动的Activity跟当前的Activity在同一个栈了，需要加上下面的代码：

intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

在网页中启动Activity

<a href="xieyi://ricky@me.ricky.sample:8080/userDetails">查看用户详情a>

注意：在网页中启动Activity 未经本人验证，只是从其它地方看到的。

另：一般隐式启动Activity，需要我们去验证一下我们的Intent指定的Activity是否存在。如果存在就可以放心的去启动相应的Activity了。

private boolean checkIntent(Intent intent) {    PackageManager manager = getPackageManager();    List resolveInfos = manager.queryIntentActivities(intent, PackageManager.MATCH_ALL);    System.out.println(resolveInfos);    return !resolveInfos.isEmpty();}