intellij community

IntelliJ IDEA 社群版

這些說明將幫助您從原始碼建立 IntelliJ IDEA 社群版，這是 IntelliJ 平台開發的基礎。以下約定將用於引用計算機上的目錄：

• <USER_HOME>是您的主目錄。
• <IDEA_HOME>是 IntelliJ 原始碼的根目錄。

取得 IntelliJ IDEA 社群版原始碼

IntelliJ IDEA Community Edition 原始碼可從github.com/JetBrains/intellij-community取得，方法是將 zip 檔案（基於分支）複製或下載到<IDEA_HOME>中。預設是master分支。

master 分支包含將用於建立 IntelliJ IDEA 的下一個主要版本的原始程式碼。舊版 IntelliJ IDEA 的分支名稱和內部版本號碼可以在內部版本號範圍頁面上找到。

這些 Git 操作也可以透過 IntelliJ IDEA 使用者介面完成。

速度提示：如果不需要完整的儲存庫歷史記錄，那麼使用淺克隆（ git clone --depth 1 ）將節省大量時間。

在 Windows 上：需要兩個 git 選項才能在 Windows 上檢查來源。由於它是 Windows 上 Git 問題的常見來源，因此可以全域設定這些選項（在克隆任何 intellij-community/android 儲存庫之前執行這些命令）：

• git config --global core.longpaths true
• git config --global core.autocrlf input

IntelliJ IDEA Community Edition 需要來自單獨的 Git 儲存庫的附加 Android 模組。若要複製這些儲存庫，請執行位於<IDEA_HOME>目錄中的getPlugins腳本之一。如果不需要完整的儲存庫歷史記錄，請使用--shallow參數。這些腳本克隆它們各自的主分支。執行這些腳本時，請確保您位於<IDEA_HOME>目錄中，以便將模組複製到<IDEA_HOME>目錄中。

• getPlugins.sh適用於 Linux 或 macOS。
• 適用於 Windows 的getPlugins.bat 。

注意：始終將intellij-community和android Git 儲存庫git checkout到相同的分支/標籤。

建構 IntelliJ 社群版

為 IntelliJ 平台建置和開發需要 IntelliJ IDEA Community Edition 或 IntelliJ IDEA Ultimate Edition 2023.2 或更高版本。

開啟 IntelliJ 原始碼進行建置

使用 IntelliJ IDEA檔案 |打開，選擇<IDEA_HOME>目錄。

• 如果 IntelliJ IDEA 顯示所需外掛程式缺失或過期的錯誤（例如 Kotlin），請啟用、升級或安裝該外掛程式並重新啟動 IntelliJ IDEA。

IntelliJ 建置配置

1. 建議使用 JetBrains Runtime 17 來編譯專案。當您第一次呼叫Build Project時，IntelliJ IDEA 應該建議自動下載它。
2. 如果Maven插件被停用，請新增指向<USER_HOME>/.m2/repository目錄的路徑變數「 MAVEN_REPOSITORY 」。
3. 確保您的電腦上至少有 8GB RAM。使用最低限度的 RAM，在編譯器設定中停用“並行編譯獨立模組”選項。隨著可用記憶體顯著增加，將「使用者本地建置進程堆大小」增加到 3000 - 這將大大減少編譯時間。

請注意，使用不含 JCEF的 JetBrains Runtime 變體非常重要。因此，如果由於某種原因jbr-17 SDK 指向使用 JCEF 安裝 JetBrains Runtime，您需要更改它：確保 IntelliJ IDEA 在內部模式下運行（透過將idea.is.internal=true新增至idea.properties檔案)，導航到項目結構| 中的jbr-17項SDK，按一下「瀏覽」按鈕，選擇「下載...」項，然後選擇版本 17 和供應商「JetBrains Runtime」。

建立 IntelliJ 應用程式原始碼

若要從原始程式碼建立 IntelliJ IDEA Community Edition，請選擇“建置”|“從主選單建立項目。

若要建置安裝包，請在<IDEA_HOME>目錄中執行installers.cmd指令。 installers.cmd可在 Windows 和 Unix 系統上運作。

建置安裝程式的選項會作為系統屬性傳遞給installers.cmd命令。您可以在 BuildOptions.kt 中找到可用屬性的列表

範例（僅應為 Linux/macOS 新增./ ）：

• 僅針對目前作業系統建立安裝程式： ./installers.cmd -Dintellij.build.target.os=current
• 增量建立原始程式碼（不要建置之前已經建置的內容）： ./installers.cmd -Dintellij.build.incremental.compilation=true

installers.cmd僅用於從命令列執行 OpenSourceCommunityInstallersBuildTarget。您可以直接從 IDEA 呼叫它，請參閱Build IDEA Community Installers (current OS)作為範例。

Docker化的建置環境

若要使用預先安裝的依賴項和工具在 Docker 容器內建置安裝包，請在<IDEA_HOME>目錄中執行以下命令（在 Windows 上，使用 PowerShell）：
docker run --rm -it -v ${PWD}:/community $(docker build -q . --target build_env)

運行 IntelliJ IDEA

若要執行從原始程式碼建置的 IntelliJ IDEA，請選擇“執行”|“從主選單運行。這將使用預先配置的運行配置“ IDEA ”。

若要在建置上執行測試，請將這些設定套用至執行 |編輯配置... |模板| JUnit配置選項卡：

• 工作目錄： <IDEA_HOME>/bin
• 虛擬機器選項：
  • -ea

您可以在 https://www.jetbrains.com/opensource/idea 找到其他有用的資訊。該網站的「貢獻程式碼」部分介紹如何為 IntelliJ IDEA 做出貢獻。

在 CI/CD 環境中運行 IntelliJ IDEA

若要在 IntelliJ IDEA 外部執行測試，請在<IDEA_HOME>目錄中執行tests.cmd指令。 tests.cmd可在 Windows 和 Unix 系統上運作。

運行測試的選項會作為系統屬性傳遞給tests.cmd命令。您可以在TestingOptions.kt 中找到可用屬性的列表

範例（僅應為 Linux/macOS 新增./ ）：

• 增量建構原始碼（不要建置之前已經建置的內容）： ./tests.cmd -Dintellij.build.incremental.compilation=true
• 執行特定測試： ./tests.cmd -Dintellij.build.test.patterns=com.intellij.util.ArrayUtilTest

tests.cmd僅用於從命令列執行 CommunityRunTestsBuildTarget。您可以直接從 IDEA 呼叫它，請參閱tests in community的範例。