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",反正它总是会被导出):

Mark references as exported in Eclipse

再次强调一下, 重复的引用(包括引用的项目和 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);

}

}

posted on 2012-08-16 10:34  jiezzy  阅读(2250)  评论(0编辑  收藏  举报