Gradle项目的创建与配置

创建Gradle项目

1. 启动“新建项目向导（New Project wizard）”。如果当前 IntelliJ IDEA 中未打开任何项目，请单击“欢迎界面”上的 Create New Project；否则，请从主菜单选择：File | 新增| 项目（File | New | Project）。
2. 从左侧的选项中选择：Gradle。
3. 指定项目 SDK 和附加的框架或库（IntelliJ IDEA 将相应的插件添加到 build.gradle 文件中）。点击“下一步”。
4. 在向导的下一页上，指定与 Maven 命名约定相似的字段 。如果您决定将项目部署到 Maven 存储库，这些设置可能会有所帮助。您指定的字段被添加到build.gradle 文件中。
   • GroupId - 新项目的 groupId。如果您打算在本地部署项目，则可以省略此字段。
   • ArtifactId - artifactId，将其添加为新项目的名称。
   • Version - 新项目的 version。默认情况下，该字段是自动指定的。
   如果指定了父级 Gradle 项目，则可以从父级继承指定的字段（单击“继承（Inherit）”）。点击“下一步”。
5. 在该向导的下一页中，为项目配置自动导入（Auto-import），源集（source-sets）和 Gradle 版本。您可以选择“外部存储生成的项目文件（Store generated project files externally）”选项，以便生成的 .iml 和库文件存储在 idea.system.path 目录中，而不是 .idea 目录中。通过版本控制共享您的项目可能会有所帮助。您也可以选择合适的选项来分组项目中的模块。点击“下一步”。
6. 指定名称和位置设置。点击“完成”。

您还可以查看一个快速的视频教程，介绍如何开始使用 Gradle 项目。

配置项目的Gradle版本

IntelliJ IDEA 允许您在创建或导入 Gradle 项目时使用不同的选项来配置 Gradle 版本。您可以使用默认的 Gradle 包装器，使用 Gradle 包装器作为任务，或配置本地Gradle 分配器。

提示：在 Gradle 项目工具窗口中选择 settings，可以快速访问 Gradle 设置页面。

1. 在创建或导入 Gradle 项目时，在 Gradle 设置页面上，选择以下选项之一：
   • 使用默认的 Gradle 包装器（推荐） - 选择此选项以使用 Gradle 包装器。在这种情况下，您将 Gradle 版本的更新委托给 Gradle，并为构建获取自动 Gradle 下载。它还可以让您使用精确的 Gradle 版本进行构建。Gradle 版本保存在项目的 Gradle 目录的 gradle-wrapper.properties 文件中。我们建议您使用此选项来消除项目中的任何 Gradle 版本问题。
   • 使用 gradle 任务配置 - 选择此选项以根据 wrapper任务配置来配置 Gradle 包装器。如果您不想使用该 gradle-wrapper.properties 文件出于某种原因，或者想要控制希望项目使用哪个 Gradle 版本，可能会很方便。请注意，如果您最初使用默认的 Gradle 包装选项，然后在更改任务中的任何内容（例如，更改 Gradle 版本）时决定使用 Gradle 包装任务配置，则不需要手动运行包装任务，因为 gradle-wrapper.properties 文件更新在导入过程中由 IntelliJ IDEA 隐式完成。另外，请注意，例如，如果您在项目中使用 VCS，并且每个团队成员通过 gradle 同步项目，则 gradle/wrapper/gradle-wrapper.properties 文件将被更新，如果使用这种类型的包装器配置可能会出现不一致。
   • 使用Gradle 本地分发 - 如果您想手动下载并使用特定的 Gradle 版本，请选择此选项。指定 Gradle 安装和 JVM 的位置，在您导入指定的 Gradle 项目和执行其任务时，IntelliJ IDEA 将在该位置运行 Gradle。
2. 按“OK”（在向导中，按“Next”）。

将新的Gradle模块添加到现有项目

您可以将 Gradle 模块添加到您已经在其中工作的项目。

1. 在一个项目中，在主菜单上选择：File | 新增| 模块（File| New | Module）以打开“新建模块（New Module）”向导。
2. 如果现有项目不是 Gradle 项目，那么添加模块的过程与创建新的 Gradle 项目相同。如果现有项目是 Gradle 项目，那么添加新模块的过程会更短。您需要在ArtifactId 字段中指定您的模块的名称。其余信息会自动添加，您可以使用默认设置或根据您的偏好进行更改。另外，请注意，默认情况下，将“字段添加为（Add as module to）”字段将显示您尝试添加模块的项目的名称。你可以点击 来选择一个不同的名称，如果您有其他链接的Gradle项目。

从Gradle模型导入项目

1. 启动“新建项目（New Project）”向导。如果当前 IntelliJ IDEA 中未打开任何项目，请单击欢迎界面上的“导入项目（Import Project）”。否则，在主菜单选择：File | 新增| 来自现有来源项目（File | New | Project from Existing Sources）。请注意，您也可以从主菜单选择：File | 打开（File | Open），并选择build.gradle 文件或包含该 build.gradle 文件的目录。IntelliJ IDEA 将导入一个 Gradle 项目，即使该项目之前未打开或导入过。
2. 在打开的对话框中，选择包含您要导入的项目的目录或包含 Gradle 项目描述（build.gradle）的文件。点击“确定”。
3. 在“导入项目（Import Project）”向导的第一页上，在从外部模型导入项目中，选择 Gradle，然后单击“下一步”。（如果 IntelliJ IDEA 已经猜测到了您正在导入的内容，则不会显示此页面。）
4. 在“导入项目（Import Project）”向导的下一页上，指定 Gradle 项目设置，这与您创建 Gradle 项目时的设置相同。另外，指定以下全局 Gradle 设置：
   • 离线工作（Offline work）- 使用此复选框在离线模式下使用 Gradle。在这种情况下，Gradle 将使用缓存中的依赖关系。Gradle 不会尝试访问网络来执行依赖关系解析。如果所需的依赖关系不存在于缓存中，则构建执行将失败。
   • 服务目录路径（Service directory path）- 使用此字段覆盖默认的 Gradle 主目录位置目录。
   • Gradle VM 选项（Gradle VM options）- 使用此字段为您的 Gradle 项目指定 VM 选项。
   点击“完成”。

请注意，如果您使用该gradle idea命令生成 Gradle 项目，则可能会出现错误。我们建议您改为导入您的项目。

导入Gradle模块

1. 您可以通过以下其中一种方式启动模块的导入：
   • 从主菜单中，选择：文件| 新增| 来自现有源的模块（File | New | Module from Existing Sources）。
   • 在“项目结构（Project Structure）”对话框的“模块（Module）”页面上，单击 图标并选择“导入模块（Import Module）”。
   • 在 Gradle 项目工具窗口的工具栏上，单击 图标。
2. 在打开的对话框中，选择要导入的模块，然后单击“确定”。
3. 如有必要，请执行本部分中所述的步骤 ，然后单击“完成”。
4. 如果您有多模块项目，则“选择要导入的项目数据（Select Project Data to Import）”对话框将打开。在该对话框中，选择要包含在项目中的模块或数据，然后单击“确定”。