H5唤起原生app,Android端的实现思路

    通过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做如下配置:

<activity android:name=".ui.activity.RouterActivity"
    android:theme="@android:style/Theme.Translucent">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="gdxxw" />
    </intent-filter>
</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 android:name=".ui.activity.RouterActivity"
    android:theme="@android:style/Theme.Translucent">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="gdxxw" />
    </intent-filter>
</activity>

    目标activity的返回遇到上述所的两种情况,此处就需要分析判断到底属于那种情况。我们可以利用管理/维护activity的一个类(AppManager)来做判断,这个类在每打开一个activity就把它放到栈中,每销毁一个activity就从栈中移除,我们也可以从栈中知道栈顶,栈底是哪一个activity。

-----------------------------------code----------------------------

public class AppManager {

    // Activity栈
    private static Stack<Activity> activityStack;
    // 单例模式
    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<Activity>();
        }
        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~~~

   

猜你喜欢

转载自blog.csdn.net/xiayuexingkong/article/details/89531877