文档中心

getCoreDesc ​

获取 Core 模块版本描述 ​

getCoreDesc 返回当前已加载的 Runtime Core（内核引擎） 的详细构建描述信息。相较于 getCoreVersion 提供的纯数字版本号，此接口返回的字符串包含更多维度的信息，例如编译时间戳、Git 仓库的 Commit ID 以及特定的构建分支标识。

方法声明 ​

java
/**
 * 返回 Runtime Core 模块的版本描述。
 * * @return 包含内核版本、构建日期及 Hash 值的详细描述字符串
 */
String getCoreDesc();

运行行为 ​

  1. 详尽诊断：在生产环境中，如果遇到特定机型或特定引擎版本的渲染异常，此描述符能帮助技术支持精确锁定该版本引擎的源代码快照。
  2. 构建追溯：它反映了内核文件的真实构建背景，是判断内核文件是否被错误替换或混用的重要依据。

代码示例 ​

java
// 从核心句柄中获取内核详细描述
String coreDescription = coreHandle.getCoreDesc();

// 输出示例： "Core_v2.3.15_20240825_release_7a8b9c"
Log.d("SUDOP_DEBUG", "Core Detail: " + coreDescription);

// 在反馈技术工单时，建议直接复制此内容
sendToSupport("Reported Bug on Core: " + coreDescription);

getCoreVersion 与 getCoreDesc 的区别 ​

维度getCoreVersiongetCoreDesc
返回示例"2.3.15""Core_v2.3.15_20240825_7a8b9c"
主要用途业务逻辑判断、版本比对问题排查、构建溯源、日志上报
内容格式严格的语义化版本号包含日期、哈希、构建环境的复合字符串

注意事项 ​

  • 非解析性：由于描述字符串的格式可能随引擎编译脚本的改动而变化，严禁在业务逻辑中通过解析此字符串来判断版本。
  • 日志采集建议：建议在发生 Native 崩溃（Crash）或渲染黑屏时，将此描述符作为环境上下文的核心参数进行采集。