Cordova Android源码分析系列一（项目总览和CordovaActivity分析）

标签：phonegap   cordova   hybrid app   android   

       cordova3.5版本Android核心框架一共有27个java文件，代码量不算大。从cordova3.0版本以后，所有的设备能力API都从cordova核心框架分离出去，变成了插件，各平台分别进行原生实现，例如访问设备信息的Device插件，访问网络状态的Network Information插件，目前官方网站一共收录了250个插件。下面是 Cordova Android的整体UML类图，从这张图上我们看出核心框架和插件之间的关系，插件需要实现CordovaPlugin接口。

Cordova框架类图

• CordovaInterface接口分析

           CordovaInterface是Cordova应用的底层接口，CordovaActivity需要实现这个接口。用来隔离Cordova插件开发，隔离插件对Cordova核心库的直接依赖。

   主要方法有startActivityForResult，setActivityResultCallback，getActivity，onMessage，getThreadPool这几个接口方法。具体的实现在CordovaActivity中。

/**
 * The Activity interface that is implemented by CordovaActivity.
 * It is used to isolate plugin development, and remove dependency on entire Cordova library.
 */
public interface CordovaInterface {

    /**
     * Launch an activity for which you would like a result when it finished. When this activity exits,
     * your onActivityResult() method will be called.
     *
     * @param command     The command object
     * @param intent      The intent to start
     * @param requestCode   The request code that is passed to callback to identify the activity
     */
    abstract public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode);

    /**
     * Set the plugin to be called when a sub-activity exits.
     *
     * @param plugin      The plugin on which onActivityResult is to be called
     */
    abstract public void setActivityResultCallback(CordovaPlugin plugin);

    /**
     * Get the Android activity.
     *
     * @return the Activity
     */
    public abstract Activity getActivity();
    

    /**
     * Called when a message is sent to plugin.
     *
     * @param id            The message id
     * @param data          The message data
     * @return              Object or null
     */
    public Object onMessage(String id, Object data);
    
    /**
     * Returns a shared thread pool that can be used for background tasks.
     */
    public ExecutorService getThreadPool();
}

• CordovaActivity核心类分析

       CordovaActivity是Cordova应用的入口类，用户用来加载html页面的Activity需要继承这个Activity。CordovaActivity会读取Cordova配置文件res/xml/config.xml中的配置。

       CordovaActivity继承了Android Activity，实现了CordovaInterface接口。

       比较重要的成员变量有CordovaWebView appView，CordovaWebViewClient webViewClient，用Executors.newCachedThreadPool()初始化了一个线程池threadPool，创建了Activity返回时的回掉插件activityResultCallback，还有就是启动画面splashscreen的一些变量等。CordovaActivity继承了Activity，因此的它的生命周期和Activity一样，我们可以按照Activity生命周期的顺序开始看代码。

     首先看OnCreate方法，首先调用了Config.init(this)方法，读取config.xml文件初始化配置，看Config.java的源码可以知道，该方法主要初始化了url白名单，背景颜色，是否全屏，载入页面超时时间（默认20s），启动画面延时（默认3s）等。然后是读取Intent Extra中等一些参数，设置是否显示标题，是否全屏等。接下来是读取屏幕宽度和高度，创建一个LinearLayoutSoftKeyboardDetect。LinearLayoutSoftKeyboardDetect这个类是用来检测软键盘是否弹出的，主要是重写了onMeasure方法，当软键盘弹出，高度发生变化时发送 app.appView.sendJavascript(“cordova.fireDocumentEvent(‘hidekeyboard’);")事件。我们自己的cordova应用在重新onCreate方法时会依次调用下面的方法。 

        super.onCreate(savedInstanceState);
        super.init();
        // Set by <content src="index.html" /> in config.xml
        super.loadUrl(Config.getStartUrl());

 CordovaActivity类UML图

        onResume方法首先重新调用了Config.init(this)方法，然后判断是否是第一次启动，如果是则直接返回，否则会调用appView.handleResume方法，该方法会触发javascript事件cordova.fireDocumentEvent(‘resume’)，并通知pluginManager，最后进行计数。

       onPause方法比较简单，当appView不为空时调用appView.handlePause方法，然后去掉启动画面SplashScreen。

       onDestroy，onNewIntent，postMessage，sendJavascript，showWebPage方法的实现也和onPause方法类似，都是调用了appView的相关方法。

      方法addService(String serviceType, String className) 用来添加Service，这个方法已经降级了，以后应该在res/xml/plugins.xml文件添加。

      startActivityForResult方法首先给回调对象activityResultCallback赋值，设置activityResultKeepRunning，最后调用Activity的startActivityForResult方法。

      onActivityResult方法当启动的Activity返回结果时会被调用。首先调用了Activity的onActivityResult方法获得数据，接着调用mUploadMessage.onReceiveValue(result)，最后通过调用activityResultCallback的onActivityResult方法，通知Cordova插件。

       onReceivedError方法负责当发生不可恢复的错误时，显示预定义的出错页面或错误信息。不可恢复的错误是指例如主要资源文件不可用等。如果配置了错误页面，会在UI线程停止进度条，调用appView.showWebPage方法显示错误页面，否则调用displayError方法弹出错误描述对话框。

      onCreateOptionsMenu，onPrepareOptionsMenu，onOptionsItemSelected这几个方法类似，都是先调用postMessage发送对应的事件，然后调用父类Activity的对应方法。

      onKeyUp和onKeyDown方法都是先调用appView的相关方法，然后调用Activity的相关方法。

      本系列第一篇文章先这样吧，明天下篇文章分析CordovaResourceApi，CordovaWebView，CordovaWebViewClient等几个类。

Cordova Android源码分析系列一（项目总览和CordovaActivity分析）,布布扣,bubuko.com

Cordova Android源码分析系列一（项目总览和CordovaActivity分析）

标签：phonegap   cordova   hybrid app   android   

原文地址：http://blog.csdn.net/offbye/article/details/31776833