ae-tracking 0.1.0

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk/android//346/233/264/346/226/260/346/227/245/345/277/227.md

@@ -0,0 +1,502 @@
+---
+code: android_sdk_release_note
+name: "更新日志"
+wikiToken: W439w7dWaijA0hkPluLcnnLEntb
+parentWikiToken: EnSPwbQvsi8Vm4km9JqcbhQ6nv2
+updateTime: 1772677812000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=android_sdk_release_note
+---
+# 更新日志
+
+### v3.3.6
+
+**更新时间: 2026/03/05 **下载
+
+**更新内容：**
+
+- 已知问题修复
+### v3.3.5
+
+**更新时间: 2026/01/09 **下载
+
+**更新内容：**
+
+- 已知问题修复
+### v3.3.4
+
+**更新时间: 2025/12/24 **下载
+
+**更新内容：**
+
+- 已知问题修复
+### v3.3.3
+
+**更新时间: 2025/12/03 **下载
+
+**更新内容：**
+
+- 修复登录登出账号时序问题
+- 已知问题修复
+### v3.3.2
+
+**更新时间: 2025/12/01 **下载
+
+**更新内容：**
+
+- 已知问题修复
+### v3.3.1
+
+**更新时间: 2025/11/07 **下载
+
+**更新内容：**
+
+- 已知问题修复
+### v3.3.0
+
+**更新时间: 2025/10/31 **下载
+
+**更新内容：**
+
+- debugOnly未配白名单的情况下，需要降级变为normal模式
+- 已知问题修复
+### v3.2.3
+
+**更新时间: 2025/09/24 **下载
+
+**更新内容：**
+
+- 已知问题修复
+### v3.2.2
+
+**更新时间: 2025/08/05 **下载
+
+**更新内容：**
+
+- 增加host
+### v3.2.1
+
+**更新时间: 2025/07/07 **下载
+
+**更新内容：**
+
+- 已知问题修复
+### v3.2.0
+
+**更新时间: 2025/06/06 **下载
+
+**更新内容：**
+
+- 初始化异步
+- 支持本地缓存加密
+- 新增registerErrorCallback接口
+- 已知问题修复
+### v3.1.1
+
+**更新时间: 2025/04/27 **下载
+
+**更新内容：**
+
+- 支持策略SDK
+- 已知问题修复
+### v3.0.3.1
+
+**更新时间: 2024/****11****/****04**** **下载
+
+**更新内容：**
+
+- 性能优化
+### v3.0.3
+
+**更新时间: 2024/04/10 **下载
+
+**更新内容：**
+
+- 支持DNS获取IP请求
+### v3.0.2
+
+**更新时间: 2024/03/25 **下载
+
+**更新内容：**
+
+- 修复install或者start事件预置属性丢失的问题
+### v3.0.1
+
+**更新时间: 2024/01/12 **下载
+
+**更新内容：**
+
+- 支持 JPush、FCM 的 Token 和相关事件的自动采集
+### v3.0.0.1
+
+**更新时间: 2023/11/27 **下载
+
+**更新内容：**
+
+- 修复多实例Bug
+### v3.0.0
+
+**更新时间: 2023/11/01 **下载
+
+**更新内容：**
+
+- 代码规范、注释规范
+- 修复debug模式下errorProperties报错
+- 修复ta_app_start事件时间延迟问题
+- 修复不开自动采集，退后台不会调用flush的问题
+- androidId延迟获取
+### v2.8.6
+
+**更新时间: 2023/08/25 **下载
+
+**更新内容：**
+
+- 适配安卓14
+- 修复子进程先初始化导致install事件丢失
+### v2.8.5 
+
+**更新时间: 2023/06/02 **下载
+
+**更新内容：**
+
+- API异步处理
+- 推送ops字段作为预置属性
+### v2.8.4
+
+**更新时间: 2023/4/13 **下载
+
+**更新内容：**
+
+- 部分API耗时优化
+- 已知bug修复
+### v2.8.3.3
+
+**更新时间: 2023/3/22**
+
+**更新内容：**
+
+- 支持推送点击事件自动回收
+### v2.8.3.2
+
+**更新时间: 2023/2/8**
+
+**更新内容：**
+
+- 修复ta_app_end事件丢失问题
+### v2.8.3
+
+**更新时间: 2022/11/10**
+
+**更新内容：**
+
+- 支持忽略三方aar中的Activity的浏览事件
+- 获取网络状态接口调用时机优化，仅在网络状态发生变化时重新获取网络状态
+- 部分代码重构
+- 已知bug修复
+### v2.8.2
+
+**更新时间: 2022/09/22**
+
+**更新内容：**
+
+- 新增预置属性#device_type 
+- 新增获取手机region信息接口
+- 部分代码优化
+### v2.8.1 
+
+**更新时间: 2022/06/08**
+
+**更新内容：**
+
+- 对外接口配置项调整 
+- 新增敏感属性隔离功能 
+- 默认禁用后台触发的start事件，可通过配置开启 
+- 部分功能优化 
+- 已知bug修复 
+### v2.8.0
+
+**更新时间: 2022/04/20**
+
+**更新内容：**
+
+- 支持三方数据接入 
+- 新增user_uniqAppend接口 
+- 添加加密功能 
+- 支持数据上报的暂停&开始，优化数据停止上报接口 
+- SDK性能优化 
+- 已知bug修复 
+### v2.7.6.1 
+
+**更新时间: 2022/02/07**
+
+**更新内容：**
+
+- 更新无痕埋点相关逻辑 
+- 修复部分已知问题 
+### v2.7.6  
+
+**更新时间: 2022/01/28**
+
+**更新内容:**
+
+- 支持ASM无痕埋点 
+
+### v2.7.5  
+
+**更新时间: 2022/01/17**
+
+**更新内容:**
+
+- 新增预置属性#install_time/#app_version/#simulator/#ram/#disk/#fps/#start_reason 
+- 计时事件属性增加#background_duration 
+- 增加SDK配置文件，可控制预置属性开关 
+- 增加自动采集事件回调 
+- 部分代码逻辑优化 
+### v2.7.4  
+
+**更新时间: 2021/12/17**
+
+**更新内容:**
+
+- 修复部分已知问题 
+- 代码结构优化 
+### v2.7.3  
+
+**更新时间: 2021/06/22**
+
+**更新内容:**
+
+- 新增字段实例名，可用于标识实例 
+- 新增自动采集事件自定义属性能力 
+- 支持复杂数据类型 
+- 代码优化 
+### v2.7.1 
+
+**更新时间: 2021/08/20**
+
+**更新内容:**
+
+- 适配HarmonyOS
+- 优化app_end事件采集逻辑
+- 代码优化
+### v2.7.0 
+
+**更新时间: 2021/06/16**
+
+**更新内容:**
+
+- 支持预置属性获取
+- 多进程业务场景下，支持在子进程中直接上报数据
+- 代码优化
+### v2.6.3 
+
+**更新时间: 2021/03/15**
+
+**更新内容:**
+
+- 适配 Android 11 
+- 适配 Target 30 
+- 优化网络信号获取逻辑 
+- 新增#bundle_id 预置属性(应用包名或进程名) 
+### v2.6.2
+
+**更新时间: 2020/10/29**
+
+**更新内容:**
+
+- 优化 install,start 事件上报逻辑
+- 优化数据传输格式
+- 默认网络上报策略调整为 2G/3G/4G/5G/WIFI
+- 优化大量日志输出出现 OOM 异常的问题
+### v2.6.0
+
+**更新时间: 2020/08/24**
+
+**更新内容:**
+
+- 支持首次事件, 允许传入自定义的 ID 校验是否首次上报
+- 支持可更新、可重写的事件
+### v2.5.6 
+
+**更新时间: 2020/06/28**
+
+**更新内容:**
+
+- 优化代码: 避免极端情况下，在开启自动采集时出现的空指针异常
+### v2.5.5
+
+**更新时间: 2020/06/22**
+
+**更新内容:**
+
+- 修复部分情况下延迟初始化造成首次启动事件无法采集的问题
+- 新增预置属性 #system_language
+- 优化部分预置属性取值逻辑，无值时不传
+- 优化部分代码和日志打印
+### v2.5.4 
+
+**更新时间: 2020/05/19**
+
+**更新内容:**
+
+- 为适配 Unity 2018.04 增加接口
+### v2.5.3 
+
+**更新时间: 2020/05/14**
+
+**更新内容:**
+
+- 适配 AE 后台 2.7 版本屏蔽事件配置接口
+- 调整 DEBUG 模式，去除客户端抛异常逻辑
+- 默认关闭 QuitSafelyService
+### v2.5.2
+
+**更新时间: 2020/04/29**
+
+**更新内容:**
+
+- 修复用户属性中时间类型格式化的问题.
+### v2.5.1
+
+**更新时间: 2020/04/14**
+
+**更新内容:**
+
+- 修复 DEBUG 模式下事件上报的 BUG.
+### v2.5.0 
+
+**更新时间: 2020/04/03**
+
+**更新内容:**
+
+- 支持客户端 SDK 的时间校准功能
+- 新增指定时间的用户属性设置接口
+### v2.4.3 
+
+**更新时间: 2020/03/06**
+
+**更新内容:**
+
+- 优化启动事件，在延迟初始化的情形下，保证安装事件先于启动事件发生
+### v2.4.2 
+
+**更新时间: 2020/03/06**
+
+**更新内容:**
+
+- 解决在第一个 Activity 展示之前初始化 SDK 时 ta_app_start 不准确
+### v2.4.1 
+
+**更新时间: 2020/03/04**
+
+**更新内容:**
+
+- 解决在第一个 Activity 停止之后初始化 SDK 引发的前后台判断错误问题
+### v2.4.0 
+
+**更新时间: 2020/02/10**
+
+**更新内容:**
+
+- 支持 JSONArray 类型
+- 支持 user_append 接口
+- 去除客户端的属性格式检查
+### v2.3.1 
+
+**更新时间: 2020/01/07**
+
+**更新内容:**
+
+- 支持设置数据的默认时区
+### v2.3.0 
+
+**更新时间: 2019/12/31**
+
+**更新内容:**
+
+- 支持 Debug 模式: 需配合后台 Debug 设备白名单一起开启(v2.5 版本开始支持)
+- H5 与原生 SDK 打通支持多实例
+- 优化 SDK 配置: 增加全局设置;上报策略允许针对不同项目配置;支持向多个集群发送数据
+- 支持自签证书: 允许传入 SSLSocketFactory 自定义认证过程
+- 其他优化: 
+- 优化安全退出逻辑，避免出现 ANR
+- 去除对字符串类型的数据的长度限制
+### v2.2.2 
+
+**更新时间: 2019/11/04**
+
+**更新内容:**
+
+- 修复当 API level 小于 18（Android 4.3）时，退出异常
+### v2.2.0 
+
+**更新时间: 2019/10/22**
+
+**更新内容:**
+
+- 支持重置用户属性接口`user_unset`
+- 新增`track`接口重载，支持按照指定时区上传事件数据
+- 新增预置属性`#zone_offset`，单位为小时。 默认情况下会将本地时区的偏移上报到服务端，该时间偏移会受夏令时影响。满足如下公式：
+```
+utc_time + #zone_offset = #event_time
+```
+
+### v2.1.0 
+
+**更新时间: 2019/08/31**
+
+**更新内容：**
+
+- 支持轻量级实例, 便于上报被动事件等需求
+- 新增 `enableTracking` 接口, 可以打开或关闭实例上报功能
+- 新增 `optOutTracking`/`optInTracking` 接口
+- 优化上报逻辑，改进上报的频率和时效性
+- 其他一些小的改进点
+### v2.0.1 
+
+**更新时间: 2019/07/12**
+
+**更新内容：**
+
+- 支持 H5 与自动采集事件新增 APP 安装事件
+### v2.0.0 
+
+**更新时间: 2019/07/10**
+
+**更新内容：**
+
+- 重构自动采集逻辑（需要配合 2.0 版本的插件编译）： 
+- 去除 SDK 的第三方库依赖
+- `Fragment` 浏览事件不再需要继承 `BaseFragment`, 并加注解
+- 新增 `TimePicker`，`DatePicker` 等控件的点击事件采集
+- 新增 `getDeviceId()` 接口
+- 自动采集事件新增 APP 安装事件
+- 优化属性检测逻辑：当字符串类型的数据超出 2048 字节时，会自动截断并上传
+- 优化日志打印，更方便集成阶段的埋点测试
+- 针对提升 SDK 稳定性和运行效率的其他代码优化
+- minSdkVersion 升到 14
+### v1.3.0 
+
+**更新时间: 2019/06/18**
+
+**更新内容：**
+
+- 新增多 APPID 实例功能
+- 新增动态公共属性特性
+- 自动采集事件新增 APP 崩溃事件
+- 稳定性提升：适配 Android Q、去除非必须的权限申请、优化运营商获取逻辑、支持 5G 等
+### v1.2.0
+
+**更新时间: 2019/05/23**
+
+**更新内容：**
+
+- 支持 H5 与 APP 打通
+- 支持 androidx （需配合自动采集插件 1.2.0 之后的版本）
+- 优化部分代码逻辑
+### v1.1.7 
+
+**更新时间: 2019/01/08**
+
+**更新内容：**
+
+- 增加了上报数据的 Log 打印功能