Android下编译自己的库文件jar并在应用中调用

armeasy

主要为了解决如下问题：

项目中使用了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>