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)”对话框将打开。在该对话框中,选择要包含在项目中的模块或数据,然后单击“确定”。
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号

意见反馈
返回顶部