搭建网狐荣耀版移动端项目时,需要对源码做一些基础处理才能正常编译、打包和发布。本说明文档整理了实际操作中涉及到的编码修改、加密配置、资源处理和构建流程,供后续开发或维护人员参考使用。
1. 修改源文件编码格式
将以下两个文件的编码格式统一为 UTF-8,否则在部分 IDE 下可能出现乱码或编译错误:
\frameworks\runtime-src\Classes\LuaAssert\QR_Encode.h
\frameworks\runtime-src\Classes\LuaAssert\QR_Encode.cpp
建议使用 VSCode 或 Notepad++ 打开并重新保存为 UTF-8 编码。
2. 修改加密配置
项目使用 XXTEA 加密,默认密钥和签名在以下文件中设置:
\frameworks\runtime-src\Classes\appdelegate.cpp
找到这行:
stack->setXXTEAKeyAndSign("RY_QP_MBCLIENT_!2016", strlen("RY_QP_MBCLIENT_!2016"), "RY_QP_2016", strlen("RY_QP_2016"));
如果要换加密参数,字符串内容和长度部分都要同步修改,否则解密会失败。
3. 修改客户端域名配置
编辑以下两个文件:
client/client/src/plaza/models/yl.lua
client/base/src/app/view/welcomessd.lua
将里面的 IP 地址或旧域名替换为你自己的服务器域名。注意:必须使用 域名,否则热更新机制可能解析失败。
4. 清理 ciphercode 编译缓存
资源发布前,删除以下路径下的旧缓存:
client/ciphercode/
注意是删除整个目录内容,保持干净状态再进行后续打包。
5. 清理 Android 编译目录
进入目录:
\frameworks\runtime-src\proj.Android
删除以下几个文件夹:
settingassert/
bin/
obj/
避免旧编译产物干扰打包。
6. 修改 ant.properties 文件路径
路径:
cbk/frameworks/runtime-src/proj.android/ant.properties
里面配置的 SDK 路径、NDK 路径需要根据你当前电脑的实际路径进行修改。尤其注意不要留中文或空格路径。
7. 发布资源并替换图片
使用发布工具先进行资源加密与压缩,替换必要图片后再进行后续步骤。
8. 生成 ciphercode 加密包
将 client/ciphercode/client
文件夹内容打包为 .zip
文件,命名保持一致,放入:
base/res/
再将 client/ciphercode/
下的所有文件夹上传至服务端网站的 download/
目录下,供客户端热更新使用。
9. 编译 APK 包
进入 cbk
目录,使用命令行编译:
cmd -> 执行 ndk-build -j4
其中 j4
表示使用 4 个 CPU 线程进行并发编译,根据电脑性能可调大。
10. 热更新配置地址调整
要支持热更新,需修改以下配置文件:
client/base/src/app/models/appdf.lua
将热更新地址(资源下载根路径)替换为你自己的资源服务器地址或 CDN 域名。
11. 更换 IP 或域名后的处理方式
如果后续更改了 IP 或热更新域名,必须同步修改底包版本号,以确保热更新能正确触发:
-- 举例:
APP_VERSION = "2.1.1" -- 修改为新的版本号
不改版本号,客户端会认为资源未变化,无法重新拉取配置。
这个项目的编译流程不复杂,但步骤较多,每一项细节如果遗漏,都有可能导致:
- 启动黑屏;
- 解密失败;
- 热更新报错;
- 包体混乱等问题。
建议将以上内容固化成团队内部流程文档,避免每次部署都重新摸索。
转载请注明出处,若转载请保留作者署名与本文链接,感谢支持开源精神与知识传播。
仅限技术交流,禁止商用!