Android下编译自己的库文件jar并在应用中调用
2010年09月28日 星期二 下午 02:46
主要为了解决如下问题:
项目中使用了Android未公开的API,在Eclipse下会有红叉显示。 不同的项目抽出相同部分的代码共用。 必需的前提条件: 需要有Android源代码,编译的库文件主要是封装未公开API或者共用代码。 工程1:Java库文件工程 该工程最终会生成以jar结尾的Java库文件,并会被安装到设备的以下目录: /system/framework/ 另外还会安装相关库文件的说明文件,使系统能够找到库文件: /system/etc/permissions/ 1、建立工程 在Eclipse下新建一个空的Java工程。 在工程的 Java Build Path -> Libraries 下,导入Android的SDK中的 android.jar 库。 为工程创建相应的包和java文件。 下面假设包路径为 com.mytest.lib,最终生成的库为 mylib.jar。 2、为工程添加注册文件 在库文件工程的根目录下创建以下文件: <permission xml file name>.xml 该文件是用来向系统注册库用的,名称可以自己定,在下面假设该文件为 mylibxml.xml。 在文件中加入以下内容: <?xml version="1.0" encoding="UTF-8"?> <permissions> <library name="com.mytest.lib" file="/system/framework/mylib.jar" /> </permissions> 其中的 library 用于将其下的 name 和 file 两个属性关联起来,name 的值后边会用到。 这里的 name 指定为工程的包名。 这里的 file 指定为库文件的存放路径,应该是: /system/framework/<jar file name>.jar 3、为工程添加makefile文件: 在库文件工程的根目录下创建以下文件: Android.mk 该文件是用来编译工程的,名称固定。 在文件中加入以下内容: LOCAL_PATH:= $(call my-dir) #MAKE_JAR include $(CLEAR_VARS) LOCAL_SRC_FILES := $(call all-subdir-java-files) LOCAL_MODULE := mylib include $(BUILD_JAVA_LIBRARY) #MAKE_XML include $(CLEAR_VARS) LOCAL_MODULE := mylibxml.xml LOCAL_MODULE_CLASS := ETC LOCAL_MODULE_PATH := $(TARGET_OUT_ETC)/permissions LOCAL_SRC_FILES := $(LOCAL_MODULE) include $(BUILD_PREBUILT) 其中,MAKE_JAR 部分的 LOCAL_MODULE 部分指定为想要生成的库文件的名字, 需要与 .xml 文件中的 library 下的 file 部分一致。 其中,MAKE_XML 部分的 LOCAL_MODULE 部分指定为用于注册库的 .xml 文件。 4、生成应用程序可用的库文件 此时的工程,如果使用了未公开的API的话,在eclipse下应该是有红叉的。 这些错误不用管,只需要保证程序在Android的源码下能够编译通过即可。 将工程的java文件以及 .xml 和 .mk 按照目录结构拷贝到以下目录: <Android source folder>/packages/apps/<project name>/ 运行以下命令: $ cd <Android source folder> $ . ./build/envsetup.sh $ mmm packages/apps/<project name> 将会生成一个 .jar 文件和一个 .xml 文件。 以上两个文件是应用程序在运行时需要用到的。 调试应用前,需要将两个文件拷贝到设备的相应目录上去: .jar 文件:/system/framework/ .xml 文件:/system/etc/permissions/ 拷贝到设备使用以下命令: $ sudo adb push <.jar or .xml file path> <path in device> 拷贝完以后需要重启设备。 5、生成在Eclipse可以引用的库文件 在源码下编译的 .jar 文件在Eclipse中是不能使用的,需要单独生成。 在Eclipse下选中工程根目录,选择文件菜单中的导出Export,然后选择jar类型。 导出为jar文件时,只需要选中相应的java文件即可。 这样生成的jar文件仅仅供应用程序在Eclipse下使用,除非是以下情况: 库文件没有使用非公开的API,并且, 应用本身在Eclipse下编译就能够使用,不需要到源码下编译。 暂且为该文件命名为mylibtemp.jar 工程2:Android应用工程 1、建立工程 新建一个Android工程。 在工程的 Java Build Path -> Libraries 下,导入 mylibtemp.jar 库。 使用 mylibtemp.jar 中的类编写代码。 下面假设最后生成的应用程序文件为 myapp.apk。 2、编辑AndroidManifest.xml文件 编辑工程根目录下的 AndroidManifest.xml 文件。 在 application 下添加以下内容: <uses-library android:name="com.mytest.lib"> </uses-library> 其中的 :name 表示所引用的库文件的包名。 其与库工程的 .xml 文件中的 name 应该是一致的。 这样在应用运行时就能够找到相应的 .jar 文件了。 如果引用了多个库,需要添加多个 uses-library 标签。 3、为工程添加makefile文件: 在库文件工程的根目录下创建以下文件: Android.mk 该文件是用来编译工程的,名称固定。 在文件中加入以下内容: LOCAL_PATH:= $(call my-dir) include $(CLEAR_VARS) LOCAL_SRC_FILES := $(call all-java-files-under, src) LOCAL_JAVA_LIBRARIES := mylib LOCAL_PACKAGE_NAME := myapp LOCAL_CERTIFICATE := platform include $(BUILD_PACKAGE) 其中的 LOCAL_JAVA_LIBRARIES 表示程序会用到的库文件。 其名成与库工程下的 .mk 文件中 MAKE_JAR 部分下的 LOCAL_MODULE 应该是一致的。 其中的 LOCAL_PACKAGE_NAME 表示应用最后生成的名称。 4、编译应用程序 将工程的 src、res、assets 文件夹以及文件: Android.mk 和 AndroidManifest.xml 按照目录结构拷贝到以下目录: <Android source folder>/packages/apps/<project name>/ 引用的 .jar 库文件并不需要。 运行以下命令: $ cd <Android source folder> $ . ./build/envsetup.sh $ mmm packages/apps/<project name> 将会生成一个 .apk 文件。 运行以下命令将应用安装到设备: $ sudo adb install [-r] <apk file path> |