Android 剪贴板详解

版权声明：本文为博主原创文章，未经博主允许不得转载。
微博：厉圣杰
源码：AndroidDemo/Clipboard
如本文有助于你理解 Android 剪贴板，不妨给我一个 Star。对于码农而言，Star 是我们分享的动力~
文中如有纰漏，欢迎大家留言指出。

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

Android 剪贴板框架如图


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

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

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

4. 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 ，后面会有例子讲到。

剪贴板简单使用

以拷贝文本为例，剪贴板的使用可以分为以下几步：

1. 获取 ClipManager 对象

   ClipManager clipManager = (ClipManager) context.getSystemService(Context.CLIPBOARD_SERVICE);

2. 将数据放到 clip 对象中

   ClipData clip = ClipData.newPlainText("simple text copy", "Hello World!");

   类似的方法还有

   //创建一个包含 htmlText 的 ClipData
   //一般在浏览器中对网页进行拷贝的时候会调用此方法
   //其中 htmlText 是包含 HTML 标签的字符串
   static public ClipData newHtmlText(CharSequence label, CharSequence text, String htmlText);
   //创建一个包含 Intent 的 ClipData
   static public ClipData newIntent(CharSequence label, Intent intent);
   //创建一个包含 Uri 的 ClipData，MimeType 会根据 Uri 进行修改
   static public ClipData newUri(ContentResolver resolver, CharSequence label, Uri uri);
   //与 newUri 相对应，但是并不会根据 Uri 修改 MimeType
   static public ClipData newRawUri(CharSequence label, Uri uri);

3. 将 clip 对象放入剪贴板

   clipManager.setPrimaryClip(clip);

4. 从剪贴板中获取 clip 对象

   //判断剪贴板里是否有内容
   if(!clipManager.hasPrimaryClip()) {
       return;
   }
   ClipData clip = clipManager.getPrimaryClip();
   //获取 ClipDescription
   ClipDescription description = clip.getPrimaryClipDescription();
   //获取 label
   String label = description.getLabel().toString();
   //获取 text
   String text = clip.getItemAt(0).getText().toString();

实践出真知

讲道理，实践出真知，咱们程序员的实践就是代码，下面上代码。等等，先上 Demo 的运行效果图。第一次做 Gif ，好紧张，哈哈~若动态图不动，查看原图连接应该就可以了~


对于剪贴板大部分操作都封装在 ClipboardUtil.java 里，使用时请记录调用 init(Context context) 方法进行初始化，建议在 Application.onCreate() 中进行，否则会造成内存泄漏。

AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.littlejie.clipboard">

    <!-- content://contacts/people 需要使用该权限-->
    <uses-permission android:name="android.permission.READ_CONTACTS" />
    <uses-permission android:name="android.permission.WRITE_CONTACTS" />

    <application
        android:name=".ClipboardApplication"
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>