单文件头库中实现可重写可选全局回调函数的技术求助

针对你的rawdraw库中需要让回调函数可选（用户未定义时使用空实现）的需求，以下是两种可行的解决方案，尤其适配Android平台的链接特性：

方案一：使用弱符号（Weak Symbols） #

这是最贴近你原本需求的方案，利用链接器的弱符号特性，让用户的实现优先于库的默认实现。关键是要在库的源码文件中提供弱定义的空实现，而非在头文件中：

1. 头文件（cnfg.h）：保持原有的函数声明，无需添加任何属性：

void HandleWindowTermination(void);

2. 库源码文件（如cnfg_common.c）：添加弱属性的默认空实现：

#include "cnfg.h"

__attribute__((weak)) void HandleWindowTermination(void) {
    // 默认空操作，什么都不做
}

当用户在自己的代码中定义了HandleWindowTermination()（无弱属性），链接器会自动选择用户的强符号实现；若用户未定义，则使用库中的弱符号空实现。这种方式在Android平台（基于GNU链接器）完全有效，之前的问题可能是因为你错误地将弱属性放在了头文件的声明中，而非源码的定义上。

方案二：使用函数指针（更通用的跨平台方案） #

如果弱符号在某些特殊场景下仍有问题，可以改用函数指针的方式，完全避开链接器符号冲突的问题：

1. 头文件（cnfg.h）：声明函数指针，并提供可选的设置函数：

// 声明回调函数指针
extern void (*HandleWindowTermination)(void);

// 可选：提供设置回调的辅助函数，也可让用户直接赋值指针
void SetHandleWindowTermination(void (*callback)(void));

2. 库源码文件：初始化指针为默认空实现，并实现设置函数：

#include "cnfg.h"

// 默认空操作函数
static void DefaultHandleWindowTermination(void) { }

// 初始化指针指向默认实现
void (*HandleWindowTermination)(void) = DefaultHandleWindowTermination;

void SetHandleWindowTermination(void (*callback)(void)) {
    if (callback != NULL) {
        HandleWindowTermination = callback;
    } else {
        // 重置为默认空实现
        HandleWindowTermination = DefaultHandleWindowTermination;
    }
}

3. 调用回调的地方：通过指针调用函数：

case APP_CMD_TERM_WINDOW:
    // ... 其他逻辑
    (*HandleWindowTermination)();
    break;

用户只需在自己的代码中赋值函数指针即可覆盖默认行为：

void MyWindowTerminationHandler(void) {
    // 用户自定义的窗口终止逻辑
}

// 在初始化时设置
HandleWindowTermination = MyWindowTerminationHandler;
// 或者用辅助函数
SetHandleWindowTermination(MyWindowTerminationHandler);

这种方式完全不依赖链接器特性，兼容性最好，适合所有平台包括Android。

内容的提问来源于stack exchange，提问作者Charles Lohr