当前位置：首页 > news >正文

嘻游电玩三端客户端部署实战：PC + Android + iOS 环境全覆盖教程

news 来源：原创 2025/4/27 14:50:17

本篇文章将针对“网狐系列嘻游电玩组件”的三端客户端（PC端、安卓端、iOS端）进行详细部署实操讲解。文章将以实测部署为核心，提供资源结构说明、平台适配调整、打包配置、常见问题修复，并辅以必要的关键配置代码。

一、客户端资源结构概览

解压客户端目录结构如下：

/xiyou_client
├── PC/                  # Windows客户端（含.exe主程序）
├── Android/             # 安卓源码（含res、src、build.gradle）
├── iOS/                 # Xcode项目（Objective-C）
├── shared/              # 公共资源目录（UI、音效、字体）
└── config.json          # 客户端总配置文件（IP、端口、包标识等）

config.json 示例：

{"server_ip": "192.168.1.100","server_port": 8700,"platform": "android","version": "1.0.0"
}

二、PC端部署说明

PC客户端通常为 Cocos Creator 构建后封装的 .exe 程序。

1. IP配置修改

在 config.json 中替换服务器地址：

"server_ip": "127.0.0.1"

2. 本地运行建议

关闭防火墙
双击运行 XiyouGame.exe
若缺 DLL，请确保安装 VC++ 运行库

3. 常见问题排查

现象	原因与解决
白屏或闪退	缺失资源，检查 `res/` 或 `build/` 目录
登录无响应	服务端未启动或IP配置错误

三、安卓客户端编译与打包

安卓端采用标准 Gradle 项目结构，支持 Android Studio 编译。

1. 替换服务器地址

路径：/Android/assets/config.json

2. 打包流程

使用 Android Studio 打开项目目录
修改 build.gradle 中的版本号与包名：

applicationId "com.xiyou.dianwan"
versionCode 1
versionName "1.0.0"

点击 Build -> Build Bundle(s) / APK(s) -> Build APK(s)

3. 签名配置

如需发布版本，可使用以下签名方式：

signingConfigs {release {storeFile file("xiyou.keystore")storePassword "123456"keyAlias "xiyou"keyPassword "123456"}
}

四、iOS 客户端部署流程（Xcode）

适用于拥有开发者账号与苹果证书的用户。

1. 修改 IP 配置

路径：/iOS/Resources/config.json

2. 项目打开与真机测试

使用 Xcode 打开 .xcodeproj 文件
修改 Bundle Identifier：

com.xiyou.ios.dianwan

设置签名证书与团队：

勾选 Automatically manage signing
选择 Apple ID 对应的 Team

3. 常见编译错误排查

错误	原因
provisioning profile 不匹配	检查是否添加开发证书
code sign fail	检查钥匙串是否包含所需签名

五、资源包替换与多端同步建议

客户端所有资源分布在 shared/ 中，包括：

res/：图片资源，支持 PNG/WEBP
audio/：背景音效、按钮音效
font/：特定语言字体

替换方法：

替换资源后，需运行平台构建工具（Cocos 或 Unity）重新导出 res_index.json
所有客户端引用路径统一读取 index 索引，需保持一致性

六、三端联调技巧与实测建议

操作	工具建议
PC联调	本机 IP 设置 127.0.0.1 + 本地服务端
安卓联调	夜神模拟器/雷电模拟器设置桥接 IP
iOS联调	真机部署 + Charles 监听调试