MaxKey/docs/development.md

开发指南

开发工具

JDK 1.8 +

Gradle 6.0 +

eclipse-jee-2019-12 +

Tomcat 9 +

MySQL Server 5.5 +

程序目录

	<tr>
		<td></td>
		<td>settings.gradle</td>
		<td></td>
		<td></td>
		<td>项目引入</td>
	</tr>
	<tr>
		<td></td>
		<td>gradleSetEnv.bat</td>
		<td></td>
		<td></td>
		<td>JDK及Gradle路径配置，用于构建脚本，需要开发人员自行配置</td>
	</tr>
	<tr>
		<td></td>
		<td>gradleBuildClean.bat</td>
		<td></td>
		<td></td>
		<td>清除历史构建版本</td>
	</tr>
	<tr>
		<td></td>
		<td>gradleBuildRelease.bat</td>
		<td></td>
		<td></td>
		<td>构建新版本</td>
	</tr>
	<tr>
		<td></td>
		<td>gradleIDEClean.bat</td>
		<td></td>
		<td></td>
		<td>清除IDE的设置</td>
	</tr>
	<tr>
		<td></td>
		<td>gradleIDETask.bat</td>
		<td></td>
		<td></td>
		<td>设置IDE</td>
	</tr>		
	</tbody>

MaxKey	一级目录	二级目录	三级目录	说明
	README.md			关于MaxKey项目
	LICENSE			许可证
	database-sql			版本对应MYSQL
	docs			项目网站
	gradle			gradle的配置
	maxkey-authentications			登录认证
	maxkey-client-sdk			JAVA集成使用SDK
	maxkey-core			基础
	maxkey-dao			数据库访问
	maxkey-lib			使用jar包
	maxkey-protocols			认证协议实现
		maxkey-protocol-authorize		认证协议实现
		maxkey-protocol-cas		CAS认证协议实现
		maxkey-protocol-desktop		桌面认证实现模拟键盘输入登录
		maxkey-protocol-extendapi		扩展API实现
		maxkey-protocol-formbased		Formbased实现
		maxkey-protocol-oauth-2.0		oauth-2.0实现
		maxkey-protocol-saml-2.0		saml-2.0实现
		maxkey-protocol-tokenbased		tokenbased实现
	maxkey-web-manage			管理系统
	maxkey-web-manage			管理系统
	maxkey-web-maxkey			认证系统
	build.gradle			工程构建及版本控制
	gradle.properties			版本参数配置

问题及解决

问题1

“A cycle was detected in the build path of project: XXX”

解决方法：

Eclipse Menu -> Window -> Preferences... -> Java -> Compiler -> Building -> Building path problems -> Circular dependencies -> 将Error改成Warning

问题2

Access restriction

解决方案：

Eclipse Menu -> Window -> Preferences... -> Java -> Compiler -> Errors/Warnings界面的Deprecated and restricted API下。把Forbidden reference (access rules): 的规则由默认的Error改为Warning即可。