Game Center排行榜包装器macOS构建报符号未找到错误如何解决？

问题根因 #

• 头文件函数声明缺少extern "C"修饰：C调用侧（当前场景为Unity IL2CPP生成的C绑定代码）会对函数名做名称修饰（name mangling），而你.m文件里的C实现是未修饰的C链接符号，两者名称不匹配导致链接器找不到对应符号。
• LeaderboardWrapper.m未加入macOS目标的编译源列表：你仅给iOS目标添加了编译项，macOS构建时没有编译该文件，自然找不到符号。
• GameKit框架未正确添加到macOS目标的依赖库中（该原因概率较低，当前错误首先是自定义函数符号找不到）

修复步骤 #

1. 修改LeaderboardWrapper.h，补充extern "C"包裹函数声明，同时补全缺失的回调类型定义：

#ifndef LeaderboardWrapper_h
#define LeaderboardWrapper_h

// 补全缺失的回调类型定义
typedef void (*GameCenter_LoadLeaderboardCallback)(const char* result);

enum GameCenterLoadLeaderboardError
{
    GCLoadLeaderboard_NoError = 0,
    GCLoadLeaderboard_CallbackHandlerNotSet,
    GCLoadLeaderboard_ServiceError,
    GCLoadLeaderboard_LeaderboardNotFound
};

#ifdef __cplusplus
extern "C" {
#endif

void gameCenter_setLoadLeaderboardCallbackHandler(GameCenter_LoadLeaderboardCallback handler);
void gameCenter_loadLeaderboard(const char* leaderboardId);

#ifdef __cplusplus
}
#endif

#endif /* LeaderboardWrapper_h */

2. 检查编译源配置
   打开Xcode项目，选中LeaderboardWrapper.m文件，在右侧检查器的Target Membership栏，确认勾选了macOS构建目标，不要仅勾选iOS目标。也可以进入macOS目标的Build Phases > Compile Sources，确认LeaderboardWrapper.m在列表中。

3. 补充GameKit依赖
   进入macOS目标的General > Frameworks and Libraries，点击+添加GameKit.framework，状态设为Required。

4. 补全缺失实现
   现有代码中用到的makeResultString函数没有给出实现，需要自行补充将NSDictionary转为JSON字符串的逻辑，否则后续仍然会报符号错误。

内容的提问来源于stack exchange，提问作者Marcin Iwanowski