源码简介

本源码采用 Unity 客户端 + Java Spring Boot 服务端 的前后端分离架构开发，支持 Android 与 iOS 双端运行，并提供完整的客户端源码、服务端源码及部署文档，方便开发团队进行环境搭建、学习研究及二次开发。

系统整体采用模块化设计，代码开放，开发者可根据实际需求对界面、业务流程、接口及功能模块进行扩展和维护。

本版本包含：

• Unity 客户端源码
• Java Spring Boot 服务端
• MySQL 数据库
• 多语言资源
• 热更新框架
• Android 与 iOS 工程
• 完整部署文档

整体项目结构清晰，适合具备 Java、Unity 开发经验的团队进行学习和项目实践。

一、系统技术架构

项目采用现代化前后端分离设计。

推荐技术栈如下：

系统支持移动端双平台部署，便于后续版本维护及功能升级。

二、多语言支持

项目内置多语言资源管理。

默认支持：

采用独立语言包设计。

开发者可根据实际需求继续扩展：

• 日语
• 韩语
• 泰语
• 越南语
• 其他地区语言

无需修改核心业务代码即可新增语言资源。

三、客户端架构

客户端基于 Unity 引擎开发。

主要特点：

• Android 与 iOS 双端支持
• 原生工程管理
• UI模块化设计
• 场景资源统一管理
• 支持热更新扩展
• 动画及资源可独立维护

项目提供未编译源码，开发人员可根据需要自行完成打包及版本发布。

四、服务端架构

服务端采用 Java + Spring Boot 开发。

主要模块包括：

• 用户认证
• 接口管理
• 数据同步
• 日志记录
• 权限控制
• 配置中心

Spring Boot 具备成熟的生态体系，方便后续增加 API、管理模块及第三方服务集成。

五、数据库设计

项目使用 MySQL 5.7。

数据库主要负责：

• 用户信息
• 系统配置
• 日志数据
• 参数管理
• 业务数据

建议部署完成后及时修改默认数据库账号密码，并定期做好数据备份。

六、热更新机制

项目集成资源热更新方案。

主要优势：

• 客户端资源按需更新
• 减少完整安装包发布频率
• 提高版本维护效率
• 支持资源分批下载

部署时建议结合 CDN 使用，以提升资源加载速度和稳定性。

七、Android 与 iOS 编译说明

Android

支持使用：

• Android Studio
• Unity

完成 APK 或 AAB 打包。

建议使用与项目一致的 Unity 版本，避免资源兼容问题。

iOS

iOS 工程建议：

• macOS 开发环境
• Unity 对应版本
• Xcode

导出 Xcode 工程后进行签名及发布。

正式上线前需确认开发证书、描述文件及 Bundle ID 配置正确。

八、部署环境推荐

建议服务器配置如下：

测试环境可采用：

• 2 Core
• 4GB RAM

正式环境建议根据访问规模合理扩容。

九、Java 环境配置

部署前建议先确认 Java 环境。

查看可安装版本：

yum search java | grep -i JDK

安装 OpenJDK：

yum install java-1.8.0-openjdk java-1.8.0-openjdk-devel

配置环境变量：

vim /etc/profile

添加：

export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk
export PATH=$PATH:$JAVA_HOME/bin

保存后执行：

source /etc/profile

确认安装：

java -version

若正常输出版本信息，则说明 Java 环境已配置完成。

十、项目部署流程

第一步

上传服务端源码至服务器。

第二步

导入 MySQL 数据库。

确认字符集与数据库版本符合要求。

第三步

修改配置文件。

主要包括：

• 数据库地址
• 数据库名称
• 用户名
• 密码
• 服务端端口

第四步

启动 Spring Boot 服务。

确认日志无异常后，再启动 Nginx。

第五步

配置客户端服务器地址。

修改：

• API 地址
• WebSocket 地址（如项目包含）
• 热更新资源地址

完成后即可进行联调测试。

十一、常见部署问题

1、Java 服务无法启动

建议检查：

• JDK 是否安装完成
• JAVA_HOME 是否正确
• 端口是否被占用
• Spring Boot 配置文件

2、数据库连接失败

检查：

• MySQL 是否启动
• 用户权限
• 数据库地址
• 配置文件

3、Unity 无法编译

建议确认：

• Unity 版本
• Android SDK
• JDK
• Gradle 版本

保持开发环境与项目要求一致。

4、iOS 打包失败

检查：

• Xcode 版本
• Apple 开发证书
• Provisioning Profile
• Bundle Identifier

这些通常是 iOS 构建失败的主要原因。

十二、二次开发建议

由于项目采用 Unity + Spring Boot 架构，后续可扩展：

客户端

• UI 界面优化
• 多语言新增
• 热更新资源管理
• 页面重构
• 动画优化

服务端

• API 扩展
• 权限管理
• 数据统计
• 日志分析
• 消息通知

整体架构模块化程度较高，适合团队长期维护。

十三、部署总结

本项目采用 Unity 客户端与 Java Spring Boot 服务端组合开发，支持 Android、iOS 双端运行，并提供完整源码及部署文档。

部署过程中建议重点关注：

1. Java 运行环境配置
2. MySQL 数据初始化
3. Spring Boot 配置文件修改
4. Nginx 反向代理配置
5. Unity 客户端编译环境
6. Android 与 iOS 打包配置

完成以上步骤后，可根据实际业务需求进一步进行界面优化、功能扩展及接口开发。

常见问题 FAQ

Q：项目使用什么开发语言？

A：客户端基于 Unity 开发，服务端采用 Java + Spring Boot，数据库使用 MySQL。

Q：支持哪些平台？

A：支持 Android 与 iOS 双端部署，Android 可通过 Android Studio 或 Unity 构建，iOS 需在 macOS 环境下使用 Unity 与 Xcode 完成打包。

Q：是否支持多语言？

A：默认支持简体中文、繁体中文及英语，并可继续扩展其他语言包。

Q：源码是否方便二次开发？

A：项目采用模块化架构，源码完整，适合功能扩展、界面优化及长期维护。

源码实测截图

后台实测截图