基于Cordova的android项目入门

本文记录在ecplise里建立一个基于Cordova的android项目的基本步骤。

准备工作：

1、cordova-3.4.0.jar （下载地址 http://download.csdn.net/detail/findsafety/9275291）

2、cordova.js

3、发开android的eclipse的环境。Android SDK、ADT Plugin

开始建立项目

1、打开Eclipse，选择文件->新建->Android Project。与建立原生的android项目一样的步骤。

 

2、把cordova-3.4.0.jar复制到libs目录下面，如果没有libs目录就创建。

3、在asset目录下创建www文件夹，把cordova.js复制到www目录下面。（http://download.csdn.net/detail/findsafety/9277263）

4、从下载的包里面复制xml文件夹到res目录下面。xml文件夹里面有文件config.xml。内容如下，有一些个人信息，改不改都可以。

按 Ctrl+C 复制代码

        id        = "io.cordova.helloCordova"
        version   = "2.0.0">
    Hello Cordova


   
        A sample Apache Cordova application that responds to the deviceready event.
   


   
        Apache Cordova Team
   


   


   
   


   


   
   
   


   
       
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
   
     
   
         

现在项目需要添加的文件已经添加了，如下图。

5、接下来，在 assets/www 文件夹下创建一个名为 index.html 的文件。此文件将用作 Cordova 应用程序界面的主要入口点。文件主要是测试，可参考如下内容

   

Hello Cordova

 

注意：文件名要与config.xml里面设置的文件名一致。config.xml设置的代码。

<content src="index.html" />

6、需要将 cordova-3.0.0.jar 库添加到该 Android 项目的构建路径。对文件cordova-3.0.0.jar右键-->Build Path-->Add to Build Path。

 

7、修改Activity类。

-添加以下导入语句

import org.apache.cordova.DroidGap;

-将基类从 Activity 更改为DroidGap ；它位于类定义中 extends 一词的后面

public class MainActivity extends DroidGap

-用本地 assets/www/index.html 文件加载 Cordova 界面的引用替换setContentView() 调用函数

super.loadUrl("file:///android_asset/www/index.html");

修改之后如下图

8、配置项目元数据，修改AndroidManifest.xml

-添加以下supports-screen XML 节点作为 manifest 根节点的子节点

<supports-screens
    android:largeScreens="true"
    android:normalScreens="true"
    android:smallScreens="true"
    android:resizeable="true"
    android:anyDensity="true"
    />

supports-screen 节点可识别您应用程序支持的屏幕大小。您可以通过更改此条目的内容来调整屏幕和外观设置支持。要阅读有关,的更多信息，请访问 Android 开发人员主题 – 支持屏幕元素。

-为 Cordova 应用程序配置权限，复制以下 XML 节点，并粘贴它们作为 AndroidManifest.xml 文件 根节点的子节点。

<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" />
<uses-permission android:name="android.permission.BROADCAST_STICKY" />

XML 值可识别您要为应用程序启用的功能。上述代码行可启用 PhoneGap 所有功能正常运行所需的全部权限。构建完应用程序后，您可能希望删除不会实际用到的所有权限；这将会删除应用程序安装过程中出现的安全警告。要阅读有关 Android 权限和  元素的更多信息，请访问 Android 开发人员主题 – 用户权限元素。

-修改现有的  代码。找到节点，它是 XML 节点的子节点。将下面的属性添加到该 节点：

configChanges="orientation|keyboardHidden"

-为 org.apache.cordova.DroidGap 类创建一个  节点。添加下面的 节点作为现有  XML 节点的同级节点。

<activity 
    android:name="org.apache.cordova.DroidGap" 
    android:label="@string/app_name" 
    android:configChanges="orientation|keyboardHidden"> 
    <intent-filter>intent-filter> 
activity>

此时，已将您的项目配置为作为 Android PhoneGap 项目运行。

9、按一般android项目运行即可。

 

当使用CLI方式建立一个项目的时候，会生成一个名字为MainActivity-CordovaLib的项目，在运行后其bin文件夹会生成一个jar包，此jar包即为步骤1中所使用到的jar包