游戏引擎 / 系统课时

怎样区分调试包与正式包

怎样区分调试包与正式包

同一套 Cocos Creator 3.8 项目可能产出能真机运行、却不适合上架的安装包。判断产物不能只看文件名或“已经签名”,而要同时检查 Cocos 构建模式、Xcode 配置、分发签名和后端环境,形成可验收的正式包。

学习目标

  • 分清 Cocos Debug Mode、Xcode Debug/Release 与签名用途的差异。
  • 检查日志、调试资源、测试接口及密钥是否误入正式包。
  • 使用构建设置查询和产物验收清单判断发布就绪程度。

四个维度共同决定包的用途

检查维度 调试包常见情况 正式发布应满足
Cocos 构建 Debug Mode 开启,可配合 Source Maps 排错 关闭 Debug Mode,检查是否携带调试文件
Xcode 编译 Run 常使用 Debug 配置 Archive 使用 Release 配置
iOS 签名 Apple Development + 开发描述文件 App Store Connect 所需分发签名与描述文件
运行环境 测试接口、详细诊断输出 生产接口、受控日志、无测试凭证

这里有两个不同开关:Cocos 的 Debug Mode 影响游戏脚本及资源的构建处理,Xcode 的 Debug/Release 决定原生目标采用哪套编译设置。仅在 Xcode 选中 Release,不会自动纠正 Cocos 之前构建出的调试资源。相关开关见 Cocos Creator 3.8 通用构建选项。

**签名是分发权限,不是编译模式。**Ad Hoc 测试包可能已经采用 Release 构建和 Apple Distribution 签名,但用途仍是已登记设备测试,而非 App Store 发布。

Cocos 与 Xcode 调试包和正式包的多层判定流程

固定两层构建配置

  1. 在 Cocos Creator 的「项目 → 构建」选择 iOS,调试时开启 Debug Mode;准备正式包时取消勾选,并检查 Source Maps、脚本加密及随包资源。脚本加密是可选打包措施,不能替代密钥保护。
  2. 重新执行 Cocos 构建,让最新游戏资源进入原生工程;不要直接拿上一次调试生成的原生资源归档。
  3. 在 Xcode 的 Product → Scheme → Edit Scheme 中确认 Archive 操作选用 Release,再执行 Product → Archive。
  4. 从 Organizer 选择正确的分发方式。App Store Connect 发布需使用匹配的团队、Bundle Identifier 与分发配置;内部真机测试可另用 Development 或 Ad Hoc。

可以在 macOS 终端查询生成工程的 Release 构建设置。先把 <PATH> 和 <SCHEME> 替换为实际工程路径与 Scheme 名称;命令只读取设置,不会打包或替已有产物重新签名。

bash
#!/usr/bin/env bash
set -euo pipefail
PROJECT="<PATH>/Game.xcodeproj"
SCHEME="<SCHEME>"

# 查询指定 Release 配置,避免仅凭 Scheme 名称猜测
xcodebuild -showBuildSettings -project "$PROJECT" \
  -scheme "$SCHEME" -configuration Release -sdk iphoneos 2>/dev/null |
  grep -E '^[[:space:]]*(CONFIGURATION|PRODUCT_BUNDLE_IDENTIFIER|CODE_SIGN_STYLE)[[:space:]]*='

预期输出示例(以自动签名的 Release 工程为例,Bundle Identifier 是动态值,多个 Target 可能产生重复行):

text
    CODE_SIGN_STYLE = Automatic
    CONFIGURATION = Release
    PRODUCT_BUNDLE_IDENTIFIER = <ID>

看到 CONFIGURATION = Release 只证明所查询的构建设置是 Release,不能证明你手中的 .ipa 一定由这次构建生成。应保留对应 Archive、导出记录和版本号,并对最终交付物复核。

查出容易漏进正式包的测试内容

生产发布前必须逐项确认:API、WebSocket、热更新和支付验证服务均指向正式环境;没有测试账号、测试令牌、模拟支付入口或仅供开发的跳过校验开关;资源包中不包含不需分发的 Source Maps、测试素材和内部配置。

日志也不能简单以“Release 会自动关掉”作为依据。业务层 console.log、原生 SDK 日志和异常上传策略可能独立于构建配置;应在真实 Release 包上抓取启动、登录、支付等流程的日志,确认不会输出访问令牌、用户敏感数据或签名材料。客户端内嵌的任何秘密都可能被提取,生产凭证应由可信服务端持有。

用最终产物做发布验收

  1. 记录 Cocos Debug Mode、Xcode Archive 配置、Bundle Identifier、版本号与构建号,以及实际导出渠道,确保它们指向同一次构建。
  2. 安装或通过 TestFlight 验证该构建,执行启动、登录、网络重连、资源更新与购买沙盒测试等适用流程;不要让调试包的测试结果替代 Release 验收。
  3. 观察是否误连测试服务器、出现开发菜单或打印敏感日志;检查描述文件用途与代码签名是否满足最终分发渠道。
  4. 发现不一致时从 Cocos 重新构建并重新 Archive、导出和测试,而不是只改文件名或覆盖少量配置文件。

正式包的准入条件是构建、签名、环境、日志和实际安装行为同时符合发布目标;任何一个维度残留调试设置,都应退回构建阶段处理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

怎样区分调试包与正式包

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通