关于ThumbnailUtils.createImageThumbnail()的API版本及文档疑问
Android 图片缩略图API常见疑问解答
疑问1:废弃的createImageThumbnail(String filePath, int kind)为何能在API23环境正常运行?API29以下使用是否安全?
- 该方法并非API29才新增,它实际从Android早期版本(如API 1)就已存在,官方文档标注的"API29及以上可使用"属于描述错误。Google在API29仅将其标记为废弃,并未移除方法实现,因此在API23这类低版本系统上仍能正常执行。
- 在API29以下版本使用是安全的:Android的"废弃(Deprecated)"标记仅代表官方不再推荐使用,不会立刻删除方法逻辑。只要你的应用目标SDK版本不强制禁用废弃API,且设备系统版本为API29以下(均保留了该方法),就能稳定使用。若后续需适配更高版本系统,建议逐步迁移到新的重载方法。
疑问2:Google文档显示该方法在API29中新增同时被废弃是否合理?若文档错误,实际新增的API版本是多少?
- 这种标注显然不合理,属于文档信息混淆。
createImageThumbnail(String filePath, int kind)实际在API 1就已作为MediaStore.Images.Thumbnails类的方法存在,并非API29新增。Google在API29的真实改动是:给旧方法添加废弃标记,同时新增了更灵活的createImageThumbnail(File file, Size size, CancellationSignal signal)重载方法,文档误将"新增重载"和"标记旧方法废弃"的信息合并,才出现了矛盾描述。
内容的提问来源于stack exchange,提问作者abc def
相关产品推荐
相关产品推荐

