绑定 Eclipse 库项目

  • 项目

重要

我们当前正在调查 Xamarin 平台上的自定义绑定使用情况。 请参与此调查，告诉我们将来应该进行哪些开发工作。

本演练介绍了如何使用 Xamarin.Android 项目模板来绑定 Eclipse Android 库项目。

概述

尽管 .AAR 文件正日益成为 Android 库分发的规范，但在某些情况下，仍有必要为 Android 库项目创建绑定。 Android 库项目是特殊的 Android 项目，其中包含可由 Android 应用程序项目引用的可共享代码和资源。 通常，在 Eclipse IDE 中创建库时，需要绑定到 Android 库项目。 本演练举例说明了如何从 Eclipse 项目的目录结构创建 Android 库项目 .ZIP。

Android 库项目与常规 Android 项目的不同之处在于，前者没有编译到 APK 中，也不能自行部署到设备上。 相反，Android 库项目应由 Android 应用程序项目引用。 生成 Android 应用程序项目时，首先编译的是 Android 库项目。 然后，Android 应用程序项目会被并入已编译的 Android 库项目中，并将代码和资源添加到 APK 中以供分发。 正是由于有这种差异，为 Android 库项目创建绑定与为 Java .JAR 或 .AAR 文件创建绑定略有不同。

演练

若要在 Xamarin.Android Java 绑定项目中使用 Android 库项目，首先需要在 Eclipse 中生成 Android 库项目。 下面的屏幕截图展示了一个编译后 Android 库项目示例：

Example library project in Eclipse

请注意，Android 库项目中的源代码已编译到临时 .JAR 文件 android-mapviewballoons.jar 中，且资源已复制到 bin/res/crunch 文件夹中。

在 Eclipse 中编译完 Android 库项目后，便可以使用 Xamarin.Androidn Java 绑定项目来绑定它。 首先，必须创建 .ZIP 文件，其中包含 Android 库项目的 bin 和 res 文件夹。 请务必删除干预 crunch 子目录，让资源驻留在 bin/res 中。下面的屏幕截图展示了一个此类 .ZIP 文件的内容：

Contents of Android library project .zip

然后，将此 .ZIP 文件添加到 Xamarin.Android Java 绑定项目中，如下面的屏幕截图所示：

Zip added to Java Binding project

请注意，.ZIP 文件的“生成操作”已自动设置为“LibraryProjectZip”。

若有 Android 库项目需要的任何 .JAR 文件，应将它们添加到 Java 绑定库项目的 Jar 文件夹中，并将“生成操作”设置为“ReferenceJar”。 下面的屏幕截图中举例说明了这种情况：

Build action set to ReferenceJar

完成这些步骤后，可以按本文档前面所述，使用 Xamarin.Android Java 绑定项目。

注意

暂不支持在其他 IDE 中编译 Android 库项目。 其他 IDE 可能不会在 bin 文件夹中创建与 Eclipse 相同的目录结构或文件。

总结

本文逐步介绍了绑定 Android 库项目的过程。 我们先是在 Eclipse 中生成了 Android 库项目，然后从 Android 库项目的 bin 和 res 文件夹创建了 zip 文件。 接下来，我们使用此 zip 创建了 Xamarin.Android Java 绑定项目。