Android Dynamic Action，简称DA，是一种简便、可变Action的实现方案。DA框架的初衷是为了取代Context.startActivity的调用方式，使用建造者模式(Builder Pattern)构建交互参数，使程序更优美。DA框架能够对任何一个已经存在的Action修改，动态改变原有的跳转逻辑。值得一提的是，DA框架不仅友好地实现了与H5间的跳转交互，也解决了Activity在插件化项目的交互问题。
项目地址：https://github.com/benniaobuguai/android-dynamic-action
DA的URI基本结构
在DA框架下，Activity是一个有趣的概念实体，每一个Activity都可视作DA框架下的一种资源。对于一个客户端而言，每个Activity都是全局唯一可访问的资源，因此每个Activity都有统一资源标识符(URI)。
URI的基本结构：
scheme://com.example.project:8888/path/etc?id=1024
\-----/ \------------------/\--/ \------/\-------/
scheme host port path query parameter
\---------------------/
authority
DA框架基于标准的URI，定制了更符合Android Activity交互的URI结构。
定制后的URI基本结构：
scheme://packageId$ActionName?data={"id":"1024"}
\-----/ \------------------/\-----------------/
scheme host query parameter
基于以上协议，定义属于自己的scheme，每个Activity将具有一个可被访问的URI，你就能够像访问网页一样访问Activity啦！！！
DA的配置文件
DA框架的“动态可变性”体现在配置文件上，DA框架遵循“约定优于配置”的原则，使用更少的配置达到目的。配置文件非常简单，仅包含scheme以及包名的映射关系。
配置文件示例：
<?xml version="1.0" encoding="UTF-8"?>
<DynamicAction xmlns:opencdk="http://www.opencdk.com/dynamicaction"
opencdk:version="1.0.0" >
<constant name="DA.devMode" value="true" />
<constant name="DA.scheme" value="opencdk" />
<constant name="DA.appscheme" value="opencdkexample" />
<package id="0" name="com.opencdk.da.ui" >
</package>
<package id="1" name="com.opencdk.da.ui.user" >
</package>
<package id="2" name="com.opencdk.da.ui.video" >
<!-- 用H5登录界面来修复有BUG的原生登录 -->
<action name="Login" from="home_login_click" to="0$Browser?title=H5登录&url=http://www.opencdk.com/login.html" />
</package>
</DynamicAction>
参数说明：
- DA.devMode：开发模式，开关打开后，后台将可看到更多日志
- DA.scheme：DA框架内部使用的scheme，建议根据自己的业务定义唯一的scheme
- DA.appscheme：非DA框架直接使用，是App提供给第三方App的scheme
- package：包名的映射关系，文章最后有完整配置
- package>id：包id，与包名一一对应
- package>name：包名
- action：动态修复的Action
- action>name：Action的名称
- action>from：事件源，触发此事件的源头
- action>to：目标地址(DA框架标准的URI数据结构)
- action>to>title：Activity标题
- action>to>url：网址
DA的代码实现
假设在com.opencdk.da.ui包下有LoginActivity，访问的scheme可表示为：
opencdk://1$Login
使用DA框架后，启动LoginActivity则变得非常容易：
new DA.Builder(Context)
.setHost("1$Login")
.go();
或：
new DA.Builder(Context)
.setUriString("opencdk://1$Login")
.go();
或：
new DA.Builder(Context)
.setPackageId("1")
.setActionName("Login")
.go();
非常简单的实现方式，为动态运营奠定了基础。基于DA框架，开发同学可以轻松构建项目规范，编写更优雅的代码；测试同学编写测试用例也变得更容易了。
DA的数据交互
DA框架不但支持原生Activity间的数据交互，而且也支持Activity与H5间的数据交互。保证数据协议的一致性，DA框架统一使用JSON进行数据交互（推荐使用fastjson）。
URI表示如下：
opencdk://1$Login?data={"username":"benniaobuguai"}
代码调用：
new DA.Builder(Context)
.setHost("1$Login")
.setData("{\"username\":\"benniaobuguai\"}")
.go();
DA支持Activity回调(Context.startActivityForResult)
URI表示如下：
opencdk://1$Login?data={"username":"benniaobuguai"}&requestCode=10000
代码调用：
new DA.Builder(Context)
.setHost("1$Login")
.setData("{\"username\":\"benniaobuguai\"}")
.setRequestCode(10000)
.go();
PS： 建议在Activity间交互时使用事件总线，如：EventBus，otto等。
DA动态修改默认跳转
- 用一个Activity替换另外一个Activity
<package id="2" name="com.opencdk.da.ui.video" >
<!--- 随机推荐视频列表界面修改成免费视频列表界面 -->
<action name="VideoRandomList" from="home_video_random_click" to="2$VideoFreeList" />
</package>
- 用一个H5界面替换一个Activity
<package id="2" name="com.opencdk.da.ui.video" >
<!-- 随机推荐视频列表界面修改成H5的免费视频推荐界面 -->
<action name="VideoRandomList" from="home_video_random_click" to="0$Browser?title=精彩免费视频推荐&url=http%3a%2f%2fwww.iqiyi.com%2fdianying%2ffree.html" />
</package>
注意：
- xml文件不支持直接使用&、<、>等特殊字符，应该使用其对应的转义字符。具体可参考：XML和HTML常用转义字符
- url地址需要进行URL编码，避免特殊字符对URI的解析造成影响。在线URL编码
DA启用拦截器功能
往往有些时候，我们需要对某些界面进行访问控制。
已经发布的版本，任何用户都可访问VIP视频列表。临时需求变更，只有登录的用户才能访问VIP视频列表界面，可修改配置下发：
<interceptors>
<interceptor
name="LoginInterceptor"
class="com.opencdk.da.interceptor.LoginInterceptor" >
</interceptor>
<interceptor
name="TestInterceptor"
class="com.opencdk.da.interceptor.TestInterceptor" >
</interceptor>
<actionInterceptor>
<accept name="2$VideoVIPList" >
<interceptor-ref>LoginInterceptor</interceptor-ref>
</accept>
</actionInterceptor>
</interceptors>
H5与原生程序的交互
引入DA框架后，在H5界面也可前往任意的原生界面，代码也非常简单。
H5代码片断：
<p><a href="opencdk://1$Login">Login</a></p>
<p><a href="opencdk://2$VideoPlay">Play Video</a></p>
<p><a href="opencdk://0$Browser?url=http://www.opencdk.com">http://www.opencdk.com</a></p>
重写WebView WebViewClient的方法shouldOverrideUrlLoading(WebView view, String url)，支持自定义的scheme。
mWebView.setWebViewClient(new WebViewClient() {
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
if (url != null && url.startsWith(DALoader.getScheme())) {
new DA.Builder(mContext)
.setUriString(url)
.go();
return true;
}
return super.shouldOverrideUrlLoading(view, url);
}
});
DA框架解决的核心问题
- 一个地址可达任意Activity
- 任意一个Activity可被动态修改为另一个Activity
- DA框架数据交互扁平化，使用JSON便于与H5交互
- 任意Activity可替换成H5，快速修复原生突发BUG
- 插件化项目中也能满足以上需求
DA框架所遵循的一些约定
DA框架默认遵循以下规则：
- 配置优先级>Java代码优先级，保证通过配置可修复代码编码的缺陷。
- 查找动态配置时，先根据name+from进行精确查找，其次根据name去查找。
示例说明
为了更好地体现动态Action，示例中在assets目录下放了多个配置文件，加载不同的配置文件就相当于网络下发了新的配置文件。
- dynamic_action.cfg，默认的配置文件，仅包含包结构映射关系
- dynamic_action_transfer.cfg，配置一个动态Action
- dynamic_action_interceptor.cfg，配置一个拦截器
进阶与思考
- 客户端与客户端交互
客户端与客户端之间的交互是不安全的，对于暴露给第三方的入口都需要进行校验。就DA框架而言，主要是为了解决内部跳转的统一协议而确定的scheme(opencdk://)，提供外部使用的scheme(opencdkexample://)。opencdk://仅供内部使用，认为是可信任的、安全的。opencdkexample://是外部协议，必须经过校验方可拉起我们的客户端。
需要提供外部入口，必须要在AndroidManifest.xml里面定义，
<activity
android:name="com.opencdk.da.ui.SplashActivity"
android:exported="true"
android:label="@string/app_name"
android:theme="@style/DA.Theme.NoTitleBar" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<!-- 定义给外部调用 的scheme -->
<data android:scheme="opencdkexample" />
</intent-filter>
</activity>
新建一个项目，执行外部调用代码片断：
Intent intent = new Intent();
intent.setAction(Intent.ACTION_VIEW);
intent.addCategory(Intent.CATEGORY_DEFAULT);
Uri data = Uri.parse("opencdkexample://0$Browser?url=http://v.qq.com/cover/r/rm3tmmat4li8uul/w0019k37ecc.html");
intent.setData(data);
startActivity(intent);
- iOS对本协议的支持
iOS并无包名概念，如果希望使用同一个URI来跳转至同一个界面，iOS在对URI的处理时，应当直接过滤包名后再使用。
登录配置如下：
opencdk://1$Login?data={"username":"benniaobuguai"}
解析【host】协议时，直接取【ActionName】，忽略前面的 "1$" 即可。
- 对于简单的项目，Android把所有Activity放在一个包名下(不建议这么做)，也可与iOS保持URI同一处理逻辑。
URI表示如下：
opencdk://Login?data={"username":"benniaobuguai"}
PS： DA框架当前不支持无包名的实现方式。
注意点
- 避免循环对Action进行中转
- 通过反射访问目标Activity，ActionName的大小写敏感
- 避免过多的包名映射，Activity所在的包不宜过多，包越多维护成本越大。
- Activity不能被混淆
其他
- 运营的灵活性，增强运营配置的自由度
- 界面可替换性，任意Activity可替换成H5，提供快速使用H5修复BUG的能力
- 插件访问简单化，宿主程序是无法直接获取插件的Activity对象，DA框架的作用尤其明显。
- DA框架最大的问题是全局可访问任意Activity，如何保证被访问者的安全，业务不受到影响就显示尤为重要了
- DA框架与传统的Context.startActivity最大的区别在于：交互协议标准化、灵活、运营能力强，动态修复能力强
Q&A：
1.为什么需要制定两个scheme?
答：隔离
2.配置from to过多时, 性能如何?
答：配置from和to时，属于修复BUG的行为，原则上并不会太多。通过HashMap查找，速度很快。
3.配置文件过大时, 性能如何?
答：未验证。
完整的配置文件
<?xml version="1.0" encoding="UTF-8"?>
<DynamicAction xmlns:opencdk="http://www.opencdk.com/dynamicaction"
opencdk:version="1.0.0" >
<constant name="DA.devMode" value="true" />
<constant name="DA.scheme" value="opencdk" />
<constant name="DA.appscheme" value="opencdkexample" />
<package id="0" name="com.opencdk.da.ui" >
</package>
<package id="1" name="com.opencdk.da.ui.user" >
</package>
<package id="2" name="com.opencdk.da.ui.video" >
<action name="VideoRandomList" from="home_video_random_click" to="2$VideoFreeList" />
</package>
<interceptors>
<interceptor
name="LoginInterceptor"
class="com.opencdk.da.interceptor.LoginInterceptor" >
</interceptor>
<interceptor
name="TestInterceptor"
class="com.opencdk.da.interceptor.TestInterceptor" >
</interceptor>
<actionInterceptor>
<accept name="2$VideoVIPList" >
<interceptor-ref>LoginInterceptor</interceptor-ref>
</accept>
</actionInterceptor>
</interceptors>
</DynamicAction>
