# XMBOX v3.0.7 Release Notes

## 🎯 重要更新

XMBOX v3.0.7 是一个重要的稳定性和用户体验升级版本，包含关键崩溃修复和全面的UI优化。

## 🐛 核心修复

### 关键崩溃修复
- **修复 VodConfig 空指针崩溃** - 解决应用销毁时的 NullPointerException
- **修复 LiveConfig 初始化问题** - 增强单例模式的安全性
- **优化生命周期管理** - 改进 Activity 销毁时的资源清理

### 稳定性提升
- 添加构造函数初始化，防止 clear() 方法空指针异常
- 增强错误处理机制和异常捕获
- 全面的空值安全检查

## 🎨 UI/UX 全面升级

### 新增隐私协议页面
- 符合应用商店规范的隐私政策界面
- 完善的任务栈管理，防止用户回退到协议页面
- 优雅的应用退出机制

### 界面优化
- **修复按钮文字显示** - 解决长文本显示不完整问题
  - 调整按钮文字大小：16sp → 13sp
  - 增加按钮高度：48dp → 56dp
  - 支持多行文本显示和居中对齐

### 空状态优化
- **恢复完整 Lottie 动画** - 54KB 高质量动画效果
- **位置调整** - 空状态动画向上移动 40dp，提升视觉平衡
- **川渝方言文案** - 更新为 "这里撒子内容都没得～"
- 新增多个专用空状态布局：搜索、收藏、通用

## 📺 TV版本专项优化

### 选集按钮优化
- **黄色高亮显示** - 选中状态文字改为黄色 (#FFEB3B)
- **专用颜色方案** - 新增 episode_text.xml 选择器
- **精准影响范围** - 仅修改视频详情页，不干扰其他界面

### 视觉体验提升
- 保持与手机版一致的核心功能
- 针对电视遥控器操作优化
- 更清晰的焦点状态指示

## ⚡ 技术改进

### 架构优化
- 改进单例模式的实现
- 增强并发安全性
- 优化内存使用效率

### 代码质量
- 添加完善的空值检查
- 改进异常处理逻辑
- 增强调试和错误报告机制

## 📱 平台支持

### Android 兼容性
- **最低要求**: Android 5.0 (API 21)
- **推荐版本**: Android 7.0 及以上
- **架构支持**: ARM64-V8A、ARM V7A

### 设备支持
- 手机、平板设备
- Android TV、机顶盒
- 各类智能电视设备

## 🔧 开发者信息

### 构建信息
- **编译日期**: 2025-09-26
- **Gradle 版本**: 8.13
- **Target SDK**: 34
- **签名**: 正式发布签名

### 文件大小
- **手机版 ARM64**: 37MB
- **手机版 ARM32**: 32MB  
- **TV版 ARM64**: 34MB
- **TV版 ARM32**: 30MB

## 📋 安装说明

### 首次安装
1. 下载对应架构的 APK 文件
2. 允许安装未知来源应用
3. 首次启动会显示隐私协议页面
4. 同意协议后即可正常使用

### 从旧版本升级
- 支持从 v3.0.0 及以上版本直接升级
- 用户数据和设置将自动保留
- 建议清除应用缓存以获得最佳体验

## ⚠️ 重要提醒

### 合规使用
- 本软件仅为技术性多媒体播放器外壳
- 不包含任何音视频内容
- 用户需自行配置合法的内容源
- 请遵守当地法律法规

### 隐私保护
- 新增的隐私协议确保用户知情同意
- 不收集用户个人信息
- 本地数据处理，保护用户隐私

## 🙏 致谢

感谢所有用户的反馈和建议，特别是：
- 崩溃报告和调试信息的提供者
- UI/UX 改进建议的贡献者
- 测试不同设备兼容性的志愿者

## 📞 支持与反馈

- **GitHub Issues**: https://github.com/Tosencen/XMBOX/issues
- **功能请求**: https://github.com/Tosencen/XMBOX/discussions
- **Bug 报告**: 请提供详细的设备信息和复现步骤

---

**基于 FongMi/TV 项目开发 | GPL-3.0 开源协议**

> 如果这个项目对你有帮助，请给我们一个 ⭐ Star！