[特殊字符] GUNION SDK 接口调用方式说明(静态库 vs 动态库)

文章目录

  • [💡 GUNION SDK 接口调用方式说明(静态库 vs 动态库)](#💡 GUNION SDK 接口调用方式说明(静态库 vs 动态库))
    • [📘 一、接口宏定义说明](#📘 一、接口宏定义说明)
    • [🚀 二、使用方式对比](#🚀 二、使用方式对比)
    • [🧱 三、调用方使用方式详解](#🧱 三、调用方使用方式详解)
      • [✅ 1. 使用静态库(.lib)](#✅ 1. 使用静态库(.lib))
      • [✅ 2. 使用 DLL(隐式链接)](#✅ 2. 使用 DLL(隐式链接))
      • [✅ 3. 使用 DLL(动态加载 LoadLibrary)](#✅ 3. 使用 DLL(动态加载 LoadLibrary))
    • [🔍 四、导出名注意事项(运行时加载)](#🔍 四、导出名注意事项(运行时加载))
    • [📦 五、推荐发布内容(给调用者)](#📦 五、推荐发布内容(给调用者))
    • [✅ 六、宏设置汇总](#✅ 六、宏设置汇总)

💡 GUNION SDK 接口调用方式说明(静态库 vs 动态库)

本手册详细介绍 Ghome.h 接口文件在不同调用场景下的使用方式,包括宏控制、链接方式、运行时行为、适配代码等,确保调用方能够正确配置并调用 SDK 接口。


📘 一、接口宏定义说明

Ghome.h 中,使用如下宏控制导出/导入行为:

cpp 复制代码
#if defined(GHOME_STATIC)
    #define GHOME_API
#elif defined(GHOME_EXPORTS)
    #define GHOME_API __declspec(dllexport)
#else
    #define GHOME_API __declspec(dllimport)
#endif

含义如下:

宏定义 含义说明
GHOME_STATIC 表示使用静态库(.lib),不需要 DLL
GHOME_EXPORTS 表示正在编译 DLL,导出符号(供别人用)
未定义任何宏 默认行为,表示正在使用 DLL(导入符号)

🚀 二、使用方式对比

使用场景 是否需要定义宏 是否使用 .lib 是否需要 .dll 是否使用 LoadLibrary
✅ 静态库 .lib 编译链接 #define GHOME_STATIC ✅ 是 ❌ 否 ❌ 否
✅ DLL(隐式链接) 无需定义宏 ✅ 是 ✅ 是 ❌ 否
✅ DLL(运行时动态加载) ❌ 不需要宏 ❌ 否 ✅ 是 ✅ 是

🧱 三、调用方使用方式详解

✅ 1. 使用静态库(.lib)

  • 头文件中添加宏:
cpp 复制代码
#define GHOME_STATIC
#include "Ghome.h"
  • 链接设置:
    • 链接 .lib 文件(例如:ghome_static.lib
    • 不需要运行时存在 .dll
  • 示例代码:
cpp 复制代码
GhomeLAppInfo appInfo = { sizeof(GhomeLAppInfo), 123, L"游戏名", L"1.0", -1, -1 };
int ret = GhomeInitialize(&appInfo);

✅ 2. 使用 DLL(隐式链接)

  • 不需要定义任何宏
  • 工程中链接 .lib 文件(由 DLL 编译生成);
  • 运行时需要 .dll 文件放在可执行文件旁边或系统 PATH 中。
  • 示例代码:
cpp 复制代码
#include "Ghome.h"

GhomeLAppInfo appInfo = { sizeof(GhomeLAppInfo), 123, L"游戏名", L"1.0", -1, -1 };
int ret = GhomeInitialize(&appInfo);

✅ 3. 使用 DLL(动态加载 LoadLibrary)

  • 不需要包含 ghome.h(除非重用 struct 定义)
  • 使用 typedef 声明函数指针
  • 使用 LoadLibraryGetProcAddress 动态调用
  • 示例代码:
cpp 复制代码
typedef int (__cdecl *PF_GhomeInitialize)(const GhomeLAppInfo*);
HMODULE hDll = LoadLibraryW(L"`sdologinsdk.dll`");
if (hDll) {
    PF_GhomeInitialize init = (PF_GhomeInitialize)GetProcAddress(hDll, "GhomeInitialize");
    if (init) {
        GhomeLAppInfo appInfo = { sizeof(GhomeLAppInfo), 123, L"游戏名", L"1.0", -1, -1 };
        int ret = init(&appInfo);
    }
    FreeLibrary(hDll);
}
  • 优点: 不需链接 .lib,运行时灵活控制加载;
  • 缺点: 函数名大小写必须匹配,需手动定义所有函数指针;

🔍 四、导出名注意事项(运行时加载)

使用 GetProcAddress 加载函数时,需要确认 DLL 中函数是否为标准 C 导出名(例如 GhomeInitialize)而不是带修饰符的(如 _GhomeInitialize@4)。建议:

  • 在 C++ 中使用 extern "C" 包裹导出声明;
  • 使用 dumpbin /exports ghome.dll 验证导出名;
  • 保证函数名在头文件与 DLL 中完全一致。

📦 五、推荐发布内容(给调用者)

建议发布以下内容给调用者:

文件名 描述
ghome.h 公共头文件
sdologinsdk.lib、sdologinsdk64.lib 静态库文件(如使用静态库)
sdologinsdk.dll、sdologinsdk64.dll 动态库运行时文件
sdologinsdk.lib、sdologinsdk64.lib DLL 的 import 库(隐式链接时用)

✅ 六、宏设置汇总

使用方式 推荐设置
静态链接 #define GHOME_STATIC
DLL 编译 #define GHOME_EXPORTS
DLL 调用 不定义宏(默认导入)
动态加载 DLL 不定义宏,自定义函数指针
相关推荐
企鹅侠客7 分钟前
Bash与Zsh与Fish:在Linux中你应该使用哪个Shell
linux·开发语言·bash·zsh·fish
石头wang7 分钟前
如何在idea里快速地切换Windows CMD、git bash、powershell
windows·git·bash·intellij-idea
RAY_010416 分钟前
Python—数据容器
开发语言·python
June bug19 分钟前
【python基础】python和pycharm的下载与安装
开发语言·python·pycharm
让我们一起加油好吗21 分钟前
【基础算法】贪心 (四) :区间问题
c++·算法·贪心算法·洛谷
双叶8361 小时前
(C++)任务管理系统(正式版)(迭代器)(list列表基础教程)(STL基础知识)
c语言·开发语言·数据结构·c++·list
七七七七071 小时前
类与对象【下篇】-- 关于类的其它语法
c语言·开发语言·c++
削好皮的Pineapple!1 小时前
C语言模块化编程思维以及直流电机控制(第四天)
c语言·开发语言·单片机
im_AMBER1 小时前
python实践思路(草拟计划+方法)
开发语言·python
黄皮の电气鼠1 小时前
C++:继承
开发语言·c++·算法