Clipboard还能玩出花

Clipboard是Android提供的一个系统服务，它提供了一个全局的剪贴板，让文字、图片、数据，在多App间共享成为可能，今天，我们来了解下它的真面目，以及被玩坏的新姿势。

老规矩，Google API文档镇楼：
https://developer.android.com/guide/topics/text/copy-paste.html

说实话，如果不是为了让Clipboard玩出花，我真不想写这一篇，因为——这文档写的真是太TM详细了。

Clipboard应用

我们先来看看一些App对Clipboard的应用，例如手机迅雷，如果你复制了一个链接，那么打开迅雷后，会自动检测并提示下载：

2.png

再例如一些翻译软件，例如有道词典、沪江小D，他们都有一个功能，即复制查词，使用的也是这个原理，我这没装这些App，就不截图了，再例如比较常用的手淘喵口令，实际上也是利用这个功能，当然，也有一些比较专业的Clipboard App，例如Clipboard Actions：

3.png

我们可以看见，实际上，他就是帮你解析了各种可能的剪贴板，并对他们提供了各种后续功能的集合，确实非常实用，不过，看完今天的文章，相信你要写一个这样的App，估计也就分分钟。

OK，这些就是一些Clipboard的基本使用场景，更多场景，没有做不到，只有想不到。

基本使用

Clipboard的基本使用，就是三部曲。

获得ClipboardManager：

ClipboardManager mClipboardManager = mClipboardManager = 
(ClipboardManager) getSystemService(CLIPBOARD_SERVICE);

Copy：

ClipData mClipData;
String text = "hello world";
mClipData = ClipData.newPlainText("test", text);
mClipboardManager.setPrimaryClip(mClipData);

Paste：

ClipData clipData = mClipboardManager.getPrimaryClip();
ClipData.Item item = clipData.getItemAt(0);
String text = item.getText().toString();

结束了，简直不能再简单，API文档也写的非常详细，Demo都写了好几个。

不止于文字

我们可以创建以下三种类型的ClipData：

对应的，我们也能获取到不同类型的ClipData。

ClipboardManager管理

ClipboardManager中有很多判断与操作方法：

玩出一朵小FaFa

在了解了上面这些内容后，我们就可以做一些比较有意思的东西了，例如，我们可以通过监控用户剪贴板中的内容，来做一些自动的推断，例如，用户复制了一个英文单词，那么我们可以推断，用户可能要进行翻译，再例如，用户复制了一个链接，那么我们也可以推断，用户可能需要打开这个链接，等等。

Google在文档中，直接给出了示例的代码：

// Examines the item on the clipboard. If getText() does not return null, the clip item contains the
// text. Assumes that this application can only handle one item at a time.
 ClipData.Item item = clipboard.getPrimaryClip().getItemAt(0);

// Gets the clipboard as text.
pasteData = item.getText();

// If the string contains data, then the paste operation is done
if (pasteData != null) {
    return;

// The clipboard does not contain text. If it contains a URI, attempts to get data from it
} else {
    Uri pasteUri = item.getUri();

    // If the URI contains something, try to get text from it
    if (pasteUri != null) {

        // calls a routine to resolve the URI and get data from it. This routine is not
        // presented here.
        pasteData = resolveUri(Uri);
        return;
    } else {

    // Something is wrong. The MIME type was plain text, but the clipboard does not contain either
    // text or a Uri. Report an error.
    Log.e("Clipboard contains an invalid data type");
    return;
    }
}

其实非常简单，就是判断三种复制类型，但是我们可以在App中设置一些类似Scheme的标记，用来进行一些功能的区分，就好像淘宝的喵口令——『喵口令XXXXXXX喵口令』，我们可以通过解析这些Scheme，来获取内容，并进行对应的操作。这也是我们前面提到的Clipboard Actions这个App做的事情。

玩出一朵大FaFa

我们首先来看ClipData.Item.coerceToText()这样一个方法，这个方法可以将剪贴板里面的内容，直接转化为文字，但是这个转换，是有一定算法的，在API文档中有比较详细的说明，这里简单的看下：

1.png

这个东西能干什么呢，我们知道，有些App会复制之后，打开一个Intent，为了简单，会直接通过ClipData.Item.coerceToText()来返回一个Intent的URI，然后通过解析URI来启动Intent，那么这里就可以被我们来利用了。

public void fakeClipboard() {
    // 添加一个假的Intent，模拟用户最新加入的剪贴板内容
    Intent intent = new Intent();
    intent.setComponent(new ComponentName("com.hjwordgames", "com.hjwordgames.Splash"));
    intent.setAction("android.intent.action.VIEW");
    ClipData setClipData;
    setClipData = ClipData.newIntent("intent", intent);
    mClipboardManager.setPrimaryClip(setClipData);

    // 呵呵哒 App以为获取的是自己需要的Intent，结果却被狸猫换太子
    ClipData clipData = mClipboardManager.getPrimaryClip();
    ClipData.Item myItem;
    myItem = clipData.getItemAt(0);
    String clipDataString = myItem.coerceToText(this.getApplicationContext()).toString();
    try {
        Intent myIntent = Intent.parseUri(clipDataString, 0);
        startActivity(myIntent);
    } catch (URISyntaxException e) {
        e.printStackTrace();
    }
}

其实不一定是通过Fake Intent，其它的文字、图片等等，都可以被『偷天换日』。

另外，要实现这个监听，我们需要注册一个回调——addPrimaryClipChangedListener，Android真是体贴到没朋友：

mClipboardManager.addPrimaryClipChangedListener(new ClipboardManager.OnPrimaryClipChangedListener() {
    @Override
    public void onPrimaryClipChanged() {
        Log.d("xys", "onPrimaryClipChanged: ");
    }
});

那么在这里，我们就可以完全实现剪贴板的『狸猫换太子』。那么假如我们是一个『某淘』软件的竞品，那么完全可以让『汪口令』失效，甚至替换为我们自己的应用，同理，还有一些翻译类软件也是一样，不过还好，也许是我的内心比较阴暗，目前还没有看见这样的App。