网狐荣耀版手机端源码编译完整指南

概述

网狐荣耀版是基于Cocos2d-x引擎开发的手机游戏客户端，本文提供从源码到可执行文件的完整编译流程和配置说明。

环境准备

• Cocos2d-x 开发环境

• Android SDK/NDK

• Java JDK

• Python 2.7

• 文本编辑器（支持UTF-8编码）

编译步骤详解

1. 文件编码修改

问题：QR编码文件需要UTF-8格式
解决方案：

# 转换文件编码为UTF-8
iconv -f GBK -t UTF-8 frameworks/runtime-src/Classes/LuaAssert/QR_Encode.h -o temp.h && mv temp.h frameworks/runtime-src/Classes/LuaAssert/QR_Encode.h
iconv -f GBK -t UTF-8 frameworks/runtime-src/Classes/LuaAssert/QR_Encode.cpp -o temp.cpp && mv temp.cpp frameworks/runtime-src/Classes/LuaAssert/QR_Encode.cpp

2. 加密配置修改

关键文件：frameworks/runtime-src/Classes/appdelegate.cpp
修改内容：

// 修改XXTEA加密密钥和签名
stack->setXXTEAKeyAndSign(
    "YOUR_NEW_KEY_HERE", 
    strlen("YOUR_NEW_KEY_HERE"), 
    "YOUR_NEW_SIGN_HERE", 
    strlen("YOUR_NEW_SIGN_HERE")
);

注意：需要同时修改所有相关位置的加密字符串和子串

3. 服务器地址配置

修改文件：

• client/client/src/plaza/models/yl.lua

• client/base/src/app/view/welcomessd.lua

配置要求：

• 使用域名而非IP地址

• 确保域名解析正确

• 配置HTTPS证书（如需要）

4. 资源清理与准备

# 清除旧的加密资源
rm -rf client/ciphercode/*

# 删除Android构建缓存
rm -rf frameworks/runtime-src/proj.android/settingassert
rm -rf frameworks/runtime-src/proj.android/bin
rm -rf frameworks/runtime-src/proj.android/obj

5. 路径配置调整

文件：cbk/frameworks/runtime-src/proj.android/ant.properties
修改内容：

sdk.dir=/path/to/your/android-sdk
ndk.dir=/path/to/your/android-ndk

6. 资源发布与处理

1. 执行资源发布脚本

2. 将client目录压缩为ZIP文件：

   bash

   cd client/ciphercode
   zip -r client.zip client/

3. 将ZIP文件放置到：base/res/client.zip

7. 部署资源文件

将client/ciphercode/下的所有文件夹上传到网站下载目录：

网站根目录/download/

8. 编译执行

# 进入编译目录
cd cbk

# 使用4核CPU编译（根据实际CPU核心数调整）
cocos compile -p android -j4

9. 客户端更新配置

文件：client/base/src/app/models/appdf.lua
配置项：

-- 更新服务器地址
UPDATE_URL = "https://your-domain.com/update/"

-- 资源版本号
RES_VERSION = "1.0.0"

-- 大版本号（修改IP或域名后需要更新）
MAJOR_VERSION = "1.0.1"

常见问题解决方案

编译错误处理

1. 编码问题：确保所有源文件为UTF-8编码

2. 路径问题：检查Android SDK/NDK路径配置

3. 权限问题：确保脚本文件有执行权限

资源更新问题

1. 版本号冲突：每次更新必须递增版本号

2. 资源加密：确保加密密钥一致

3. CDN缓存：更新后清除CDN缓存

网络连接问题

1. 域名解析：确保域名正确解析到服务器IP

2. SSL证书：使用有效的HTTPS证书

3. 防火墙：开放必要的端口（80、443等）

优化建议

编译优化

# 使用更多CPU核心加速编译
cocos compile -p android -j8

# 发布模式编译
cocos compile -p android --release

资源优化

1. 使用纹理压缩减少包体大小

2. 优化Lua脚本执行效率

3. 实施资源懒加载策略

安全增强

1. 定期更换加密密钥

2. 实施代码混淆

3. 添加反调试机制

版本管理策略

版本号规范

• 主版本号.次版本号.修订号（如：1.2.3）

• 修改IP或域名必须更新主版本号

• 资源更新需要更新修订号

热更新流程

1. 修改appdf.lua中的版本号

2. 发布新的资源包到CDN

3. 客户端检测版本并自动更新

总结

网狐荣耀版手机端的编译部署是一个系统性的工程，需要严格按照步骤操作。关键点包括：

1. 文件编码：确保UTF-8编码避免乱码

2. 加密安全：妥善管理加密密钥

3. 资源管理：正确的资源打包和部署

4. 版本控制：严格的版本管理策略

5. 网络配置：正确的域名和CDN配置

遵循本指南可以顺利完成网狐荣耀版手机端的编译和部署工作，为游戏的正常运营奠定基础。