文档中心

getRuntimeVersion ​

获取运行时版本号 ​

getRuntimeVersion 是 SUDRT 协议中的一个类方法。它用于返回当前游戏引擎（Runtime）内核的精确版本字符串。该版本号是排查兼容性问题、确认补丁更新以及进行服务端版本对齐的关键依据。

方法声明 ​

objectivec
/**
 * 返回当前 Runtime 引擎的版本字符串。
 * @return 版本号字符串，例如 @"1.2.30.5" 或 @"2.0.0-rc1"。
 */
+ (NSString *)getRuntimeVersion;

运行行为 ​

  1. 静态版本：该方法返回的是 SDK 编译时确定的静态字符串，代表了当前二进制库文件的内核版本。
  2. 细粒度识别：相比 getRuntimeDescription 提供的描述，getRuntimeVersion 提供了数字化的版本，方便进行类似 1.5.0 以上才支持某 API 的逻辑判断。
  3. 多端同步：通常用于向业务后台上报，以便统计不同版本引擎下的游戏运行表现。

代码示例 ​

在 App 启动日志或“关于”界面中展示引擎版本：

objectivec
// 获取具体的版本号
NSString *version = [SudRuntimeImpl getRuntimeVersion];

// 业务逻辑判断示例：只有版本号大于或等于 1.1.0 才执行某个高性能初始化
if ([version compare:@"1.1.0" options:NSNumericSearch] != NSOrderedAscending) {
    [self initializeHighPerformanceModule];
}

NSLog(@"[SUD_SDK] 核心内核版本: %@", version);

注意事项 ​

  • 格式规范：版本号通常遵循语义化版本（Semantic Versioning）规范，但也可能包含构建号（Build Number）。
  • 版本与特性：虽然可以通过版本号判断功能，但更推荐使用 getRuntimeFeatures 来探测具体能力的开关，因为版本号在不同分支（如 2D 和 3D）之间可能不具备直接可比性。
  • 上报必备：在集成 SDK 遇到 Bug 向技术支持反馈时，必须提供此方法返回的完整版本字符串。