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

本篇文章将针对"网狐系列嘻游电玩组件"的三端客户端（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 监听调试 |

七、补充建议与错误处理

若服务端端口未开放，安卓或iOS连接会无反应；建议关闭防火墙或开启 8600/8700 端口
资源出现乱码或丢失，需检查构建平台是否设置资源压缩导致路径变动
安卓模拟器不能连接本地服务器？请使用 10.0.2.2 替代 127.0.0.1