1.首先:在安装phoneGap开发环境之前,需要安装以下框架
4.ADT Plugin (SDK和Gap安装完成重启eclipse)
2.创建PhoneGap项目
1.新建一个Android project(名字随意取);
2.在你新建的目录下,新建两个子目录/libs和/assets/www
3.进入将刚刚下载并解压的PhoneGap包里Anroid目录,我们需要的资源都在这个目录下。
将phonegap-x.x.x.js这个js文件(具体名称视当时下载的版本而定)copy到/assets/www目录下,
把phonegap.jar文件copy到/libs目录下。
再把xml目录copy到android项目的res目录下。
4.在/assets/www下建立index.html文件,内容看起来像这样:
<!DOCTYPE HTML> <html> <head> <title>PhoneGap</title> <script type="text/javascript" charset="utf-8" src="phonegap-x.x.x.js"></script> </head> <body> <h1>Hello World</h1> </body> </html>
5.将以下权限配置的xml内容copy到AndroidManifest.xml文件中:
<supports-screens android:largeScreens="true" android:normalScreens="true" android:smallScreens="true" android:resizeable="true" android:anyDensity="true" /> <uses-permission android:name="android.permission.CAMERA" /> <uses-permission android:name="android.permission.VIBRATE" /> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.RECEIVE_SMS" /> <uses-permission android:name="android.permission.RECORD_AUDIO" /> <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" /> <uses-permission android:name="android.permission.READ_CONTACTS" /> <uses-permission android:name="android.permission.WRITE_CONTACTS" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.GET_ACCOUNTS" />
6.将以下内容添加到AndroidManifest.xml文件的activity标签中:
android:configChanges="orientation|keyboardHidden
7.AndroidManifest.xml最后看起来会像这样:
8.在刚刚新建的Android Project中找到libs目录并在phonegap-x.x.x.jar上点击右键,选择 Build Path->Add to Build Path
9.最后再修改下src下的Java主文件:
1添加import com.phonegap.*;
2将类改成继承为DroidGap;
3删掉import android.app.Activity;
4把setContentView()这行替换为super.loadUrl("file:///android_asset/www/index.html");
5最后看起来就像这样:就可以试着运行一下,成功的话会出现Hello World的界面。
3.PhoneGap Plugin
PhoneGap的插件机制其实就是一个android类导出为jar文件,然后再被PhoneGap的项目引用,再通过js来调API:
1.创建一个Android Project;
2.打开Java主文件,将继承的类改为Plugin;
3.引入以下类:
import com.phonegap.api.Plugin; import com.phonegap.api.PluginResult; import com.phonegap.api.PluginResult.Status;
4.重写父类的execute方法:
public PluginResult execute(String action, JSONArray data, String callbackId) { PluginResult pr=null; if(action.equals("method1")){ pr=new PluginResult(Status.IO_EXCEPTION,"method1"); }else if(action.equals("method2")){ pr=new PluginResult(Status.OK,"method2"); } return pr; }
其中,第一个参数action可以作为分类调用时的类型,我们就可以用该参数来实现多方法功能。
返回的PluginResult实例可以通过状态Status类型的控制来描述当前结果的执行状态。
最后,代码看起来可能像这样:
5.将该类导出为jar(在类文件上右键->Export->JAR File)
6.回到之前创建的PhoneGap项目中,按上面添加jar包的方法再将该jar添加到工程中。
7.在/res/xml/plugins.xml文件中添加以下内容:
<plugin name="PluginTest" value="aralork.moblie.plugin.PluginTest"/> name 是你调用时要使用的类名,value是类在jar包中的全路径
8.最后再打开assets/www/index.html文件,写入类似于这样的内容:
<script type="text/javascript" charset="utf-8" src="phonegap-x.x.x.js"></script> <script type="text/javascript"> PhoneGap.exec(successCallback, //成功后的回调方法 failureCallback, //失败后的回调方法 ‘PluginTest‘,//刚才配置的类名 ‘method1‘, //方法名称,就是之前提到的action参数 ["/sdcard"]); //sdcard路径 function successCallback(data){ alert("data:"+data); } function failureCallback(data){ alert("error:"+data); } </script>