IDEA插件开发之环境搭建

基于IntelliJ Platform Plugin搭建环境

步骤

File->New->Project
选择IntelliJ Platform Plugin

如果你这里没有SDK环境，则添加一个SDK环境，选择自己的idea的安装的根目录即可。

展示效果

基于Gradle搭建环境

步骤

File->New->Project
选择Gradle

next

进来以后大概是这样的一个界面，然后gradle会自动build项目，下载相关的依赖。(可能会失败)

遇到的问题一，依赖ideaIC-2020.1.1.zip文件

build过程中下载ideaIC-2020.1.1.zip文件(根据不同的idea插件开发版本这个文件也会随之改变的)，但是这个文件超特么的大500多M🙂🙂🙂，大不是问题，但是太慢了，我中途还出超时出错过，因此不我希望你们也遇到这个问题，错误大概是这样的

A problem occurred configuring root project 'myplugin2'.
> Could not resolve all files for configuration ':detachedConfiguration1'.
   > Could not download ideaIC-2020.1.1.zip (com.jetbrains.intellij.idea:ideaIC:2020.1.1)
      > Could not get resource 'https://cache-redirector.jetbrains.com/www.jetbrains.com/intellij-repository/releases/com/jetbrains/intellij/idea/ideaIC/2020.1.1/ideaIC-2020.1.1.zip'.
         > Read timed out	

但是，这个等待的时间不是白白的浪费了，至少我知道错误在哪，下载什么文件失败的，原来是下载这个路径下的这个zip文件(而且通过这个URL也知道了jetbrains的release版本仓库在哪个位置了)，于是ctrl+c 这个url，默默打开我的迅雷X，开启了立即下载模式

等下载完成大概是这样的，507 MB (532,523,505 字节)，果然厉害，这个就是IDEA2020.1.1的社区版！

但是问题来了我下载下来的文件放在哪呢，gradle的自动编译才能用我的这个zip包呢？
于是牵扯到了gradle的本地缓存了。

1. 打开系统盘下当前用户的.gradle目录，进入.gradle\caches\modules-2\files-2.1目录，即为缓存文件的目录。但是我怎么知道是哪个具体的目录下呢？
2. 这个时候又是上面这个报错的url的地方，仔细看com/jetbrains/intellij/idea/ideaIC/2020.1.1/ideaIC-2020.1.1.zip这一段，这不就知道是哪个目录了,于是进入到.gradle\caches\modules-2\files-2.1\com.jetbrains.intellij.idea\ideaIC\2020.1.1目录，
3. 再一看他是这样的ff8c1b826417ce9d8a537b41e64d0253be9dbac0目录名称(你的可能不是这样的)，我去，这个应该是加密过的，但是是什么加密呢？,经过了解知道了这个是SHA1加密，且是对文件进行SHA1的加密生成的唯一字符串，但是windows上没有这个命令，在线SHA1也太麻烦了，还要上传文件，于是想到了Java的API，还有就是通过git hash命令行来实现。
   
   把我们的文件ideaIC-2020.1.1.zip先临时拷贝到这个目录。运行sha1sum.exe ideaIC-2020.1.1.zip命令，生成唯一的唯一字符串（用来校验文件的完整性），这样就拿到这个640aff4c23a001e5595ee654670d774e9efcd118目录名
   
4. 接下来在2020.1.1目录下，新建目录640aff4c23a001e5595ee654670d774e9efcd118，将ideaIC-2020.1.1.zip移动进去即可。这样就完成了手动导入依赖的过程😎😎😎

遇到的问题二，gradle build过程中堆栈溢出。

描述如下

A build operation failed.
 Java heap space > 
 	Java heap space

解决方法，在IDEA项目根目录下，新建文件gradle.properties，添加如下内容，变更gradle Jvm参数

org.gradle.jvmargs=-Xmx2024m -XX:MaxPermSize=512m

然后就开开心心手动构建环境即可完成。

总结

搭建IDEA插件开发环境方式很多，看个人开发喜好，官方建议使用gradle的方式搭建比较全面。
搭建环境过程并不是一帆风顺，也花费了挺多挺多的时间，其他人得解答也只是片段，并不能完美解决我的问题，于是才有了这篇文章，后续打算开发一个自己的插件，来解决自己的问题，到时候再记录把。

---

2020年10月21日新增插件的一些说明

ideaVersion=2020.2.3
ideaType=IC
javaVersion=11
javaTargetVersion=11
sources=true
isEAP=false

在build.gradle中指定插件的一些配置属性，可以指定本地的文件

// See https://github.com/JetBrains/gradle-intellij-plugin/
intellij {

    //IntelliJ 平台的属性
    //默认插件名称为$project.name
    pluginName pluginFullname

    //类型社区版IC还是最终版IU
    type ideaType

    //localPath和version不能同时使用
    version ideaVersion

    //可以指定本地已安装的ide路径,localPath和version不能同时使用
    //使用本地的好处就是无需从服务器重新下载ide
    //localPath="<本地idea的绝对路径(根目录)>"

    // ide需绑定的插件 1、pluginId:version 2、project(':projectName')
    // plugins

    //Building Properties
    //Run/Debug IDE Properties

    //Infrastructure Properties
    //是否下载idea源码
    downloadSources Boolean.valueOf(sources)

    //发布版本是否只停留在一个版本中
    sameSinceUntilBuild Boolean.valueOf(isEAP)

}