由于是小众的，所以网络中关于这方面的资料比较少。这几天由于工作原因，我有幸接触到 Add-on，因此把这方面的知识进行了汇总，整理成如下内容。这些知识来自于我对 sample 示例的理解，并经过项目实践验证，我竭力保证无误，但差错之处也可能存在，如发现，请指正。

以下内容将分成若个步骤：

1. 添加模块；
2. 添加资源文件；
3. 加入编译脚本；
4. 发布；

在阅读下面内容前，先假设是对 $ANDROID_HOME/device/sample 进行修改。

一、添加模块（Add Module）

在自己 product-name 目录下建立 frameworks 文件夹，从 sample 中拷贝 Android.mk 文件到 frameworks。

依照 sample 的方式，在 frameworks 路径下，建立 PlatformLibrary 文件夹，再次从 sample/frameworks 中拷贝 Android.mk 文件，并将其中的 LOCAL_MODULE 和 LOCAL_DROIDDOC_OPTIONS 修改为自己中意的名字。–这里值得注意的是，LOCAL_MODULE 变量被定义两次，第一次是 library，第二次是 document。

依照 sample/frameworks/com.example.android.platform_library.xml 的形式创建自己的 XML 文件，文件名称、XML 内容中 name 和 file 保持和 LOCAL_MODULE(library) 一致。

完成上述操作之后，建立 java 文件夹，并将自己创建的源文件（java）放入到其中，这里不再赘述。

二、添加 Overlay(Add Resoruce)

代码中可能需要访问图片、字符串等资源，但是这些在原有的 Android 中没有，因此需要想办法自行加入，Android 对此提供了两种方式。

第一种就是直接在 $ANDROID_HOME/framework/base/core/res/res 下进行操作，添加文件，追加字符串。这种方式虽然简单，但是破坏了原有的“纯洁性”，因此不予推荐，在第三节修改编译脚本中我采用了第二种方式。

第二种方式就是使用 overlay。在 product-name 目录下建立 overlay 文件夹，依照 framework 的结构建立各级目录，例如想添加图片，可以先依次建立 base/core/res/res/drawable，然后将图片置于其中，同样可以建立 layout 等文件夹。

如果要添加字符串或者 style 资源，就要稍微复杂一点，需要使用 add-resource 来让系统“明白”新添加的内容。

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2">
    <add-resource type="string" name="numwheel_year" />
    <!-- Strings for number wheel -->
    <string name="numwheel_year">年</string>
</resources>

如果没有 add-resource，则会遇到这样的信息：Resource at numwheel_year appears in overlay but not in the base package; use to add.

完了以后，就可以用使用 com.android.internal.R 来访问这些资源了。

三、加入编译脚本（Add build script）

在自己 product-name 目录下建立 sdk_addon 文件夹，并依照 sample/sdk_addon 分别拷贝 manifest.xml 和 hardware.xml，注意 manifest.xml 中的内容必须要根据之前第一步的变更同步修改。

接下来最关键，也是最容易出错的环节到了，那就是修改自己 product 的 mk 文件，需要修改 PRODUCT_PACKAGES、PRODUCT_COPY_FILES、DEVICE_PACKAGE_OVERLAYS 的值，定义 PRODUCT_SDK_ADDON_NAME、PRODUCT_SDK_ADDON_COPY_FILES、PRODUCT_SDK_ADDON_COPY_MODULES和PRODUCT_SDK_ADDON_DOC_MODULE。修改和定义的区别就在于，前者使用”+=”，后者使用“:=”。这些变量的值可以参照sample示例。

由于 sample 的示例中没有出现 DEVICE_PACKAGE_OVERLAYS，所以我这里特别解释一下它的作用，除了刚才为 add-on 增加资源以外，它还起到的作用就是替换掉原来的framework中的资源，比如图片等等，惟一的要求就是必须建立和原来图片位置相同的路径。和 add-on 不同的是，如果你是替换原来资源，那么是不用 add-resource 的。DEVICE_PACKAGE_OVERLAYS 的值就是 overlay 文件夹的路径，不包含 $ANDROID_HOME，到 overlay 一级即可。

完成了修改以后，使用 make PRODUCT-product-name-sdk_addon 进行编译。当然也可以直接执行 make sdk_addon，但是需要注意在此之前，你需要使用 chooseproduct 指定 product-name。执行完毕以后，会得到一个 zip 文件，这个就是 add-on 了。

四、发布（Relase）

完成上面的环节以后，剩下临门一脚了。所谓发布，就是通过诸如 HTTPD 一类的 HTTP SERVER 将资源公布出去。从 http://httpd.apache.org 下载 httpd，如何安装以及修改监听端口可参看其 document，在此不予赘述。

现在把刚才生成的 zip 文件，放置到 htdoc 目录下。并且创建一个 repository.xml，其内容和形式参看 https://dl-ssl.google.com/android/repository/repository.xml，我把它删减一下得到以下内容：

<sdk:sdk-repository
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:sdk="http://schemas.android.com/sdk/android/repository/2">
 
    <sdk:add-on>
        <sdk:name>Google APIs</sdk:name>
        <sdk:api-level>3</sdk:api-level>
        <sdk:vendor>Google Inc.</sdk:vendor>
        <sdk:revision>03</sdk:revision>
        <sdk:description>Android + Google APIs</sdk:description>
        <sdk:desc-url>http://developer.android.com/</sdk:desc-url>
        <sdk:uses-license ref="android-sdk-license" />
        <sdk:archives>
            <sdk:archive os="any">
                <sdk:size>34908058</sdk:size>
                <sdk:checksum type="sha1">1f92abf3a76be66ae8032257fc7620acbd2b2e3a</sdk:checksum>
                <sdk:url>google_apis-3-r03.zip</sdk:url>
            </sdk:archive>
        </sdk:archives>
        <sdk:libs>
            <sdk:lib>
                <sdk:name>com.google.android.maps</sdk:name>
                <sdk:description>API for Google Maps.</sdk:description>
            </sdk:lib>
        </sdk:libs>
    </sdk:add-on>
 
    <sdk:license type="text" id="android-sdk-license">
        This is the Android Software Development Kit License Agreement.
    </sdk:license>
</sdk:sdk-repository>

接下来的事情，就是替换掉里面的 Google 信息为自己，大部分可以从它们的名称中理解其含义，例如 size 是指文件大小，你可以使用ls –l来查看文件大小。checksum 则要麻烦一些，执行 sha1sum ZIP.zip，即使用 sha1 对刚才生成 zip 文件生成校验码。

修改完成以后，通过浏览器访问 http://IP-address:port/repository.xml，确认是否 OK。确认以后，打开 Android SDK and AVD Manager，点击左侧 Available Packages，选择 “Add Add-on Sites” 填入URL，接下来的安装就不费口舌了。完成以后，你可以在 sdk 下的 add-ons 目录下看到刚刚安装的 add-on。

捎带提一下，应用开发方面使用该 add-on 时，调整工程的 Project Build Target 设定即可。

host C: libclearsilver-jni <= external/clearsilver/java-jni/j_neo_util.c
In file included from /usr/include/features.h:378,
                      from /usr/include/string.h:26,
		      from external/clearsilver/java-jni/j_neo_util.c:1:
/usr/include/gnu/stubs.h:9:27: error: gnu/stubs-64.h: No such file or directory
make: *** [out/host/linux-x86/obj/SHARED_LIBRARIES/libclearsilver-jni_intermediates/j_neo_util.o] Error 1

兵来将挡，水来土掩，用关键字 android “error: gnu/stubs-64.h: no such file or directory” 来搜一下吧，发现搜索结果寥寥无几，看样子问题比较新，其中有一个 CSDN 的链接，就顺手点了过去。帖子反映的问题和我一模一样，不过它的分析给了我一些提醒。

从错误信息入手，追踪到/usr/include/gnu/stubs.h，看到如下代码：

#if __WORDSIZE == 32
# include <gnu/stubs-32.h>
#elif __WORDSIZE == 64
# include <gnu/stubs-64.h>
#else
# error "unexpected value for __WORDSIZE macro"
#endif

顺着 WORDSIZE，进入/usr/include/bits/wordsize，发现：

#if defined __x86_64__
# define __WORDSIZE	64
# define __WORDSIZE_COMPAT32	1
#else
# define __WORDSIZE	32
#endif

结合报错的信息，可以知道这里一定是有定义__x86_64__，执行一下 uname -a 可以确认 OS 明明是x86，为什么会__x86_64__呢？追根溯源， Android 源码或许能露出蛛丝马迹。

果不其然，从 android.git.kernel.org 的 platform/external/clearsilver.git 上，看到5天前，有个 Ying Wang 的家伙提交一个修改：Fix 64-bit clearsilver shared library issue，参看这里，修改内容中 java-jni/Android.mk，和出现本次问题的路径 java-jni/j_neo_util.c，同属一个父目录，看样子有点关系，查看 Android.mk 的修改内容，发现做了如下修改：

+# This forces a 64-bit build for Java6
+ifneq ($(filter 1.6%,$(java_version)),)
+    LOCAL_CFLAGS += -m64
+    LOCAL_LDFLAGS += -m64
+endif

当发现你使用Java6时，它将强制使用64-bit，我想这就能解释__x86_64__出现的原因。那么既然它要64-bit，我就满足它。首先要解决 gnu/stubs-64.h: No such file or directory，解决这个问题需要执行以下命令：

[xuhj@eniac mydroid]$ apt-get install libc6-dev-amd64

完成以后再执行 make，发现有错误：

/usr/bin/ld: cannot find -lstdc++

那就继续满足它：

[xuhj@eniac mydroid]$ apt-get install g++-multilib lib64stdc++6

还是不行，又发生下面的错误：

/usr/bin/ld: cannot find -lz

再来执行命令：

[xuhj@eniac mydroid]$ apt-get install lib64z1-dev

使用 AIDL 并不是难事，但是比较繁琐，并且一不小心容易出错。好在 Android Dev Guide 的 Designing a Remote Interface Using AIDL 对这个问题讲解非常详细，再结合 Android APIDemo 中的 Remote Service Binding 给出了的示例，这都给了开发者提供了非常到位的帮助。以下内容就是我结合二者，整理出来的笔记，力求真理，但能力有限，差错难免，请读者坚持自己的判断力，本文只供参考，且不可尽信。

一、使用 AIDL 实现 IPC

面对问题，应统揽全局，归纳阶段，划定步骤，共得出四大步，分列如下：

创建.aidl 文件

在这个文件里定义 method 和 field

把 .aidl 文件加入到 makefile 中去

如果使用 Eclipse 则 ADT 会帮你管理

实现接口方法

AIDL 编译器会根据接口生成一个用 Java 语言编写的interface，这个 interface 有一个抽象的内部类，名字为 Stub，你必须创建一个类，继承于它，并且实现 .adil 文件中所声明的方法

公开接口给客户端

如果创建的是 service，则应该继承自 Service，并且重载 Service.onBind() 返回实现接口的类的实例

这四个步骤在 Remote Service Binding 中均有所呈现，以下分开阐述。Remote Service Binding 共包含有两个 .java 文件，三个 .aidl 文件，物理结构比较简单，但是逻辑结构就不那么简单，以下用 Class Diagram 来展示其中的关系。

Remote Service Binding

1、创建.aidl 文件

AIDL 语法简单，用来声明接口，其中的方法接收参数和返回值，但是参数和返回值的类型是有约束的，且有些类型是需要 import，另外一些则无需这样做。

AIDL 支持的数据类型划分为四类，第一类是 Java 编程语言中的基本类型，第二类包括 String、List、Map 和 CharSequence，第三类是其他 AIDL 生成的 interface，第四类是实现了 Parcelable protocol 的自定义类。
其中，除了第一类外，其他三类在使用时均需要特别小心。

使用第二类时，首先需要明白这些类不需要 import，是内嵌的。其次注意在使用 List 和 Map 此二者容器类时，需注意其元素必须得是 AIDL 支持的数据类型，List 可支持泛型，但是 Map 不支持，同时另外一端负责接收的具体的类里则必须是 ArrayList 和 HashMap。

使用第三、四类时，需要留意它们都是需要 import 的，但是前者传递时，传递的是 reference，而后者则是 value。

在创建 .aidl 文件的过程中，应该注意一旦 method 有参数，则需注意在前面加上 in, out 或 inout，它们被称为 directional tag，但是对于基本类型的参数，默认就是 in，并且不会是其他值。

Remote Service Binding 共包括了三个 .aidl 文件，分别是IRemoteService.aidl、IRemoteServiceCallback.aidl、ISecondary.aidl，通过它们可以看到如何使用第一类和第三类的数据类型，稀罕的是，看不到第二类、第四类数据类型的使用，也没有看到 directional tag。

2、实现 Interface

AIDL 为你生成一个 interface 文件，文件名称和 .aidl 文件相同。如果使用 Eclipse 插件，则 AIDL 会在构建过程中自动运行，如果不使用插件，则需要先使用 AIDL。

生成的 interface 会包含一个抽象内部类 Stub，它声明了在 .aidl 文件里的所有方法。Stub 也定义了一些帮助方法，比较常用的有 asInterface()，其接收一个 IBinder 作为参数，并且返回一个 interface 的实例用来调用IPC方法。

    private static INotificationManager sService;
 
    static private INotificationManager getService()
    {
        if (sService != null) {
            return sService;
        }
        sService = INotificationManager.Stub.asInterface(ServiceManager.getService("notification"));
        return sService;
    }

要实现 interface，需要继承 Stub，实现其方法，这在 RemoteService 和 RemoteServiceBinding 都可以找到相关代码。

这个环节是重中之重，需要特别小心的有两点，其一是抛出的所有异常均不会发给调用者；其二是IPC调用是同步的，这意味IPC服务一旦花费较长时间完成的话，就会引起ANR，应该将这样的操作放在单独的线程里。

3、向客户端公开 Interface

独乐乐不如众乐乐，需要将服务公开出去，要达成这个目的，须得创建一个 Service 的子类，并且实现 Service.onBind(Intent)，通过这个方法将实现了接口的类的实例返回回来。通过查看 RemoteService 一目了然。

    @Override
    public IBinder onBind(Intent intent) {
        // Select the interface to return.  If your service only implements
        // a single interface, you can just return it here without checking
        // the Intent.
        if (IRemoteService.class.getName().equals(intent.getAction())) {
            return mBinder;
        }
        if (ISecondary.class.getName().equals(intent.getAction())) {
            return mSecondaryBinder;
        }
        return null;
    }

其中的 mBinder 和 mSecondaryBinder 分别是实现了 IRemoteService 和 ISecondary 接口的类的实例。

4、使用Parcelables传值

前文中提到 Remote Servcie Binding 没有使用第四类数据类型作为参数，这是示例的不足，要想让一个类变成第四类，需要遵照以下步骤：

1. 引入 Parcelable 接口
2. 实现 writeToParcel(Parcel out)
3. 增加一个静态的field，其实现 Parcelable.Creator 接口
4. 创建一个 .aidl 文件，用以声明你的 parcelables 类

在 Designing a Remote Interface Using AIDL 中，类 Rect 是一个不错的示例，弥补了 Remote Service Binding 的不足。

二、调用 IPC 方法

万事具备，只欠东风，IPC 备妥，只待调用。在 Remote Service Binding 中，RemoteServiceBinding 正是 IPC 的调用者，

既然要使用接口，那就先声明 interface 类型的变量，

    /** The primary interface we will be calling on the service. */
    IRemoteService mService = null;
    /** Another interface we use on the service. */
    ISecondary mSecondaryService = null;

实现 ServiceConnection，在 onServiceConnected(ComponentName className, IBinder service) 中完成对 mService 和 mSecondaryService 的赋值。

    private ServiceConnection mConnection = new ServiceConnection() {
        public void onServiceConnected(ComponentName className,
                IBinder service) {
            mService = IRemoteService.Stub.asInterface(service);
            // ... 以下省略
        }
    }

接着别忘了调用 Context.bindService()，完成任务以后，调用 Context.unbindService()。如果在 connection 中断的情况下，调用 IPC 方法，你会遇到 DeadObjectException，这是 remote method 能抛出的唯一异常。

]]>