文档中心

getRuntimeDescription ​

获取 Runtime 版本描述 ​

getRuntimeDescription 返回当前加载的 SUD Runtime SDK 的详细构建信息。与单纯的数字版本号 getRuntimeVersion 不同，此接口提供的信息通常包含构建时间、Git 提交哈希（Commit ID）或其他内部标识，用于更精确的性能分析和问题排查。

方法声明 ​

java
/**
 * 返回 Runtime SDK 模块的版本描述
 * * @return 包含版本号及构建细节的描述字符串
 */
String getRuntimeDescription();

运行行为 ​

  1. 详尽性：该方法返回的是一段描述性文本，而不仅仅是三位数的版本号。
  2. 诊断用途：当开发者遇到仅在特定构建版本中出现的 Bug 时，此描述信息是向 SUD 技术支持提供环境上下文的最有效手段。
  3. 零延迟：该方法为内存常驻信息的直接读取，不会产生磁盘 I/O 或网络开销。

代码示例 ​

java
// 获取详细描述
String desc = runtime.getRuntimeDescription();
Log.d("SUDOP", "Runtime Build Description: " + desc);

// 示例输出可能为：
// "1.2.30.build20240520.c0ffee8"

getRuntimeVersion vs getRuntimeDescription ​

特性getRuntimeVersiongetRuntimeDescription
返回内容仅标准版本号（如 1.2.30）完整构建详情（包含日期/哈希）
主要用途业务逻辑判断、特性检测错误日志记录、技术排查
可读性适合程序解析适合人工阅读

注意事项 ​

  • 非标准格式：由于描述字符串包含构建细节，其格式可能随 SDK 版本的迭代而改变，不建议使用正则表达式强行解析其内部的特定字段。
  • 日志收集：在集成 Crash 收集系统（如 Bugly 或 Firebase）时，建议将此描述信息作为自定义标签上传。