phonegap底层原理学习和研究(三)

爱技术爱生活TAO

2012-06-12

针对Phonegap开发中常用的DroidGap类继承自PhonegapActivity，PhonegapActivity继承自Activity。源代码如下：

/*
 * PhoneGap is available under *either* the terms of the modified BSD license *or* the
 * MIT License (2008). See http://opensource.org/licenses/alphabetical for full text.
 * 
 * Copyright (c) 2005-2010, Nitobi Software Inc.
 * Copyright (c) 2010, IBM Corporation
 */
package com.phonegap.api;

import android.app.Activity;
import android.content.Intent;

/**
 * The Phonegap activity abstract class that is extended by DroidGap.
 * It is used to isolate plugin development, and remove dependency on entire Phonegap library.
 */
public abstract class PhonegapActivity extends Activity {

    /**
     * Add a class that implements a service.
     * 
     * @param serviceType
     * @param className
     */
    abstract public void addService(String serviceType, String className);
    
    /**
     * Send JavaScript statement back to JavaScript.
     * 
     * @param message
     */
    abstract public void sendJavascript(String statement);

    /**
     * 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(IPlugin 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(IPlugin plugin);

    /**
     * Load the specified URL in the PhoneGap webview.
     * 
     * @param url				The URL to load.
     */
    abstract public void loadUrl(String url);
}

在使用这个类启动Webapp移动项目时候可以配置许多东西，如下：

This class is the main Android activity that represents the PhoneGap
application.  It should be extended by the user to load the specific
html file that contains the application.

As an example:

    package com.phonegap.examples;
    import android.app.Activity;
    import android.os.Bundle;
    import com.phonegap.*;
    
    public class Examples extends DroidGap {
      @Override
      public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
                 
        // Set properties for activity
        super.setStringProperty("loadingDialog", "Title,Message"); // show loading dialog
        super.setStringProperty("errorUrl", "file:///android_asset/www/error.html"); // if error loading file in super.loadUrl().

        // Initialize activity
        super.init();
        
        // Clear cache if you want
        super.appView.clearCache(true);
        
        // Load your application
        super.setIntegerProperty("splashscreen", R.drawable.splash); // load splash.jpg image from the resource drawable directory
        super.loadUrl("file:///android_asset/www/index.html", 3000); // show splash screen 3 sec before loading app
      }
    }

DroidGap中可以配置的属性如下：

Properties: The application can be configured using the following properties:

//加载时候加载对话框的信息

//Displayanativeloadingdialogwhenloadingapp.Formatforvalue="Title,Message".

//(String-default=null)

super.setStringProperty("loadingDialog","Wait,LoadingDemo...");

//加载对话对话框

//Displayanativeloadingdialogwhenloadingsub-pages.Formatforvalue="Title,Message".

//(String-default=null)

super.setStringProperty("loadingPageDialog","Loadingpage...");

//Causealllinksonwebpagetobeloadedintoexistingwebview,

//insteadofbeingloadedintonewbrowser.(Boolean-default=false)