给Android源码增加一个项目

所谓增加一个项目的意思是，增加一个子项目，以便于Android源码遍以后，编译目标中能够包含该项目。比如：可以增加一个C/C++工具程序，从而可以在目标系统的shell命令行下使用该工具。再比如，可增加一个apk程序，从而在该设备出厂时就自带该程序。

      从编译中枢的角度来讲，增加项目就是告诉编译中枢一些信息，这些信息包括：

• 这个项目的target名称是什么？
• 这个项目的输出类型是什么？比如：apk、jar包等
• 这个项目对应的variant是什么？

有了这些信息后，编译中枢就知道如何编译该项目，并将输出的目标打包到不同的variant产品分类中。

一、给Android源码增加一个C项目

下面说明如何增加一个C项目。

首先，需要选择一个目录，本例可以选择external目录。

接着，需要给该项目定义一个target名称，这个target名称必须是全局唯一的，这里可以定义为helloMake。该工程很简单，只包含一个main.c文件，其内容如下：

[cpp] view plaincopy

1. #include <stdio.h>  
2. #include <stdlib.h>  
3. #include "hello.h"  
4.   
5. int main()  
6. {  
7.     makePrintf("helloMake");  
8.     return 0 ;  
9. }  

hello.h文件内容如下：

[cpp] view plaincopy

1. #include <stdio.h>  
2. #include <stdlib.h>  
3.   
4. #ifndef _HELLO_H  
5. #define _HELLO_H  
6.   
7. void makePrintf(char* str)  
8. {  
9.     printf("%s" , str);  
10. }  
11.   
12. #endif  

添加这2个文件后，需要编写一个Android.mk文件，其内容如下：

[java] view plaincopy

1. LOCAL_PATH := $(call my-dir)  
2. include $(CLEAR_VARS)  
3. LOCAL_SRC_FILES := \  
4.     main.c  
5. LOCAL_C_INCLUDES += $(LOCAL_PATH)  
6. LOCAL_MODULE := helloMake  
7. LOCAL_MODULE_TAGS := eng  
8. include $(BUILD_EXECUTABLE)  

该mk文件中需要注意以下几点：

1、所有的C/C++原文件必须手动添加，因为编译中枢并没有提供一个能够自动从当前目录下寻找所有C/C++文件列表的函数。

2、由于C语言中会使用到include命令，因此，必须在mk文件中指定头文件的路径，仅需指定项目中包含的特别路径，而不需要指定系统头文件路径。因为系统头文件路径在编译中枢中已经设置好了，具体是在config.mk文件中设定的，如以下代码所示。如果要添加一些特别的系统路径，可以更该build/core/config.mk文件中SRC_HEADERS的值。

3、该项目使用的TAG值为eng，因此，仅当用户指定的产品类别是eng时才会包含该项目。如果要让所有类别的产品都包含该项目，可以将TAG值设置为optional，并在相应的product的配置文件中的PRODUCT_PACKAGES变量中包含该项目即可。./vendor/xxxx/build/product/xxxx_sdk.mk

4、然后就可以编译SDK，完成后，将新的system.img耍人设备，启动./adb shell，在命令行下，直接调用helloMake,程序将输出helloMake。

二、给Android源码增加一个apk项目

      添加一个apk项目可能是很多应用工程师经常遇到的问题，下面来介绍如何添加一个apk项目，该过程的原理和添加C项目相同，只是apk项目中相关的编译变量名称和C项目稍有不同。

      首先，假设已经在Eclipse下新建了一个名称为HelloAPK的Android应用项目，下面要做的就是要把这个项目移植进Android源码中。前面曾经说过，编译中枢会搜索Android根目录下除out目录外的所有子目录，并找出Android.mk文件作为一个子项目。因此理论上可以将HelloAPK项目放在任何目录下，只不过为了目录的清晰，厂商一般习惯于将自己定义的项目放到vendor下的相应目录中。

      然后，删除HelloApk目录下的bin和gen目录，因为这2个目录是Eclipse编译的输出目录，而其对Android编译系统而言是多余的，它甚至会认为这是2个源码目录。从这点上看，编译中枢似乎需要改进一下，它应该能够自动排除APK项目下的bin和gen目录。

      接下来，就需要新建一个Android.mk文件，并将其放到HelloAPK目录下，该Android.mk的内容如以下代码所示。

[plain] view plaincopy

1. LOCAL_PATH:= $(call my-dir)  
2. include $(CLEAR_VARS)  
3. LOCAL_MODULE_TAGS := optional  
4. LOCAL_SRC_FILES := $(call all-java-files-under, src)  
5. #LOCAL_SDK_VERSION := current  
6. LOCAL_PACKAGE_NAME := bright-yinjk  
7. LOCAL_CERTIFICATE := platform  
8. include $(BUILD_PACKAGE)  
9. include $(call all-makefiles-under,$(LOCAL_PATH))  

以上.mk文件说明如下：

LOCAL_MODAL_TAGS 用于指定该项目的标签值，对于应用类子项目而言，只能指定为3种情况，分别为:optional、tests、eng，这与C项目是相同的，本例中使用的是optional。因此，对于实体设备必须在devices/haiii/k/k.mk文件中包含该项目，否则K产品将不会包含该，如以下代码所示，

[plain] view plaincopy

1. PRODUCT_PACKAGES := \  
2.         heoolMake \  
3.         HelloAPK  

对于模拟器需要在vendor/hisxxx/build/product/hitv_sdk.mk文件中增加如下代码：

[plain] view plaincopy

1. # thirdparty packages for device  
2. PRODUCT_PACKAGES += \  
3.     com.tencent.qqpinyin \  
4.     bright-yinjk  

LOCAL_SRC_FILE用于指定该项目中的JAVA源码，编译中枢提供了一个函数，可以直接遍历指定目录下的所有JAVA文件，从而不必手工列出所有的JAVA原文件，而C项目中没有类似功能的脚本函数。

LOCAL_PACKAGE_NAME：用于描述APK项目的名称，而C项目中用的是LOCAL_MODULE_NAME，注意区分。

LOCAL_SDK_VERSION：用于指定该APK项目所需的SDK版本，current代表了当前Android源码的版本。

LOCAL_CERTIFICATE：用于指定该APK项目将使用何种签名文件签名最后生成的apk文件。系统中一共包含4种签名文件，分别如下：

• platform      FrameWork源码最后将生成一个Jar包，该Jar包默认使用该类型签名
  
• shared        一些系统应用程序使用该类型签名，比如Contacts等
  
• user             一些私有项目使用该签名
  
• tests             调试过程中使用该签名

至于使用何种签名取决于项目的需要，一般当需要和特定的程序共享数据库资源时，两个项目必须拥有相同的签名。

最后，使用include包含BUILD_PACKAGE命令宏告诉编译中枢该项目的目标是一个apk程序。

以上介绍的是以源码的方式添加一个项目，有些时候可能还需要以一个apk文件的方式添加一个项目，在这种情况下，本质上添加的不是一个项目，而仅仅是一个文件。前面讲过，一个product中包含的项目分为3种，其中最后一种就是私有的项目或者文件，而这种方式实际上就是私有的文件。因此，需要在product相关的脚步文件中声明该product中包含apk文件。本例中就应该在k.mk文件中添加以下代码，其中赋值的源路径是主机系统上的路径，而目标路径是设备上的路径，两者使用冒号分割，如下：

[plain] view plaincopy

1. PRODUCT_COPY_FILES := \  
2.       vendor/haiii/k/helloapk/helloapk.apk:/system/app  

        该段代码仅仅是将HelloApk.apk复制到最终设备的/system/app目录下，如果想给apk进行签名怎么办？对不起，编译中枢没有单独提供这个功能，也就是说，再包HelloApk.apk复制到源码中前，应该事先给apk进行签名。如果开发中真的有这种需求，可以尝试增加一个BUILD_PACKAGE_WITHAPK的命令宏，就像BUILD_PACKAGE一样。用户可以在Android.mk文件中使用include命令包含该宏，然后在该命令宏的定义中手工实现对apk的签名。