日积月累：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 final int noteInfo=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值为public static final int action_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等文件，可以拷贝到客户端相应的目录即可。 

 

三、最后总结 

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