Android for Maven Eclipse 技术文档

1. 安装指南

环境准备

在开始安装之前，请确保您的开发环境满足以下要求：

1. 安装 Android SDK：

   • 下载并安装 Android SDK。
   • 创建 ANDROID_HOME 环境变量，指向 Android SDK 的安装路径。

2. 安装所需的 Android 依赖项：

   • 执行以下命令以安装所需的 Android 依赖项：

     android update sdk --filter platform-tools,build-tools-21.1.1,android-18,addon-google_apis-google-18,android-10,addon-google_apis-google-10,android-8,addon-google_apis-google-8 --no-ui --force
     

3. 安装 Maven 3：

   • 下载并安装最新版本的 Maven 3，以支持命令行中的 Tycho。

4. 安装 Maven Android SDK Deployer：

   • 安装 Maven Android SDK Deployer 并部署 4.1 和 4.3 API：

     mvn install -P 4.3,2.2
     

构建项目

在项目文件夹中执行以下命令以构建项目：

mvn install

Eclipse 设置

1. 安装 Eclipse Luna：

   • 下载并安装 Eclipse Luna。

2. 安装 Eclipse Plug-in Development Environment：

   • 安装 Eclipse Plug-in Development Environment。

3. 重启 Eclipse。

4. 导入项目：

   • 克隆此 Git 仓库到您的本地工作区。
   • 在 Eclipse 中选择 File -> Import...，然后选择 Maven -> Existing Maven Projects。
   • 选择刚刚克隆的 m2e-android 文件夹，并选择父项目和一些子项目（不包括目标定义，如 luna、mars 等，但包括 compile 目标）。
   • 点击 Finish。
   • 如果需要，安装一些额外的 m2e 扩展。
   • 重启 Eclipse 当提示时。

5. 配置目标平台：

   • 在 Preferences -> Plug-In Development -> Target Platform 中选择 Maven for Android Eclipse 并点击 OK。可能需要一些时间来下载编译 m2e-android 所需的依赖项。

2. 项目的使用说明

项目结构

该项目由多个子模块组成，包括：

• 父 POM
• 核心 Eclipse 插件
• 测试套件
• Eclipse 功能
• 各种目标定义
• 更新站点

开发环境配置

• 确保您已经按照上述步骤配置了 Eclipse 和 Maven。
• 在 Eclipse 中导入项目后，您可以开始开发和测试 m2e-android 插件。

3. 项目 API 使用文档

API 概述

m2e-android 插件提供了对 Android Developer Tools (ADT) 的 Maven 支持。通过该插件，您可以在 Eclipse 中使用 Maven 来管理 Android 项目的依赖和构建过程。

主要 API

• Maven 支持：插件提供了对 Maven 的全面支持，包括依赖管理、构建和部署。
• Android SDK 集成：插件与 Android SDK 无缝集成，确保您可以在 Eclipse 中使用最新的 Android 工具和库。

使用示例

// 示例代码，展示如何在 Eclipse 中使用 m2e-android 插件
public class Example {
    public static void main(String[] args) {
        // 初始化 Maven 项目
        MavenProject project = new MavenProject();
        // 设置项目依赖
        project.addDependency("com.android.support:appcompat-v7:28.0.0");
        // 构建项目
        project.build();
    }
}

4. 项目安装方式

通过 Maven 安装

1. 克隆项目仓库：

   git clone https://github.com/rgladwell/m2e-android.git
   

2. 进入项目目录并执行安装命令：

   cd m2e-android
   mvn install
   

通过 Eclipse 安装

1. 在 Eclipse 中导入项目：

   • 选择 File -> Import...，然后选择 Maven -> Existing Maven Projects。
   • 选择 m2e-android 文件夹并导入项目。

2. 配置目标平台：

   • 在 Preferences -> Plug-In Development -> Target Platform 中选择 Maven for Android Eclipse。

通过以上步骤，您可以成功安装并使用 m2e-android 插件。