0

0

正确使用 ACTION_VIEW 打开 URI 图片避免黑屏的完整指南

碧海醫心

碧海醫心

发布时间:2026-03-04 11:14:18

|

892人浏览过

|

来源于php中文网

原创

正确使用 ACTION_VIEW 打开 URI 图片避免黑屏的完整指南

本文详解 android 中通过 intent.action_view 安全打开图片 uri 的标准做法,指出直接拼接 file:// 路径、错误解析文件扩展名或忽略权限授权等常见误区,并提供兼容 android 7.0+(fileprovider)的健壮实现方案。

本文详解 android 中通过 intent.action_view 安全打开图片 uri 的标准做法,指出直接拼接 file:// 路径、错误解析文件扩展名或忽略权限授权等常见误区,并提供兼容 android 7.0+(fileprovider)的健壮实现方案。

在 Android 开发中,调用系统图库或图片查看器打开一张图片看似简单,但若处理不当(如手动拼接 file:// URI、错误提取路径、忽略 URI 权限),极易导致应用崩溃或仅显示黑屏——这并非设备或 Viewer 问题,而是 Intent 构造不合规所致。

核心原则是:Uri 不等于 File,也不保证可被其他应用以文件路径方式访问。用户选择的图片可能来自相册、云存储、DocumentProvider 或 ContentProvider(如 content://media/...),其背后未必对应一个可公开读取的本地文件路径。强行用 uri.getPath() 拆分、拼接 file:// 前缀,不仅逻辑错误,更在 Android 7.0+ 上因 StrictMode 策略直接抛出 FileUriExposedException。

✅ 正确做法是:直接传递原始 Uri,并显式授予临时读取权限

String strAddress = getArguments().getString("Path");
Uri uri = Uri.parse(strAddress);

imgg.setOnClickListener(v -> {
    Intent intent = new Intent(Intent.ACTION_VIEW, uri);
    // 关键:授予目标 Activity 临时读取该 URI 的权限
    intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
    startActivity(intent);
});

该方案优势显著:

寻光
寻光

阿里达摩院寻光视频创作平台,以视觉AIGC为核心功能,用PPT制作的方式创作视频

下载
  • ✅ 兼容所有标准 URI 类型(content://, file://(仅调试)、content:// via FileProvider);
  • ✅ 无需手动推导 MIME 类型或文件后缀(系统自动解析);
  • ✅ 避免路径解析错误(如 split[1] 索引越界、: 分隔符误判);
  • ✅ 符合 Android 权限模型,尤其适配 Android 7.0+ 的 URI 权限隔离机制。

⚠️ 注意事项:

  • 若你的 Uri 来自 Intent.getData() 或 ActivityResultLauncher(如 ActivityResultContracts.GetContent),通常已是安全的 content:// URI,可直接使用;
  • 若 Uri 源于本地 File(如缓存图片),必须通过 FileProvider 转换为 content:// URI,不可直接用 Uri.fromFile()(Android 7.0+ 已废弃);
  • 在 AndroidManifest.xml 中声明 FileProvider(如需):
    <provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="${applicationId}.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>

    并在 res/xml/file_paths.xml 中配置可共享路径。

? 总结:放弃对“真实文件路径”的执念,拥抱 URI 抽象。始终以原始 Uri 为唯一可信输入,配合 FLAG_GRANT_READ_URI_PERMISSION 授权,即可稳定、安全地唤起系统图片查看器,彻底规避黑屏与崩溃问题。

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1940

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2116

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1150

2024.11.28

android开发三大框架
android开发三大框架

android开发三大框架是XUtil框架、volley框架、ImageLoader框架。本专题为大家提供android开发三大框架相关的各种文章、以及下载和课程。

332

2023.08.14

android是什么系统
android是什么系统

Android是一种功能强大、灵活可定制、应用丰富、多任务处理能力强、兼容性好、网络连接能力强的操作系统。本专题为大家提供android相关的文章、下载、课程内容,供大家免费下载体验。

1798

2023.08.22

android权限限制怎么解开
android权限限制怎么解开

android权限限制可以使用Root权限、第三方权限管理应用程序、ADB命令和Xposed框架解开。详细介绍:1、Root权限,通过获取Root权限,用户可以解锁所有权限,并对系统进行自定义和修改;2、第三方权限管理应用程序,用户可以轻松地控制和管理应用程序的权限;3、ADB命令,用户可以在设备上执行各种操作,包括解锁权限;4、Xposed框架,用户可以在不修改系统文件的情况下修改应用程序的行为和权限。

2119

2023.09.19

android重启应用的方法有哪些
android重启应用的方法有哪些

android重启应用有通过Intent、PendingIntent、系统服务、Runtime等方法。本专题为大家提供Android相关的文章、下载、课程内容,供大家免费下载体验。

284

2023.10.18

Android语音播放功能实现方法
Android语音播放功能实现方法

实现方法有使用MediaPlayer实现、使用SoundPool实现两种。可以根据具体的需求选择适合的方法进行实现。想了解更多语音播放的相关内容,可以阅读本专题下面的文章。

379

2024.03.01

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

4

2026.03.04

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号