Gradle項目的創(chuàng)建與配置

創(chuàng)建Gradle項目

1. 啟動“新建項目向?qū)В∟ew Project wizard）”。如果當前 IntelliJ IDEA 中未打開任何項目，請單擊“歡迎界面”上的 Create New Project；否則，請從主菜單選擇：File | 新增| 項目（File | New | Project）。
2. 從左側(cè)的選項中選擇：Gradle。
3. 指定項目 SDK 和附加的框架或庫（IntelliJ IDEA 將相應的插件添加到 build.gradle 文件中）。點擊“下一步”。
4. 在向?qū)У南乱豁撋?，指定與 Maven 命名約定相似的字段 。如果您決定將項目部署到 Maven 存儲庫，這些設(shè)置可能會有所幫助。您指定的字段被添加到build.gradle 文件中。
   • GroupId - 新項目的 groupId。如果您打算在本地部署項目，則可以省略此字段。
   • ArtifactId - artifactId，將其添加為新項目的名稱。
   • Version - 新項目的 version。默認情況下，該字段是自動指定的。
   如果指定了父級 Gradle 項目，則可以從父級繼承指定的字段（單擊“繼承（Inherit）”）。點擊“下一步”。
5. 在該向?qū)У南乱豁撝校瑸轫椖颗渲米詣訉耄ˋuto-import），源集（source-sets）和 Gradle 版本。您可以選擇“外部存儲生成的項目文件（Store generated project files externally）”選項，以便生成的 .iml 和庫文件存儲在 idea.system.path 目錄中，而不是 .idea 目錄中。通過版本控制共享您的項目可能會有所幫助。您也可以選擇合適的選項來分組項目中的模塊。點擊“下一步”。
6. 指定名稱和位置設(shè)置。點擊“完成”。

您還可以查看一個快速的視頻教程，介紹如何開始使用 Gradle 項目。

配置項目的Gradle版本

IntelliJ IDEA 允許您在創(chuàng)建或?qū)?Gradle 項目時使用不同的選項來配置 Gradle 版本。您可以使用默認的 Gradle 包裝器，使用 Gradle 包裝器作為任務，或配置本地Gradle 分配器。

提示：在 Gradle 項目工具窗口中選擇 settings，可以快速訪問 Gradle 設(shè)置頁面。

1. 在創(chuàng)建或?qū)?Gradle 項目時，在 Gradle 設(shè)置頁面上，選擇以下選項之一：
   • 使用默認的 Gradle 包裝器（推薦） - 選擇此選項以使用 Gradle 包裝器。在這種情況下，您將 Gradle 版本的更新委托給 Gradle，并為構(gòu)建獲取自動 Gradle 下載。它還可以讓您使用精確的 Gradle 版本進行構(gòu)建。Gradle 版本保存在項目的 Gradle 目錄的 gradle-wrapper.properties 文件中。我們建議您使用此選項來消除項目中的任何 Gradle 版本問題。
   • 使用 gradle 任務配置 - 選擇此選項以根據(jù) wrapper任務配置來配置 Gradle 包裝器。如果您不想使用該 gradle-wrapper.properties 文件出于某種原因，或者想要控制希望項目使用哪個 Gradle 版本，可能會很方便。請注意，如果您最初使用默認的 Gradle 包裝選項，然后在更改任務中的任何內(nèi)容（例如，更改 Gradle 版本）時決定使用 Gradle 包裝任務配置，則不需要手動運行包裝任務，因為 gradle-wrapper.properties 文件更新在導入過程中由 IntelliJ IDEA 隱式完成。另外，請注意，例如，如果您在項目中使用 VCS，并且每個團隊成員通過 gradle 同步項目，則 gradle/wrapper/gradle-wrapper.properties 文件將被更新，如果使用這種類型的包裝器配置可能會出現(xiàn)不一致。
   • 使用Gradle 本地分發(fā) - 如果您想手動下載并使用特定的 Gradle 版本，請選擇此選項。指定 Gradle 安裝和 JVM 的位置，在您導入指定的 Gradle 項目和執(zhí)行其任務時，IntelliJ IDEA 將在該位置運行 Gradle。
2. 按“OK”（在向?qū)е校础癗ext”）。

將新的Gradle模塊添加到現(xiàn)有項目

您可以將 Gradle 模塊添加到您已經(jīng)在其中工作的項目。

1. 在一個項目中，在主菜單上選擇：File | 新增| 模塊（File| New | Module）以打開“新建模塊（New Module）”向?qū)А?/li>
2. 如果現(xiàn)有項目不是 Gradle 項目，那么添加模塊的過程與創(chuàng)建新的 Gradle 項目相同。如果現(xiàn)有項目是 Gradle 項目，那么添加新模塊的過程會更短。您需要在ArtifactId 字段中指定您的模塊的名稱。其余信息會自動添加，您可以使用默認設(shè)置或根據(jù)您的偏好進行更改。另外，請注意，默認情況下，將“字段添加為（Add as module to）”字段將顯示您嘗試添加模塊的項目的名稱。你可以點擊 來選擇一個不同的名稱，如果您有其他鏈接的Gradle項目。

從Gradle模型導入項目

1. 啟動“新建項目（New Project）”向?qū)?。如果當?IntelliJ IDEA 中未打開任何項目，請單擊歡迎界面上的“導入項目（Import Project）”。否則，在主菜單選擇：File | 新增| 來自現(xiàn)有來源項目（File | New | Project from Existing Sources）。請注意，您也可以從主菜單選擇：File | 打開（File | Open），并選擇build.gradle 文件或包含該 build.gradle 文件的目錄。IntelliJ IDEA 將導入一個 Gradle 項目，即使該項目之前未打開或?qū)脒^。
2. 在打開的對話框中，選擇包含您要導入的項目的目錄或包含 Gradle 項目描述（build.gradle）的文件。點擊“確定”。
3. 在“導入項目（Import Project）”向?qū)У牡谝豁撋?，在從外部模型導入項目中，選擇 Gradle，然后單擊“下一步”。（如果 IntelliJ IDEA 已經(jīng)猜測到了您正在導入的內(nèi)容，則不會顯示此頁面。）
4. 在“導入項目（Import Project）”向?qū)У南乱豁撋?，指?nbsp;Gradle 項目設(shè)置，這與您創(chuàng)建 Gradle 項目時的設(shè)置相同。另外，指定以下全局 Gradle 設(shè)置：
   • 離線工作（Offline work）- 使用此復選框在離線模式下使用 Gradle。在這種情況下，Gradle 將使用緩存中的依賴關(guān)系。Gradle 不會嘗試訪問網(wǎng)絡(luò)來執(zhí)行依賴關(guān)系解析。如果所需的依賴關(guān)系不存在于緩存中，則構(gòu)建執(zhí)行將失敗。
   • 服務目錄路徑（Service directory path）- 使用此字段覆蓋默認的 Gradle 主目錄位置目錄。
   • Gradle VM 選項（Gradle VM options）- 使用此字段為您的 Gradle 項目指定 VM 選項。
   點擊“完成”。

請注意，如果您使用該gradle idea命令生成 Gradle 項目，則可能會出現(xiàn)錯誤。我們建議您改為導入您的項目。

導入Gradle模塊

1. 您可以通過以下其中一種方式啟動模塊的導入：
   • 從主菜單中，選擇：文件| 新增| 來自現(xiàn)有源的模塊（File | New | Module from Existing Sources）。
   • 在“項目結(jié)構(gòu)（Project Structure）”對話框的“模塊（Module）”頁面上，單擊 圖標并選擇“導入模塊（Import Module）”。
   • 在 Gradle 項目工具窗口的工具欄上，單擊 圖標。
2. 在打開的對話框中，選擇要導入的模塊，然后單擊“確定”。
3. 如有必要，請執(zhí)行本部分中所述的步驟 ，然后單擊“完成”。
4. 如果您有多模塊項目，則“選擇要導入的項目數(shù)據(jù)（Select Project Data to Import）”對話框?qū)⒋蜷_。在該對話框中，選擇要包含在項目中的模塊或數(shù)據(jù)，然后單擊“確定”。