日积月累：Android项目打第三方jar包

随着Android系统的日益发展和日渐成熟，各种平台的合作就日渐频繁。现在主要互联网公司，都退出了各种各样的插件功能。如第三方支付，第三方联合登陆和微博分享等等功能。

近期由于业务的需要，公司提出将项目的功能打成jar包，提供给其它客户调用。经过一段时间的调查研究和实践，先将解决办法总结如下。

一、原理介绍

在每个Android项目中，都会有一个R.java文件，该文件由ADT维护的，只要你将资源文件放到工程里，或者声明新的控件标识，ADT就会监测到，自动在R.java里注册一个ID方便使用。

public final class R { 
    public static final class anim { 
        public static final int cycle_7=0x7f040000; 
        … …  
    } 
    public static final class array { 
        public static final int bank_type=0x7f050001; 
        … …  
    } 
    public static final class id{ 
        public static final int account_warning_text_color=0x7f060027; 
        public static final int account_withdraw_text_color=0x7f060026; 
        … ... 
    } 
    … ... 
} 

Android布局文件中的组件被调用时需要定义组件的android:id属性，android:id属性只能接受资源类型的值，就是必须以@开头的值。我们声明一个控件的ID有如下几种方式：

方式一@+id：当我们保存布局文件后，系统会自动的在R.java中生成一个int类型的16进制值的变量。public static finalintnoteInfo=0x7f070007;

 <TextView           
    android:id="@+id/noteInfo"          
    android:layout_width="match_parent"          
    android:layout_height="wrap_content"/> 

方式二@id：使用固定id值（可在ids.xml文件和public.xml文件中指定），不自动生成。

<FrameLayout 
    android:id="@android:id/tabcontent" 
    android:layout_width="fill_parent" 
    android:layout_height="fill_parent" > 
</FrameLayout> 

方式三@android:id：通过该系统定义好的id值，引用Android系统内部资源。

<?xml version="1.0" encoding="utf-8">  
<TabHost xmlns:android="http://schemas.android.com/apk/res/android"    
    android:id="@android:id/tabhost"  
    android:layout_width="fill_parent"  
    android:layout_height="fill_parent" >  
    <LinearLayout  
        android:orientation="vertical"  
        android:layout_width="fill_parent" 
        android:layout_height="fill_parent" > 
        <TabWidget 
            android:id="@android:id/tabs"             
            android:layout_width="fill_parent"            
            android:layout_height="wrap_content" /> 
        <FrameLayout 
            android:id="@android:id/tabcontent"            
            android:layout_width="fill_parent"             
            android:layout_height="fill_parent" > 
        </FrameLayout> 
    </LinearLayout> 
</TabHost> 

TabHost的id必须是tabHost，TabWidget的id必须是tabs，FrameLayout的id必须是tabcontent。这些id都是直接引用的系统的值。

在项目的/res/values目录下，我们可以定义如下两个文件，分别介绍它的作用：

ids.xml文件：为应用相关的资源提供唯一的资源id，id是为了获得xml中的对象而需要的参数，也就是Object=findViewById(R.id.id_name)中的id_name。这些值可以在代码中用android.R.id引用到。

<resources> 
    <item name="HorizontalScrollView01" type="id"/> 
    <item name="LinearLayout0000" type="id"/> 
    <item name="LinearLayout01" type="id"/> 
</resources> 

public.xml文件：描述attr、id、drawable等所指定的一个32的id值，即id值。

<resources> 
    <public id="0x7f040000" name="cycle_7" type="anim" /> 
    <public id="0x7f040002" name="layout_animation_image" type="id" /> 
    <public id="0x7f040003" name="layout_animation_linear" type="color" /> 
</resources> 

基础的知识已经准备完毕，现在我们来描述原理。当我们将src目录下的源码通过Eclipse打出Jar后，源码代码中的如Object =findViewById(R.id.id_name)中的R.id.id_name部分，都会被替换成此时在R文件中生成的id_name对应的ID值（如果有兴趣的话，可以用反编译软件可以查看到）。但是由于R文件中的ID值是由系统自动生成的，而且在不同的系统环境和不同的时间，id_name对应的ID可能不一样。

故我们就出现了如下问题：假设在生成Jar包的时候，@+id/id_name在R文件中自动生成的ID值为publicstatic finalintaction_settings=0x7f080001。当时当你将Jar提供给第三方的时候，在它的机器上生成的ID值可能就不是0x7f080001，就会出现由于Jar中固定的ID值与当前R文件中生成的ID值不一致，导致Object =findViewById(R.id.id_name)无法找到控件的对象的问题。

通过对上面只是的了解，我们可以用如下方式解决问题：通过使用ids.xml文件和public.xml文件，定义好固定的ID值，将声明控件的方式由@+id改为@id形式，这样引用控件和资源的id根据ids.xml和public.xml的声明，在R文件中声明为固定的值。一直与Jar中的ID值保持一致。

二、操作步骤

这里我们就以一个简单的项目v_main_plug演示操作步骤：

1.重新编译项目，生成R文件。

2.将R文件拷贝，根据R文件中的信息，获得ids.xml和public.xml文件中的内容。

ids.xml文件格式：只需声明@id的对应的R文件中id类型

public.xml文件格式：需要声明R文件中所有资源的类型

可能由于项目中的资源比较多，实际工作中可以使用文本工具自动替换，或写程序自动替换。

3.将项目布局文件中@+id的形式转换成@id形式。

这个可以使用Eclipse的搜索和替换功能很快的实现。

4.使用Eclipse的Export功能，将项目src目录下的源码（注仅仅是src目录下的源码，其它资源我们将以库项目的形式提供给用户）导出Jar包，提供给用户调用。

这里我补充解释一下，此时导出的Jar，里面的Object=findViewById(R.id.id_name)的R.id.id_name等部分，是从public.xml文件中设置的固定值替换，所以一直保持一致。

5.我们删除该项目src下的源代码，将该项目设置为库项目，以供客户引入或许Jar包中的布局，图片等资源。

到这里我们为客户准备的东西已经完毕，1.srcjar.jar包，2.plugin资源库项目。

6.将srcjar.jar包加入客户的项目中（我们以jardemo项目简单模拟），并引入我们的plugin资源库项目（注客户项目一定要和资源项目在同一个目录下）。

7.将plugin资源库项目的AndroidManifest.xml中的内容，添加到客户项目中，并在客户端项目中调用srcjar.jar包中的入口Activity即可。

注意：如果在你的项目中存在调用本项目目录调用资源，如assets下的apk或者mp3等文件，可以拷贝到客户端相应的目录即可。

三、最后总结

好了，基本的原理和操作步骤已经介绍完毕。希望大家能明白和看懂。