这些说明将帮助您从源代码构建 IntelliJ IDEA 社区版,这是 IntelliJ 平台开发的基础。以下约定将用于引用计算机上的目录:
<USER_HOME>
是您的主目录。<IDEA_HOME>
是 IntelliJ 源代码的根目录。 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。getPlugins.bat
。注意:始终将intellij-community
和android
Git 存储库git checkout
到相同的分支/标签。
为 IntelliJ 平台构建和开发需要 IntelliJ IDEA Community Edition 或 IntelliJ IDEA Ultimate Edition 2023.2 或更高版本。
使用 IntelliJ IDEA文件 |打开,选择<IDEA_HOME>
目录。
<USER_HOME>/.m2/repository
目录的路径变量“ MAVEN_REPOSITORY ”。请注意,使用不带 JCEF的 JetBrains Runtime 变体非常重要。因此,如果由于某种原因jbr-17
SDK 指向使用 JCEF 安装 JetBrains Runtime,您需要更改它:确保 IntelliJ IDEA 在内部模式下运行(通过将idea.is.internal=true
添加到idea.properties
文件),导航到项目结构 | 中的jbr-17
项SDK,单击“浏览”按钮,选择“下载...”项,然后选择版本 17 和供应商“JetBrains Runtime”。
要从源代码构建 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 容器内构建安装包,请在<IDEA_HOME>
目录中运行以下命令(在 Windows 上,使用 PowerShell):
docker run --rm -it -v ${PWD}:/community $(docker build -q . --target build_env)
要运行从源代码构建的 IntelliJ IDEA,请选择“运行”|“从主菜单运行。这将使用预配置的运行配置“ IDEA ”。
要在构建上运行测试,请将这些设置应用于运行 |编辑配置... |模板| JUnit配置选项卡:
<IDEA_HOME>/bin
-ea
您可以在 https://www.jetbrains.com/opensource/idea 找到其他有用的信息。该网站的“贡献代码”部分介绍了如何为 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
的示例。