xuqmGroup/XuqmGroup-AndroidSDK
0
0
派生 0
代码 工单 合并请求 版本发布 百科 动态
202 提交 1 分支 0 Git标签 2.3 MiB
d742317c4d
提交图

202 次代码提交

此分支
此分支
所有分支
作者 SHA1 备注 提交日期
XuqmGroup
d742317c4d fix(bugcollect): LogUploader 自动将相对路径补全为绝对 URL 
- bugCollectApiUrl 为相对路径时，基于 XuqmSDK.platformUrl 拼接完整地址
- 修复 'Expected URL scheme http or https' 异常
 2026-06-18 19:06:03 +08:00
XuqmGroup
3ded960383 fix(bugcollect): captureError 在 SDK 未就绪时暂存事件，就绪后自动 flush 
- 添加 pendingErrors 队列，SDK 未初始化时 captureError 不再丢弃事件
- startCrashCapture 完成后自动 flush 暂存事件到上传队列
 2026-06-18 18:56:37 +08:00
XuqmGroup
d5ce5ffabb refactor(bugcollect): 移除 BugCollectInitProvider 减少框架开销 
- 移除了 BugCollectInitProvider ContentProvider
- 改为通过 XuqmSDK afterInit 回调注册崩溃拦截器
- 消除了约 380ms 的 ContentProvider 框架启动开销
- 确保在 SDK 初始化完成后注册 UncaughtExceptionHandler
 2026-06-18 17:07:12 +08:00
XuqmGroup
2b1857a8ff fix(sdk-core): initBugCollect 反射调用 Kotlin object 需传单例实例 2026-06-18 17:01:21 +08:00
XuqmGroup
e180003386 fix(sdk-bugcollect): BugCollectInitProvider 添加 CrashCapture import 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-18 16:25:35 +08:00
XuqmGroup
2c610b777d fix(sdk-core): 修复编译错误 — KDoc 转义 + MasterKeys API 
- ConfigFileReader: KDoc 中 *.xuqmconfig 改为 \*.xuqmconfig（避免 */ 被解析为注释结束）
- ConfigCache: MasterKey → MasterKeys（兼容当前 security-crypto 版本）

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-18 16:04:57 +08:00
XuqmGroup
b7c7a2c385 perf(sdk-core): 合并 ContentProvider + PBKDF2 缓存，冷启动从 ~350ms 降到 ~7ms 
优化内容：
- 新增 XuqmMergedProvider：合并 3 个 Provider 为 1 个，主线程只读文件字节
- 新增 ConfigCache：EncryptedSharedPreferences 持久化缓存解密结果
- ConfigFileReader 新增 readRawBytes() / readWithCache()，单例内存缓存
- XuqmSDK 新增 autoInitializeFromBytes()：IO 线程完成解密+初始化
- BugCollectInitProvider 改为兼容 fallback，检查 isInitialized() 跳过
- XuqmInitializerProvider 标记 @Deprecated

性能对比：
  优化前：主线程 ~350ms（PBKDF2 + 文件扫描 + 3 个 Provider 实例化）
  优化后：主线程 ~7ms（文件发现 + 读字节），后续启动 ~3ms（读缓存）

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-18 15:58:53 +08:00
XuqmGroup
1f1c0b4018 docs(readme): 更新文档说明新增日志监控模块 
- 添加 sdk-bugcollect 模块说明及其功能描述
- 增加日志监控模块的依赖配置示例
- 更新初始化说明，区分自动初始化和手动初始化两种方式
- 添加推荐的配置文件自动初始化方式说明
 2026-06-18 15:41:09 +08:00
XuqmGroup
6a5bfd1c10 fix(sdk-core): ConfigFileReader KDoc 注释中 */ 导致编译失败，转义为 \* 2026-06-18 15:30:09 +08:00
XuqmGroup
75c1d77965 feat(sdk-core): ConfigFileReader 新增 assets/config/ 目录支持 
对齐 RN SDK 的 src/assets/config/ 目录约定：
搜索顺序：config/config.xuqmconfig → config/*.xuqmconfig → xuqm/config.xuqm → xuqm/*.xuqmconfig
旧路径 assets/xuqm/ 保持兼容。

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-18 15:06:40 +08:00
XuqmGroup
ba6de0a5fd perf(sdk): ContentProvider 异步初始化，减少冷启动阻塞时间 
- XuqmInitializerProvider 改用 autoInitializeAsync()，TokenStore/DeviceId/ApiClient 移到 IO 线程
- XuqmSDK 新增 readAppKey() 公开方法，仅读取 config 不做初始化
- BugCollectInitProvider 适配异步初始化，直接读取 appKey 注册崩溃拦截器
- 同步阶段只做 config 文件读取（~5ms），主线程不再阻塞
 2026-06-18 14:53:34 +08:00
XuqmGroup
0ec173677d feat(webview): 添加 onProgressChanged 回调，支持页面加载进度监听 2026-06-18 14:05:43 +08:00
XuqmGroup
30ce89afcc fix(file): 公共 Downloads 使用 MediaStore 写入，兼容华为设备 
- Android 10+ 公共目录通过 MediaStore ContentResolver 写入
- 同时写入缓存文件供 openFile 使用
- 避免华为设备 mkdirs()/writeBytes() ENOENT 问题
 2026-06-18 13:56:35 +08:00
XuqmGroup
d2873eda66 refactor(file): download 方法复用 resolveBaseDir，统一目录创建逻辑 2026-06-18 13:50:48 +08:00
XuqmGroup
a6b1905a66 fix(file): resolveBaseDir 多重尝试创建目录，兼容华为/小米设备 
- mkdirs() 静默失败时，尝试 Runtime.exec('mkdir -p')
- 仍失败则回退到 Sandbox 目录，避免 ENOENT 崩溃
 2026-06-18 13:50:14 +08:00
XuqmGroup
aeeba4fac8 feat(webview): 添加 onPageError 回调，支持页面加载失败检测 
- XWebViewConfig 新增 onPageError(errorCode, description, failingUrl) 回调
- WebViewClient.onReceivedError 捕获主框架加载错误并回调
- App 层可据此显示重试 UI
 2026-06-18 13:43:56 +08:00
XuqmGroup
d015fd7d40 fix(ci): 版本信息用逗号分隔，避免 Windows 管道符冲突 2026-06-18 12:59:05 +08:00
XuqmGroup
f797ec48d3 fix(ci): post 块中用 script 包裹 Groovy 变量声明 2026-06-18 12:48:30 +08:00
XuqmGroup
3e788e1c4e fix(ci): 转义 PUBLISHED_VERSIONS 换行符，避免 Windows bat 解析多命令 2026-06-18 12:37:42 +08:00
XuqmGroup
6f216bc4c2 fix(ci): SNAPSHOT 版本基于下一版本号，避免与已发布的 release 冲突 
- SNAPSHOT 模式：bumpVersion(baseVer) + '-SNAPSHOT'，确保高于当前 release
- 解决 Gradle 解析 SNAPSHOT 时优先使用同版本号 release 的问题
 2026-06-18 12:23:51 +08:00
XuqmGroup
f0276bb440 feat(webview): 添加blob下载功能并完善存储权限处理 
- 添加pendingBlobDownload状态管理blob下载请求
- 实现API 30+系统上MANAGE_EXTERNAL_STORAGE权限检查
- 添加blob数据解码和文件保存功能
- 集成下载完成事件分发机制
- 完善存储权限对话框中的状态清理逻辑
- 实现blob下载成功后的相册保存或文件打开操作
 2026-06-18 11:52:02 +08:00
XuqmGroup
aca0d009a8 feat(bugcollect): 使用 deviceId 作为 userId 兜底，保障影响设备数统计 
- XuqmSDK 新增 deviceId 属性：首次生成 UUID 存入 SharedPreferences，后续不变
- BugCollect 上报事件时 userId 改为 getUserId() ?: deviceId，未登录也能统计影响设备数
- BugCollectInitProvider 崩溃拦截同步使用 deviceId 兜底

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-18 10:47:38 +08:00
XuqmGroup
77fef3a38b refactor(bugcollect): 注册与 URL 完全解耦 
注册 UncaughtExceptionHandler 不需要 URL：
- CrashCapture.start 移除 logApiUrl 参数，只需 appContext + appKey
- LogStorage.saveCrash 移除 logApiUrl，崩溃文件不再存储 URL
- LogQueue.uploadPendingCrashes 上传时直接取 XuqmSDK.bugCollectApiUrl，
  URL 为 null 则跳过（下次启动重试），不依赖崩溃文件里的历史 URL
- BugCollect.startCrashCapture 移除 URL 构造逻辑
- BugCollectInitProvider Phase 1 纯粹只注册，彻底消除对 platformUrl 的依赖，
  版本兼容问题从根本上消失

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-18 10:18:08 +08:00
XuqmGroup
be8eeba9e1 fix(bugcollect): BugCollectInitProvider 对旧版 sdk-core 防御降级 
platformUrl 是新增属性，旧版 sdk-core 没有对应的 getPlatformUrl()。
改用 runCatching 包住调用，NoSuchMethodError 时记录警告、跳过崩溃拦截，
不再因版本不一致导致 app 启动崩溃。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-18 10:16:05 +08:00
XuqmGroup
54b3163f53 refactor(bugcollect): 崩溃收集与上传分离，sdk-core 保持独立 
设计问题：
- 之前用反射在 XuqmInitializerProvider 里调用 BugCollect，sdk-core 隐式依赖 sdk-bugcollect
- startCrashCapture 同时负责注册拦截器和触发上传，两者生命周期不同

新架构：
- sdk-core 完全干净，XuqmInitializerProvider 还原为只调用 autoInitialize
- sdk-bugcollect 自注册 BugCollectInitProvider（initOrder=89）
  - Phase 1（同步）：core init 完成后立即注册 UncaughtExceptionHandler，用
    platformUrl 派生兜底 URL，落盘不依赖远端配置
  - Phase 2（异步）：awaitInitialization() 后用最新 bugCollectApiUrl 上传积压崩溃
- BugCollect.uploadPendingCrashes() 公开，供 Phase 2 调用
- startCrashCapture() 保持幂等，app 侧可选择性调用，不影响自动流程

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-18 10:11:08 +08:00
XuqmGroup
cc1557daf0 fix(bugcollect): 修复 fatal crash 不上报——startCrashCapture 从未被调用 
根本原因链：
1. XuqmInitializerProvider 只调用 XuqmSDK.autoInitialize，从不调用 startCrashCapture
2. 即使调用，startCrashCapture 检查 bugCollectApiUrl == null 即提前返回；
   而 bugCollectApiUrl 由远端配置下发，崩溃发生时往往尚未到达
3. UncaughtExceptionHandler 从未注册，崩溃文件没有写入，下次启动无数据可上报

修复：
- XuqmSDK 新增 platformUrl 属性（同步可用，初始化即有值）
- BugCollect.startCrashCapture 不再依赖 bugCollectApiUrl，
  用 platformUrl + "/api/bugcollect/" 作为兜底 URL 写入崩溃文件
- LogQueue.uploadPendingCrashes 优先使用崩溃文件内保存的 logApiUrl
- XuqmInitializerProvider 通过反射调用 BugCollect.startCrashCapture，
  在 SDK 初始化后立即注册 UncaughtExceptionHandler

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-18 10:05:43 +08:00
XuqmGroup
e300cbdb83 fix(bugcollect): 修复崩溃文件未写入导致 fatal crash 不上报的 bug 
根本原因：CrashCapture 调用无 Context 的 LogStorage.saveCrash 重载，
该重载通过反射获取 packageName 失败时返回空字符串，
导致崩溃文件路径变为 /data/data//files/xuqm_crashes（无效），
mkdirs() 静默失败，崩溃文件未写入，下次启动无数据可上报。

修复：
- CrashCapture.start() 新增 appContext: Context 参数
- 改为调用带 Context 的 saveCrash 重载，依赖 context.filesDir 获取可靠路径
- BugCollect.startCrashCapture() 传入 XuqmSDK.appContext
- LogStorage 删除不可靠的无 Context 重载及 getPackageName() 反射代码

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-18 09:43:47 +08:00
XuqmGroup
58d479523e fix: uniquePropNames 去重逻辑修复，避免重复 bump 版本 2026-06-17 19:14:37 +08:00
Jenkins CI
0a93127f01 ci: bump module versions [sdk-bugcollect,sdk-bugcollect-plugin] 2026-06-17 19:09:09 +08:00
XuqmGroup
76ce61b06d ci: sdk-bugcollect-plugin 随 sdk-bugcollect 自动联动，移除独立参数 2026-06-17 19:06:27 +08:00
Jenkins CI
5499376a08 ci: bump module versions [sdk-bugcollect] 2026-06-17 19:01:44 +08:00
Jenkins CI
ffcebf504a ci: bump module versions [sdk-bugcollect-plugin] 2026-06-17 18:53:09 +08:00
XuqmGroup
229de4d498 fix: bugcollect-plugin Java 17 → 21（Jenkins agent 已有 Java 21） 2026-06-17 18:51:59 +08:00
XuqmGroup
3959da7693 fix: bugcollect 模块 Java 11 → 17（Jenkins agent 无法下载 Java 11） 2026-06-17 18:39:34 +08:00
XuqmGroup
d47500be96 fix: foojay-resolver 升级到 1.0.0（修复 Gradle 9 IBM_SEMERU 兼容性） 2026-06-17 18:32:40 +08:00
XuqmGroup
c76b1326be fix: 添加 Gradle toolchain 自动下载（foojay-resolver），解决 Jenkins agent 缺少 Java 11 问题 2026-06-17 18:29:26 +08:00
XuqmGroup
a3d7e14fc1 ci: 替换 toUnique 为 Set，兼容 Jenkins Sandbox 2026-06-17 18:25:05 +08:00
XuqmGroup
4e422aa1c1 feat(jenkins): 添加 sdk-bugcollect-plugin 模块支持 
- 新增 MOD_BUGCOLLECT_PLUGIN 参数用于控制插件发布
- 配置环境变量映射以支持插件模块
- 实现版本属性共享机制，插件与 bugcollect 模块共用版本号
- 优化版本发布逻辑，支持多模块统一版本管理
- 区分构建任务，插件模块无需执行 assembleRelease 任务
- 添加构建流程控制，避免空模块构建报错
 2026-06-17 18:21:40 +08:00
Jenkins CI
ae2ba91e57 ci: bump module versions [sdk-core,sdk-im,sdk-push,sdk-update,sdk-webview,sdk-license,sdk-bugcollect] 2026-06-17 18:07:14 +08:00
XuqmGroup
0f8205063d feat(bugcollect): 更新 API 端点并改进数据结构 
- 将 Android SDK 的 mapping 上传端点从 /log/v1/sourcemaps/upload 更改为 /bugcollect/v1/sourcemaps/upload
- 将 RN SDK 的 API 端点从 /log/v1/ 统一更改为 /bugcollect/v1/
- 在 LogQueue.ts 的请求体中添加 sentAt 时间戳和 SDK 信息
- 重构 BugCollect.ts 中的事件结构，将 appVersion 重命名为 release，添加 environment 和 sdk 字段
- 将 JS 错误上报的类型从 js_error 改为 issue，并调整错误级别分类
- 为 warn 和 info 方法添加完整的 issue 事件结构
- 在 types.ts 中添加新的数据类型定义，包括 Level、Platform、SdkInfo、ExceptionInfo 等
- 为 IssueEvent 添加详细的异常信息结构，包括类型、值和堆栈跟踪
- 添加完整的错误收集 API v1 规范审阅报告文档
- 在数据库迁移脚本中为日志表添加新字段，包括级别、环境、设备信息、SDK 信息等
 2026-06-17 18:02:10 +08:00
XuqmGroup
d910f9e3e1 revert(sdk-core): 回滚 serverUrl 回退 baseUrl 的临时补丁 
服务端已修复 config.xuqm 始终写入 serverUrl，
SDK 不再需要 serverUrl ?: baseUrl 的兼容逻辑。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-17 16:44:24 +08:00
XuqmGroup
cb6b06e92d fix(sdk-core): 从 config.xuqm 读取 platformUrl 时 serverUrl 回退到 baseUrl 
config.xuqm 生成时使用 baseUrl 字段；SDK 只读 serverUrl 导致
回退到公有平台地址（404），修复为优先读 serverUrl，回退到 baseUrl。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-17 16:38:53 +08:00
XuqmGroup
da6c5f59e5 fix(bugcollect): remove invalid sdk param from IssueEvent in LogQueue 
IssueEvent does not have a sdk parameter; sdk info belongs to LogEvent only.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-17 15:59:37 +08:00
XuqmGroup
43e7c5655e fix(bugcollect): IssueEvent 补充 SdkInfo nested class，BugCollect 移除 IssueEvent 无效 sdk 参数 
IssueEvent 没有 sdk 字段导致 Kotlin 编译失败：
- IssueEvent.kt: 补充 SdkInfo 嵌套类（LogEvent.sdk 引用它）
- BugCollect.kt: captureError/captureCrash/warn 的 IssueEvent() 调用中删除
  sdk = IssueEvent.SdkInfo(...)（IssueEvent 无此参数，sdk 信息由 LogUploader 封装到 envelope 层）

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-17 15:38:27 +08:00
XuqmGroup
4896f24af8 feat(bugcollect): SDK v1.1.0 — 修复 packageName 缺失导致 captureError 静默失败 
Root cause: SdkPlatformConfigApi.fetchConfig 未传 packageName → 服务端返回400
→ bugCollectEnabled=false → captureError 是空操作

修复内容:
- SdkPlatformConfigApi: 增加 packageName 查询参数
- SdkPlatformConfig: 修正字段名 bugCollectApiUrl/features.bugCollect
- XuqmSDK: 传入 appContext.packageName，读取 features?.bugCollect
- Fingerprint: 使用 exceptionType（类名）替代 level 字符串，避免同一崩溃按级别分桶
- IssueEvent: 增加 eventId、breadcrumbs、DeviceInfo 扩展字段
- BugCollect: 增加 addBreadcrumb()，captureError/captureCrash 附加面包屑和设备信息
- LogUploader: 序列化 eventId/breadcrumbs/expanded device
- LogQueue: 崩溃恢复使用 exceptionType 重建 fingerprint

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-17 15:30:40 +08:00
XuqmGroup
a36097fcdb fix(sdk-update): awaitInitialization 同时等待远程平台配置完成 
确保 bugCollectEnabled 等远程配置字段在 checkAppUpdate 执行前已生效，
避免 captureError 因 isReady()=false 静默丢弃异常。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-17 13:30:37 +08:00
Jenkins CI
12bff04e0e ci: bump module versions [sdk-update] 2026-06-17 13:09:39 +08:00
XuqmGroup
16d8354064 fix(sdk-update): 40404 改为抛 IllegalStateException，走 onFailure 异常上报路径 
移除 serviceActivated 字段，服务未开通统一作为异常处理，
调用方通过 onFailure 捕获并上报（如 BugCollect.captureError）。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-17 13:08:08 +08:00
Jenkins CI
c4fcac1da8 ci: bump module versions [sdk-update] 2026-06-17 12:51:28 +08:00
XuqmGroup
5b21a7a52e feat(sdk-update): 服务未开通时返回 serviceActivated=false 
- UpdateInfo: 新增 serviceActivated: Boolean = true 字段
- UpdateSDK.checkAppUpdate: 服务端返回 code=40404 时返回 UpdateInfo(serviceActivated=false)
- UpdateInfoDto: 保持仅持有业务字段（无 serviceActivated），由 checkAppUpdate 根据响应 code 注入

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-17 12:22:24 +08:00