入门指南

注意：如果不具备JAVA WEB开发的基础知识，需要自行学习，如不能根据本文档顺利入门，则需要阅读 新手必看

1、安装JDK

下载地址，需要的JDK版本至少为8以上

2、安装NetBeans IDE（使用其他IDE也可以）

执行此步骤之前确保系统中已经安装好JDK8! 下载地址，如果你希望用eclipse可结合 如何在eclipse下开发（给不用Netbeans的朋友准备的 ） 一起看。在安装NetBeans的时候，点击定制... -> 选中Apache Tomcat -> 确定

3、配置tomcat支持中文URL

在安装NetBeans的时候，默认的Tomcat位置是 C:\Program Files\Apache Software Foundation\Apache Tomcat 7.0.34 ，修改 C:\Program Files\Apache Software Foundation\Apache Tomcat 7.0.34\conf\server.xml 文件，在所使用的端口（默认8080）对应的Connector上增加属性URIEncoding="UTF-8"

4、安装mysql，字符编码设置为utf-8，用户名和密码设置为root

下载地址 ,很多人在这里安装mysql的时候就是没有设置字符编码为utf-8

5、创建GitHub账号

在页面 GitHub申请账号

6、登陆GitHub，创建APDPlat的派生项目，即Fork

在页面 APDPlat的右上角点击Fork按钮

7、安装并配置Git客户端

Git下载地址，选择Git for Windows，安装完成后，所有程序 -> Git -> Git Bash，打开命令提示窗口

TortoiseGit下载地址，配置请看TortoiseGit密钥的配置

输入以下命令配置个人信息

git config --global user.name "yourname"

git config --global user.email "[email protected]"

8、在本地生成公钥和私钥并把公钥信息加入GitHub以便把代码提交到GitHub

执行5个步骤： 参考这里

如果在复制公钥的时候出现“clip: command not found”，则找到在生成公钥时指定的路径（如win7下用户为ysc则默认为：C:\Users\ysc.ssh）下的id_rsa.pub文件，用文本编辑工具写字板打开复制即可

9、使用NetBeans检出代码

打开NetBeans，团队开发 -> Git -> 克隆... -> 资源库URL：github.com:yourAccount/APDPlat.git -> 用户名：git -> 选择私有密钥文件并输入密码短语 -> master -> 选择本地保存目录（选择的目录所在的路径不能有空格）-> 检出完成后选中：打开所需的项目 -> 打开

10、在APDPlat上单击右键，选择构建，控制台输出构建信息，从网上下载依赖的Jar文件，直等到提示BUILD SUCCESS为止

11、如果mysql数据库的用户名和密码不是root，则打开APDPlat_Web -> 其他源 -> src/main/resources -> db.local.properties，在这个文件里面可以设置数据库的类型以及用户名和密码

12、点击Netbeans菜单 工具 -> 服务器 -> Apache Tomcat 7.0.34 -> 平台 -> VM选项 -> 输入：-XX:-UseSplitVerifier -Xms256m -Xmx1000m -XX:MaxNewSize=256m -XX:MaxPermSize=256m

13、在APDPlat_Web上单击右键，选择运行 -> 选择部署服务器 -> Apache Tomcat，控制台输出构建信息，生成可运行的War包，启动tomcat并弹出网页登陆界面，访问地址为：http://localhost:8080/APDPlat_Web

14、在APDPlat_Web -> 源包 -> util -> AuthorizationUtils.java文件中，把code的值设置为网页激活界面提示的机器码，单击右键运行文件，使用输出窗口中输出的注册码，在浏览器中激活系统（也可在http://localhost:8080/APDPlat_Web/public/reg.jsp计算激活码）

15、将注册码添加到文件APDPlat_Web/src/main/resources/licences/apdplat.licence中，以后清理并构建之后就不用再次激活系统

16、使用默认的用户名admin和密码admin登陆系统，如果在IE下出现点击左边功能菜单没有响应的情况，则点击浏览器地址栏右边的兼容性按钮

恭喜你！