材料:
Atlassian Plugin SDK
IDE/ text edtior
2990端口未占用
JDK
XML知识
Velocity知识
步骤:
一、在系统安装Atlassian SDK- 下载SDK最新版本
Atlassian Marketplace: Atlassian Plugin SDK - Mac OS X
- 双击安装
- 配置环境变量
在用户变量path中添加sdk的bin路径
添加变量M2_HOME指向sdk中的maven路径
- 检验是否安装成功:
在cmd中执行 atlas-version。若安装成功,会显示sdk的信息。如下:
二、创建项目
- 打开cmd进入存放创建项目的目录
- 输入命令生成插件项目: atlas-create-jira-plugin
- 根据提示填写相关信息
- 确认配置:Y
- 生成项目
三、运行创建的项目
进入项目根目录,执行: atlas-run
首次运行时,需要下载webapp之类的,可能会耗时比较长,之后就不会了。
运行无误后,在浏览器输入http://loaclhost:2990.默认用户名和密码为:admin/admin
点击插件管理栏,可以在插件管理中看到自定义的插件。当然此时插件中还没有什么内容,需要根据需求进行修改。
按Ctrl+C或者Ctrl+D可以关闭jira。
四、修改相关信息
修改组织信息,在pom.xml中修改<organization>节点信息即可。
需要添加Jira自定义菜单的话,在atlassian-plugin.xml中进行修改,也可以在cmd创建项目时就加进去。若是在后期使用cmd添加组件,则在项目路径执行:atlas-create-jira-plugin-model,然后选择相应的model配置相关信息。
五、其他常用命令
atlas-mvn package -- 打包命令,打包成功的jar包可以直接当做插件上传到jira
atlas-clean -- clean命令
atlas-debug -- 调试命令,此时对应的端口为5005
atlas-run -v 6.3.6 -- 运行在6.3.6版本(最好将jira-api改为对应版本,避免不同版本在处理方式上的不同造成的影响)
六、注意事项
见下一篇博文。会单独整理出来,并在实际开发中不断补充。