快玩跑胡子项目说明

环境配置

【游戏引擎】：Cocos-2dx v3.10
【环境】：Cocos Studio v3.10
【Android】：需安装SDK、NDK、ANT、JDK
# 版本可参考本地配置 SDK(10/20/22)、NDK（r10e）、ANT(1.9.9)、JDK（1.8.0_45 注意是jdk而不是jre）
【IOS】：XCode即可
【IDE】：自行选择即可。Android Studio/XCode/Sublime/Atom/VS Code等……

【MongoDB】:
数据库名：KuaiWanPaoHuZi
集合(Collections)：
-> serverentity：存放可连接的游戏服务器IP:端口，如{ "ip" : "114.119.11.190", "port" : "5001", "state" : "0" }
-> userinfoentity：存放用户信息

项目目录说明

./KuaiWanPaoHuZiClient                            // 游戏前端代码
./cocosUI                                         // 前端UI资源文件，暂未使用
./KuaiWanPaoHuZiClient/cocosstudio                // 游戏UI CocosStudio资源
./server                                          // 服务器端源码
./Version                                         // 热更新版本工具
./KuaiWanPaoHuZiClient/frameworks/runtime-src/proj.android // Android运行时
./KuaiWanPaoHuZiClient/frameworks/runtime-src/proj.ios_mac // IOS运行时

需修改配置信息

Android配置

/KuaiWanPaoHuZiClient/frameworks/runtime-src/proj.android/目录下的3个文件需要修改：
1、ant.properties

文件中的key.store参数路径应相应改为本机KuaiWanPaoHuZiClient.keystore路径。如：

key.store=/Users/jerrywong/project/paohuzi/KuaiWanPaoHuZiClient/publish/KuaiWanPaoHuZiClient.keystore

2、local.properties

文件中的sdk.dir参数路径应相应改为本机sdk的路径。如：

sdk.dir=/Users/jerrywong/Library/Cocos/down/sdk

3、project.properties

修改Android发布目标版本：修改文件中的target参数即可，如：

target=android-10

当然，也可在Cocos Studio的项目设置中设定；但需注意引擎必须使用跑胡子目录下的引擎。

设置系统环境变量

ANT_ROOT = ANT安装目录
ANDROID_SDK_ROOT = ANDROID SDK安装目录
NDK_ROOT = NDK安装目录
# Mac下，通过加入到`~/.bash_profile`中，并执行命令`source ~/.bash_profile`更新配置即可
# Windows下，自行百度吧……

PS：变量设置参考文件/KuaiWanPaoHuZiClient/frameworks/runtime-src/BuildAPK_Debug.sh

打包APP

打包Android客户端

确认上方的Android配置已设置完毕后，可选择以下任一方法进行打包发布：
1、按操作系统执行如下脚本，需注意文件中的参数配置，及环境变量的设置等：
MAC系统： 进入runtime-src目录下，执行BuildAPK_Debug/Release.sh可生成对应版本的APK安装包
Windows系统：windows-build-apk.bat

2、通过命令行/终端进入项目客户端目录KuaiWanPaoHuZiClient下，执行命令cocos compile -p android

打包IOS客户端

1、使用XCode打开，设置签名等信息后，选择要发布的平台，运行发布即可。
2、进入项目客户端目录KuaiWanPaoHuZiClient下，执行命令cocos compile -p ios

Git命令参考

忽略已在仓库中指定文件的更新及修改：git update-index --assume-unchanged /path/file。
恢复跟踪：git update-index --no-assume-unchanged /path/file

注意事项

以下文件因环境导致的配置信息修改，请不要提交：

./KuaiWanPaoHuZiClient
../frameworks/runtime-src/proj.android/ant.properties
../frameworks/runtime-src/proj.android/local.properties
../frameworks/runtime-src/proj.android/project.properties
../frameworks/runtime-src/BuildAPK_Debug.sh
../frameworks/runtime-src/BuildAPK_Release.sh
../frameworks/runtime-src/proj.android/assets/
...

服务端说明

启动服务器：执行./server/start.sh (其实就是启动AppServer.js和AppHttpServer.js两个服务)
关闭进程：执行./server/stop.sh (注意设置文件中Node进程pid)
查看当前Node进程：ps | grep node
结束进程：kill