# 开发工具和插件使用指南
版本:v1.0
时间:2019-02-09
[TOC]
## [强制] Intellij IDEA
集成开发环境(IDE)统一使用Intellij IDEA,版本2016及以上,建议安装Intellij IDEA 2018
下载地址:http://www.jetbrains.com/idea/download/#section=windows
注册码:http://idea.lanyus.com/ 建议使用补丁或搭建本地服务器 //有钱买正版
- 下载JetbrainsIdesCrack-4.2.jar
- 复制JetbrainsIdesCrack-4.2.jar至Intellij 安装目录下的lib目录
```
Intellij 安装目录/JetBrains/lib/JetbrainsIdesCrack-4.2.jar
```
- 在Intellij 安装目录下的bin目录找到idea64.exe.vmoptions(64位)或idea.exe.vmoptions(32位)编辑
```
//在最后一行增加-javaagent:../lib/JetbrainsIdesCrack-4.2.jar
//并且这句话的前后空行
-Xms128m
-Xmx750m
-XX:ReservedCodeCacheSize=240m
-XX:+UseConcMarkSweepGC
-XX:SoftRefLRUPolicyMSPerMB=50
-ea
-Dsun.io.useCanonCaches=false
-Djava.net.preferIPv4Stack=true
-Djdk.http.auth.tunneling.disabledSchemes=""
-XX:+HeapDumpOnOutOfMemoryError
-XX:-OmitStackTraceInFastThrow
-javaagent:../lib/JetbrainsIdesCrack-3.4-release-enc.jar
```
- 重新打开Intellij,打开激活窗口,选择激活码方式,填入以下激活码(注: 内容可自行修改)
```
{"licenseId":"ThisCrackLicenseId",
"licenseeName":"随便填",
"assigneeName":"随便填",
"assigneeEmail":"邮箱,随便填",
"licenseRestriction":"描述信息,随便填",
"checkConcurrentUse":false,
"products":[
{"code":"II","paidUpTo":"2099-12-31"},
{"code":"DM","paidUpTo":"2099-12-31"},
{"code":"AC","paidUpTo":"2099-12-31"},
{"code":"RS0","paidUpTo":"2099-12-31"},
{"code":"WS","paidUpTo":"2099-12-31"},
{"code":"DPN","paidUpTo":"2099-12-31"},
{"code":"RC","paidUpTo":"2099-12-31"},
{"code":"PS","paidUpTo":"2099-12-31"},
{"code":"DC","paidUpTo":"2099-12-31"},
{"code":"RM","paidUpTo":"2099-12-31"},
{"code":"CL","paidUpTo":"2099-12-31"},
{"code":"PC","paidUpTo":"2099-12-31"},
{"code":"DB","paidUpTo":"2099-12-31"},
{"code":"GO","paidUpTo":"2099-12-31"},
{"code":"RD","paidUpTo":"2099-12-31"}
],
"hash":"2911276/0",
"gracePeriodDays":7,
"autoProlongated":false}
```
- 点击保存即可
## [强制] 阿里代码规约插件
阿里代码规约检查插件,是基于阿里Java开发规范的代码检查工具
1. 打开 File >> Settings >> Plugins 在搜索栏检索Alibaba, 点击安装

2. 安装完成在Intellij 工具栏出现以下按钮

3. 或者选择 tools >> 阿里编程规约

4. 运行代码检查,根据提示修改代码

## [强制] Check Style插件
Check Style代码格式检查
1. 打开 File >> Settings >> Plugins 在搜索栏检索CheckStyle, 点击安装

2. 配置ali check style文件 提供ali check style simple.xml 和 ali check style strict.xml,ali check style simple是必需的,有信息可以尝试ali check style strict

3. 在待检查文件内使用右键或者在底部工具栏选择checkStyle-IDE运行格式检查,在运行前可以使用快捷键全文件格式化一次


4. File >> Setting >> Editor >> Code Style 载入ali check style simple.xml 或者 ali check style strict.xml 可实现代码按照标准格式化

## [强制] Find Bugs插件
Java静态分析工具Find Bugs插件可以帮助发现一些隐藏的bug。需要说明的是,Find Bugs插件发现的bug有时可能会产生误告警
1. 打开 File >> Settings >> Plugins 在搜索栏检索Find Bugs, 点击安装

2. 安装完成后在底部会出现FindBugs-IDE 工具tab

3. 选择文件或者目录,点击FindBugs-IDE或者右键选择FindBugs,执行检查


4. File >> setting >> Other Setting >> Findbugs 可以对规则进行选择和设置

## [强制] Find Security插件
Find Security 是Find Bugs的一个配置选项,默认为选择,请确保出选项被选择

## [强制] JavaDoc插件
Intellij 自带JavaDoc工具,要生成JavaDoc文档需要完成以下两个配置
**JavaDoc模板**
常用的JavaDoc标签
标签 |
描述 |
示例 |
@author |
标识一个类的作者 |
@author description |
@version |
指定类的版本 |
@version info |
@date |
创建时间 |
@date date time |
@since |
标记当引入一个特定的变化时 |
@since release |
@deprecated |
指名一个过期的类或成员 |
@deprecated description |
@param |
说明一个方法的参数 |
@param parameter-name explanation |
@return |
说明返回值类型 |
@return explanation |
@throws |
和 @exception标签一样. |
The @throws tag has the same meaning as the @exception tag. |
@see |
指定一个到另一个主题的链接 |
@see class |
1. File >> Setting >> Plugins 安装JavaDoc2

2. File >> Setting >> Other Settings >> JavaDoc 设置class和interface的头说明

```
//Class
/**\n
* Describe class function detail.\n
* \n
* @author C.T \n
* @date <#if 1==1>${.now?string["yyyy-MM-dd HH:mm:ss"]}#if> \n
* @version v1.0 \n
* @since jdk1.8 \n
<#if element.typeParameters?has_content> * \n
#if>
<#list element.typeParameters as typeParameter>
* @param <${typeParameter.name}> the type parameter\n
#list>
*/
//Interface
/**\n
* Describe interface function detail.\n
* \n
* @author C.T \n
* @date <#if 1==1>${.now?string["yyyy-MM-dd HH:mm:ss"]}#if> \n
* @version v1.0 \n
* @since jdk1.8 \n
<#if element.typeParameters?has_content> * \n
#if>
<#list element.typeParameters as typeParameter>
* @param <${typeParameter.name}> the type parameter\n
#list>
*/
```
3. 通过JavaDoc的快捷键或者generator工具可以自动生成JavaDoc,生成时支持一次全部生成和选择指定对象生成



**运行时参数配置**
1. Tools >> Generate JavaDoc

2. 选择范围以及设置运行参数

```
//中文
Locale : zh_CN
//encoding UTF-8 -charset UTF-8 解决中文编码问题
//-windowtitle "接口文档" 设置文档title
//-link http://docs.Oracle.com/javase/8/docs/api //指定API版本是jdk8
Other command line arguments: encoding utf-8 -charset utf-8 -tag date:a:”date” -link http://docs.Oracle.com/javase/8/docs/api
```
3. 点击 OK 运行

## [强制] Apiggs插件
Apiggs是一款基于JavaDoc的restful接口文档生成工具
install
```
com.github.fengyuchenglun
apiggs-maven-plugin
1.0.10
compile
apiggs
false
CosmoController
CosmoController
```
可选Option
```
id 项目id,生成id.html文件
title 文档标题
description 文档描述
production 输出文件夹,默认为 apiggs
out 输出目录,默认为 target
source 源码目录
dependency 源码依赖的代码目录,以逗号隔开
jar 源码依赖的jar包目录,以逗号隔开
ignore 忽略某些类型
version 文档版本号
```
可参考后台框架DEMO工程中的例子
## [推荐] TestNG插件
TestNg单元测试框架,安装TestNg插件,可以快速,自动创建TestNg单元测试类
1. File >> Settings >> Plugins 在搜索栏检索TestNG, 点击安装

注意:这个插件目前支持TestNG5.6 如果Maven中使用版本与此有差异,手动调整自动生成的代码
2. 在需要写单元测试的类,右键选择generator >> test 完成相关配置即可自动生成,以Test结尾的java单元测试类

## [强制] Git插件
Git作为分布式版本管理系统
1. 下载并安装Git,参考https://git-scm.com/book/zh/v2/%E8%B5%B7%E6%AD%A5-%E5%AE%89%E8%A3%85-Git
2. 在intellij设置Git信息

3. 选择文件,右键使用Git UI操作完成Git操作

4. 安装Commit Message Template确保提交使用统一模板

5. 设置模板
copy
```
():