Android Clipboard 详解

最新推荐文章于 2025-04-21 16:50:30 发布

转载最新推荐文章于 2025-04-21 16:50:30 发布 · 727 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://segmentfault.com/a/1190000018333743

文章标签：

#移动开发

本文详细介绍了Android剪贴板框架的四大核心组件：ClipboardManager、ClipData、ClipData.Item和ClipDescription，以及它们如何支持文本、二进制数据流和复杂数据的复制与粘贴操作。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Android 提供了一个强大的剪贴板框架，用于复制和粘贴。它支持文本、二进制数据流或其它复杂的数据。

Android 剪贴板框架如图 copy_paste_framework

从图中可以看出，Android 剪贴板框架主要涉及到 ClipboardManager 、 ClipData 、 ClipData.Item 、 ClipDescription 这四个类。

关于这四个类的简介如下：

ClipboardManager 是系统全局的剪贴板对象，通过 context.getSystemService(CLIPBOARD_SERVICE) 获取。
ClipData ，即 clip 对象，在系统剪贴板里只存在一个，当另一个 clip 对象进来时，前一个 clip 对象会消失。
ClipData.Item ，即 data item，它包含了文本、 Uri 或者 Intent 数据，一个 clip 对象可以包含一个或多个 Item 对象。通过 addItem(ClipData.Item item) 可以实现往 clip 对象中添加 Item。
文本：文本是直接放在 clip 对象中，然后放在剪贴板里；粘贴这个字符串的时候直接从剪贴板拿到这个对象，把字符串放入你的应用存储中。
Uri：对于复杂数据的剪贴拷贝并不是直接将数据放入内存，而是通过 Uri 来实现，毕竟 Uri 的中文名叫：统一资源标识符。通过 Uri 能定位手机上所有资源，这当然能实现拷贝了，只不过需要做一些额外的处理工作。(对于 Uri 不是很理解，如有误，望指正~)
Intent：复制的时候 Intent 会被直接放入 clip 对象，这相当于拷贝了一个快捷方式。
ClipDescription ，即 clip metadata，它包含了 ClipData 对象的 metadata 信息。可以通过 getMimeType(int index) 获取（一般 index = 0，有兴趣的可以去看下 ClipData 的源码）。MimeType 一般有以下四种类型：

// 对应 ClipData newPlainText(label, text) 的 MimeType
public static final String MIMETYPE_TEXT_PLAIN = "text/plain";
// 对应 ClipData.newHtmlText(label, text, htmlText) 的 MimeType
public static final String MIMETYPE_TEXT_HTML = "text/html";
// 对应 ClipData.newUri(cr, label, uri) 的 MimeType
public static final String MIMETYPE_TEXT_URILIST = "text/uri-list";
// 对应 ClipData.newIntent(label, intent) 的 MimeType
public static final String MIMETYPE_TEXT_INTENT = "text/vnd.android.intent";

但 MIMETYPE_TEXT_URILIST 有点特殊，当 Uri 为 content://uri 时，它会转为具体的 MimeType ，后面会有例子讲到。