通过H5唤起原生应用是一个常见的需求,可以实现引流的作用,而且原生页面的体验一般要比H5体验性好些。
URL scheme这种唤端媒介是一个比较妥当的实现H5唤起原生应用的方式。
1 app端的需求
H5唤起app,是要打开指定页面的。对于app打开指定页面后的返回处理有两种情况:
(1)app之前未启动;(2)app在系统任务组中,处于后台存活状态。
对于第一种情况,返回处理需要出现闪屏页,然后到main页面;对于第二中情况返回处理是要返回到上一次停留的页面。
2 URL scheme与URL其他部分的交互约定
对于URL scheme的概念本文不做详细介绍,可参考
https://juejin.im/post/5b7efb2ee51d45388b6af96c
https://www.jianshu.com/p/978238edcb9f
我们对URL scheme以及URI的其他部分做如下规定:
scheme部分标识app;host结合path部分标识目标页面(activity);query部分是目标页面需要的业务数据。
3 实施细节分析
3.1 我们可以通过在Manifest文件对于目标activity做如下配置:
其中"intent-filter"部分是必须的配置项,data节点的scheme属性就是约定中的标识app的部分。这样就可以利用Android系统的内置支持实现H5打开指定的activity。
3.2 解析H5传递过来的URI
在RouterActivity的onCreate方法(onNewIntent方法)中解析URI
Intent intent = getIntent();
Uri uri = intent.getData();
String host = uri.getHost();
String courseId = uri.getQueryParameter("courseId");
String path = uri.getPath();
-----------code---------------------------------------------------------------------------
RouterActivity.java部分代码
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); Intent intent = getIntent(); Uri uri = intent.getData(); if (null != uri) { String host = uri.getHost(); if (!TextUtils.isEmpty(host)) { finish(); Activity activity = AppManager.getAppManager().currentActivity(); switch (host) { case "course": String courseId = uri.getQueryParameter("courseid"); String path = uri.getPath(); LogUtil.e("RouterActivity", "path:" + path); if (TextUtils.equals("/detail", path)) { if (null != activity) { CourseDetailsActivity.openCourseDetail(activity, courseId, 1); }else { CourseDetailsActivity.openCourseDetail(this, courseId, 1); } }else if (TextUtils.equals("/mianshoudetail", path)) { if (null != activity) { CourseDetailsActivity2.openCourseDetails(activity, courseId); }else { CourseDetailsActivity2.openCourseDetails(this, courseId); } } break; } } } }
-----------code---------------------------------------------------------------
3.3 目标activity的返回处理分析
笔者在开发前期是直接在目标activity配置对应的scheme,host和path部分来标识activity的唯一性,从而直接打开该activity的。但是在返回的时候总是返回到h5页面,并未停留在app页面。思来想去应该是该activity的打开方式有关。所以采用一个过渡的activity通过常见的intent去打开目标activity,这样就需要过渡中转的RouterActivity在解析host,path和query部分之后,分别打开对应的目标activity并向下传递对应的业务数据。同时这个RouterActivity需要是透明的。
RouterActivity在manifest文件的配置
目标activity的返回遇到上述所的两种情况,此处就需要分析判断到底属于那种情况。我们可以利用管理/维护activity的一个类(AppManager)来做判断,这个类在每打开一个activity就把它放到栈中,每销毁一个activity就从栈中移除,我们也可以从栈中知道栈顶,栈底是哪一个activity。
-----------------------------------code----------------------------
public class AppManager { // Activity栈 private static StackactivityStack; // 单例模式 private static AppManager instance; private AppManager() { } /** * 单一实例 */ public static AppManager getAppManager() { if (instance == null) { instance = new AppManager(); } return instance; } /** * 添加Activity到堆栈 */ public void addActivity(Activity activity) { if (activityStack == null) { activityStack = new Stack (); } activityStack.add(activity); } /** * 获取当前Activity(堆栈中最后一个压入的) */ public Activity currentActivity() { if (activityStack == null) { return null; } Activity activity = activityStack.lastElement(); return activity; } /** * 结束当前Activity(堆栈中最后一个压入的) */ public void finishActivity() { Activity activity = activityStack.lastElement(); finishActivity(activity); } /** * 结束指定的Activity */ public void finishActivity(Activity activity) { if (activity != null) { activityStack.remove(activity); activity.finish(); activity = null; } } /** * 结束指定类名的Activity */ public void finishActivity(Class> cls) { for (Activity activity : activityStack) { if (activity.getClass().equals(cls)) { finishActivity(activity); break; } } } /** * 结束所有Activity */ public void finishAllActivity() { for (int i = 0; i < activityStack.size(); i++) { if (null != activityStack.get(i)) { activityStack.get(i).finish(); } } activityStack.clear(); } public int getActivityCount() { if (activityStack == null) return 0; return activityStack.size(); } public Activity getSomeActivity(int index) { if (activityStack == null || activityStack.isEmpty()) return null; if (index >= activityStack.size()) return null; return activityStack.get(index); } /** * 退出应用程序 */ public void AppExit(Context context) { try { finishAllActivity(); //退出程序 android.os.Process.killProcess(android.os.Process.myPid()); System.exit(1); } catch (Exception e) { } } }
-----------------------------------code---------------------------
我们就可以利用AppManager中的activityStack判断app的启动情况。
在目标acitity返回时候做如下处理
---------------------------------code------------------------------
目标Acitiviyt部分代码
@Override public void onBackPressed() { int activityCount = AppManager.getAppManager().getActivityCount(); if (activityCount <= 1) { mContext.startActivity(new Intent(mContext, SplashActivity.class)); } super.onBackPressed(); }
---------------------------------code------------------------------
这是我在项目开发中对这种需求下Android端处理方案的总结分析。the end~~~