minigame-tuanjie-transform-sdk/Editor/PCHighPerformance/TROUBLESHOOTING.md

PC高性能小游戏 - 问题排查指南

🐛 问题1：设置面板数据被清空

原因

OnLostFocus() 时机不对，输入框的值可能还未同步到 formInputData

解决方案 ✅

已修复：在 OnSettingsGUI() 中添加 GUI.changed 检测，每次输入时自动保存

// OnSettingsGUI() 结尾
if (GUI.changed)
{
    SaveData();  // 实时保存
}

---

🐛 问题2：ShowInfo 逻辑未执行

可能原因

1. DLL 未找到 (最常见 90%)

症状：运行 .exe 后没有任何弹窗
原因：direct_applet_sdk.dll 不在 .exe 同级目录

验证：

# 检查导出目录结构
导出路径/
├── YourGame.exe
├── direct_applet_sdk.dll  ← 必须存在
└── YourGame_Data/

解决：

• 确保 DLL 在运行时根目录
• 查看 Unity Player.log：
  • Windows: %APPDATA%\..\LocalLow\<CompanyName>\<ProductName>\Player.log
  • 搜索关键字: [EmbeddedAppletSDK] 或 DllNotFoundException

---

2. GameObject 未注入 (10%)

症状：构建后场景中没有 EmbeddedAppletSDK 对象

验证：使用调试工具

Unity 菜单 → 微信小游戏 → PC高性能调试 → 检查SDK注入状态

可能的问题：

• ❌ Build Settings 中没有启用场景
• ❌ 构建前 PCHPBuildPreProcessor 未执行
• ❌ 脚本编译错误导致组件未挂载

解决：

1. 确保 Build Settings 有至少一个启用场景
2. 查看 Console 日志：

   [PC高性能小游戏] 开始预处理构建...
   [PC高性能小游戏] 已在 XXX 中创建 SDK 对象并添加组件
   

---

3. MessageBox 被禁用 (少见 <5%)

症状：有日志输出但没有弹窗

验证：

• 查看 Unity Editor Console 是否有 [EmbeddedAppletSDK] 日志
• 运行 .exe 时查看 Player.log

临时禁用弹窗（调试用）：

// 修改 Templates/EmbeddedAppletSDK.cs
private void ShowInfo(string message)
{
    Debug.Log($"[EmbeddedAppletSDK] {message}");
    // MessageBox(IntPtr.Zero, message, "Info", 0x40);  // 注释掉
}

---

🔍 调试步骤（按顺序）

Step 1: 检查 SDK 注入状态

Unity 菜单 → 微信小游戏 → PC高性能调试 → 检查SDK注入状态

✅ 正常输出示例：

[构建场景] 启用的场景数: 1
  ✅ 首场景: Assets/Scenes/Main.unity
  ✅ 找到 SDK GameObject: EmbeddedAppletSDK
  ✅ 挂载的脚本: EmbeddedAppletSDK

[脚本文件检查]
  ✅ 用户项目中存在 EmbeddedAppletSDK.cs

[类型加载检查]
  ✅ EmbeddedAppletSDK 类型已加载

---

Step 2: 检查导出路径

Unity 菜单 → 微信小游戏 → PC高性能调试 → 查看导出路径

确认：

• ✅ 目录存在
• ✅ 有 .exe 文件

---

Step 3: 运行 .exe 并查看日志

日志位置：

Windows: %APPDATA%\..\LocalLow\YourCompany\YourProduct\Player.log
Mac: ~/Library/Logs/Company Name/Product Name/Player.log

搜索关键字：

[EmbeddedAppletSDK]
DllNotFoundException
InitEmbeddedGameSDK

正常日志：

[EmbeddedAppletSDK] ========== Awake 被调用 ==========
[EmbeddedAppletSDK] GameObject 名称: EmbeddedAppletSDK
[EmbeddedAppletSDK] ========== 开始初始化 ==========
[EmbeddedAppletSDK] 当前工作目录: C:\...\YourBuild
[EmbeddedAppletSDK] Step 1: 调用 InitEmbeddedGameSDK
[EmbeddedAppletSDK] InitEmbeddedGameSDK 成功
...

异常日志：

DllNotFoundException: Unable to load DLL 'direct_applet_sdk.dll'
  → 解决: 复制 DLL 到 .exe 同级目录

---

📝 快速检查清单

• Build Settings 中有启用的场景
• 构建时 Console 有 [PC高性能小游戏] 预处理完成! 日志
• 导出目录包含 .exe 和 direct_applet_sdk.dll
• 运行 .exe 后有弹窗或 Player.log 有日志

---

🛠️ 调试工具菜单

菜单项	功能
检查SDK注入状态	验证场景中是否有 SDK 对象和脚本
查看导出路径	显示配置的导出路径和状态
打开导出目录	在文件管理器中打开导出目录

---

💡 常见错误代码

错误信息	原因	解决方法
DllNotFoundException	DLL 未找到	复制 DLL 到 .exe 同级目录
EntryPointNotFoundException	函数不存在	检查 DLL 版本是否匹配
找不到 EmbeddedAppletSDK 类型	脚本未编译	检查编译错误或重新导入
GetActiveWindow 返回空句柄	窗口未创建	延迟初始化或检查 Unity Player 设置

---

🚀 最小验证示例

创建一个最简单的测试场景：

1. 创建新场景 TestSDK.unity
2. 添加到 Build Settings 并设为首场景
3. 构建一次 → 应该自动注入 SDK
4. 检查场景 → 应该有 EmbeddedAppletSDK GameObject
5. 运行 .exe（确保 DLL 存在）→ 应该有弹窗

如果这个流程失败，提供 Console 和 Player.log 完整日志。