Android项目的依赖关系
在Android SDK Tools和Eclipse ADT 插件的第17版本 (revision 17)中,我们对Android项目的依赖关系管理做了很多改变。
我们所做的第一个改变是调整基于 Ant 的编译系统和 Eclipse ADT 插件,使他们具有相同的行为。
Android 项目包含源代码文件夹,以及对库项目 (android library projects) 和 jar 文件的依赖。 不需要其他多余的设置,只需要在project.properties中添加对于库项目的依赖,Android项目就会在动在 classpath 中添加以下依赖项:
- libs/*.jar 的内容
- 库项目(library project)的输出。
- 库项目的 libs/*.jar 的内容。
这些依赖项,加上项目自身源代码编译的结果,被一起交给DEX工具,然后被转化成字节码从而打包到最终的APK当中。
因为一个项目可能依赖于好几个使用相同的 jar 文件的库项目,Android 编译系统会检查所有所需的 jar 文件,检测出来自不同的库项目的重复 jar 文件,并删除这些重复的jar引用。这会防止可怕的"already added" DX错误。
下面介绍了系统如何发现重复引用。
重要的变化 我们已经改变了库项目生成和打包R类的方式:
- R类不再被打包到库项目的输出 jar 包中。
- 库项目不再为其所依赖的库项目生成R类。 只有主应用项目才会在生成本身R类的同时为所依赖的库项目生成R类。
这意味着库项目不能导入(import)另一个库项目的R类。 其实这是没有必要的,因为它们自身的R类包含所有必要的资源。
请注意,应用程序的项目仍然可以导入所引用的库项目的R类,但是重申一遍,其实没有必要这么做, 因为他们本身的R类包括所有的资源。
Eclipse的具体变化
由于不光包含库项目,被称为"Library Projects"的动态class path容器 (dynamic class path container) 已更名为“Android Dependancies”。
现在被库项目引用的纯 Java 项目也可以填充classpath容器。 如果这些Java项目也引用其他 Java 项目或 jar 文件,它们将被自动添加(现在也支持通过 user libraries引用的jar文件)。
重要: 仅当被引用的项被标记为"exported"时这才起作用。 请注意,默认情况下,当一个项目或jar文件被添加到项目的build path 中时是不会被标记为"exported"。
库项目( 以及它们所引用的lib/*.jar文件)总是会被标记为"exported"。
重要: 如果你还在手动引用jar类库,而不是把他们放在libs目录下, 注意以下几点:
- 如果该项目是一个 library project,应用项目默认情况下看不见这些jar 类库。 你必须把这些类库挪到"libs"子目录下。
- 如果该项目是一个应用程序项目,你可以这样做,但你必须确保把引用的jar文件标记为"exported"。
下图介绍了如何将Java项目和jar类库标记为"exported"(Android Dependencies 容器不必被标为"exported",反正它总是会被导出):
再次强调一下, 重复的引用(包括引用的项目和 jar 文件)会被自动发现并且删除掉。
依赖解析
当一个项目引用了两个库项目,都需要相同的jar文件,编译系统需要检测和解决这种重复。
一个完整的依赖系统会将每个jar文件关联到一个完全限定名 (fully qualified name) 和一个版本号,以决定使用哪个版本。
不幸的是,Android编译系统暂时还没有一个完整的依赖解析系统。 在此期间,我们按照下列规则实现了一个简单的系统:
** 严格按照文件名来识别 jar 文件 **
这意味着 mylib.jar 和 mylib-v2.jar 是不同的两个文件,虽然它们实际上是不同版本的同一个类库, 他们都将被打包,从而可能导致 dx "already added" 错误。
对于具有相同文件名的 jar 文件,“相同版本”是指完全相同的文件。
目前,我们的检测是非常基本的,只检查这些文件是不是有相同的大小和sha1 值。
如果两个库都包含在他们的libs文件夹名为mylib.jar文件,但是这两个文件是不同的,编译系统将不能指出这种依赖错误。
解决的办法: 如果它们是相同的类库,确保两个jar文件实际上是同一个。 如果是不同的两个类库,把他们重新命名为不同的jar包。
特殊情况: android-support-v4.jar 和 android-support-v13.jar
我们把这两个库当作特殊情况来处理, 因为-V13里面包含一个完整-V4的版本。 如果发现两者同时存在,只有V13被使用。
请注意,我们不能保证-V13中使用的-V4版本和其他老的类库使用到的-V4版本是相同的。 我们建议,当您更新您的项目与新版本的support library,你在同一时间更新您的所有项目,无论他们使用-V4还是-V13。
创建和使用Android library工程 文地址:http://www.devdiv.com/thread-36947-1-1.html
创建library供多个工程共享代码、资源是非常常见的需求,网上这种资料非常少,基本上都是讲创建java工程,然后export,这种方式缺点非常多,大家可以自己google一下。
本文着重介绍如何创建Android library,并且在工程中使用此library提供的资源,具体步骤如下:
1. 创建一个Android工程,命名为MyLib
2. 进入工程设置选中Is Library
3. 创建另一个Android工程,命名为MyProj
4. 进入工程设置,添加MyLib
5. 在MyProj的AndroidManifest.xml中加入对library中activity的引用
<activity android:name="net.devdiv.mylib.MyLib" />
6. 由于编译后library中的资源和引用它的project资源是合并在一起的,为了避免重名问题,需要对library中资源进行重命名
1). 把main.xml改为mylib.xml,同时修改MyLib.java代码setContentView(R.layout.mylib);
2). strings.xml修改为<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="mylibhello">String fetched from lib!</string>
<string name="mylib_app_name">MyLib</string>
</resources>
7. 在MyProj中引用MyLib的资源
package net.devdiv.myproj;
import android.app.Activity;
import android.os.Bundle;
import android.widget.TextView;
import net.devdiv.mylib.*;
import android.content.Intent;
public class MyProj extends Activity {
/** Called when the activity is first created. */
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
TextView tv = (TextView)findViewById(R.id.myprojtext);
tv.setText(R.string.mylibhello);
Intent it = new Intent(this, MyLib.class);
startActivity(it);
}
}