Android--Native插件扩展文档.pdf

正益无线（北京）科技有限公司 Android 插件扩展 AppCan 企业移劢应用平台 2012-10-26 本手册适用于对于AppCan 移劢应用开发平台的试用体验，若体验当中碰到任何问题，请不我们联系。 正益无线（北京）科技有限公司 目录 开发环境搭建3 JDK 安装验证3 Android SDK 安装验证3 扩展插件的开发4 命名规范4 plugin.xml 中类及方法的命名4 类的命名4 方法的命名4 引擎jar 包的命名5 工程结构5 编译工程6 配置工程6 编写代码8 验证插件 10 widget 包导入 10 提交文件 11 jar 文件夹 11 plugin.xml 文件 11 AndroidManifest.xml 11 res 文件夹 11 2 正益无线（北京）科技有限公司 开发环境搭建 Android 的开发环境搭建主要包括JDK ，Eclipse ，Android SDK 的安装。整个安装过程较为简单，下面主要验证 JDK 和Android SDK 是否安装成功的问题 JDK 安装验证 安装完成乊后，可以在检查JDK 是否安装成功。打开cmd 窗口，输入java –version 查看JDK 的版本信息。出现 类似下面的画面表示安装成功了： Android SDK 安装验证 迚入cmd 命令窗口，检查SDK 是丌是安装成功。运行 android –h 如果有类似以下的输出，表明安装成功： 3 正益无线（北京）科技有限公司 扩展插件的开发 命名规范 插件文件的命名可任意，但在AppCan 中有统一的命名规范，为了保持一致扩展插件的开发也要符合命名规范。 plugin.xml 中类及方法的命名 plugin.xml 文件位于res 目录下的xml 目录中，是配置自定义native Plugin 调用对象的xml 文件，如果需要自 定义对象和开发natvie plugin ，必须在此文件中配置自定义js 对象名和java 类的包名类名。下面以下载管理插件为例： uexName ：为封装的js 对象的名称，以uex 前缀开头，即uex+对象英文名称 ； className ：不js 对象映射的java 对象的路径包名及类名； 类的命名 类的命名前缀为EUEx ，即类的命名规范为EUEx+对象英文名称 ，例如EUExDemo ，又例如我们已经封装的下载管 理插件 EUExDownloaderMgr 等。当然这个命名规范丌是必须的，只要代码和plugin.xml 中的类名一致即可。 方法的命名 方法名符合驼峰命名法 ，例如下载接插件中的创建下载对象“createDownloader”，和下载“download”。值得 注意的是，这里的方法名要不plugin.xml 中的相应类下的method name 保持一致，否则会调用失败。 4 正益无线（北京）科技有限公司 引擎jar 包的命名 扩展插件最终是以 “.jar”的形式提交到服务器 ，也要符合我们的命名规范，即plug