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

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

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

一、原理介绍

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

 

[java][/java] view plaincopy

  1. public final class R {
  2.     public static final class anim {
  3.         public static final int cycle_7=0x7f040000;
  4.         … …
  5.     }
  6.     public static final class array {
  7.         public static final int bank_type=0x7f050001;
  8.         … …
  9.     }
  10.     public static final class id{
  11.         public static final int account_warning_text_color=0x7f060027;
  12.         public static final int account_withdraw_text_color=0x7f060026;
  13.         … …
  14.     }
  15.     … …
  16. }

 

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

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

 

[html][/html] view plaincopy

  1. <TextView
  2.    android:id=”@+id/noteInfo”
  3.    android:layout_width=”match_parent”
  4.    android:layout_height=”wrap_content”/>

 

方式二@id:使用固定id值(可在ids.xml文件和public.xml文件中指定),不自动生成。

 

[html][/html] view plaincopy

  1. <FrameLayout
  2.     android:id=”@android:id/tabcontent”
  3.     android:layout_width=”fill_parent”
  4.     android:layout_height=”fill_parent” >
  5. </FrameLayout>

 

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

 

[html][/html] view plaincopy

  1. <?xml version=”1.0″ encoding=”utf-8″>
  2. <TabHost xmlns:android=”http://schemas.android.com/apk/res/android”
  3.     android:id=”@android:id/tabhost”
  4.     android:layout_width=”fill_parent”
  5.     android:layout_height=”fill_parent” >
  6.     <LinearLayout
  7.         android:orientation=”vertical”
  8.         android:layout_width=”fill_parent”
  9.         android:layout_height=”fill_parent” >
  10.         <TabWidget
  11.             android:id=”@android:id/tabs”
  12.             android:layout_width=”fill_parent”
  13.             android:layout_height=”wrap_content” />
  14.         <FrameLayout
  15.             android:id=”@android:id/tabcontent”
  16.             android:layout_width=”fill_parent”
  17.             android:layout_height=”fill_parent” >
  18.         </FrameLayout>
  19.     </LinearLayout>
  20. </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引用到。

 

[html][/html] view plaincopy

  1. <resources>
  2.     <item name=”HorizontalScrollView01″ type=”id”/>
  3.     <item name=”LinearLayout0000″ type=”id”/>
  4.     <item name=”LinearLayout01″ type=”id”/>
  5. </resources>

 

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

 

[html][/html] view plaincopy

  1. <resources>
  2.     <public id=”0x7f040000″ name=”cycle_7″ type=”anim” />
  3.     <public id=”0x7f040002″ name=”layout_animation_image” type=”id” />
  4.     <public id=”0x7f040003″ name=”layout_animation_linear” type=”color” />
  5. </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等文件,可以拷贝到客户端相应的目录即可。

 

三、最后总结

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

标签