转载

使用ACTION_PROCESS_TEXT来创建自定义的文本选择操作

英文原文： Creating custom Text Selection actions with ACTION_PROCESS_TEXT

Android 6.0 Marshmallow中介绍了一个新的浮动文字选择工具栏 , 它带有标准的文字选择操作，比如剪切，复制，与粘贴，这些操作紧挨着被选中的文字。更厉害的是新的 ACTION_PROCESS_TEXT ，它让任何app都能向文字选择工具栏中添加自定义操作。

诸如 Wikipedia 和 Google Translate 这样的app都已经利用它来实现选中文字的即时查找和翻译。

你可能已经看过关于在app中获得文字选择工具栏和选项的文档以及博客（简单的说来就是：使用一个标准的TextView或者EditText就可以了，但是要注意，如果你是使用的 AppCompatActivity 且想在 API 23+的设备上使用原生的文字选择工具栏，你的EditText应该有一个android:id并且需要调用 getDelegate() . setHandleNativeActionModesEnabled(false) ）。

但是如果你要寻找关于实现ACTION_PROCESS_TEXT以及添加自己的操作的信息，那么本文就是了。

跨app间通信 -> Intent Filters

正如你可能已经想到的，在建立app间的功能时，附加在每个组建上的Android Manifest 和 intent filters 担任着一个可以被其它app查询的公共API角色。

ACTION_PROCESS_TEXT也是如此。你将在manifest中的一个Activity 上添加一个 intent filter：

<activity android:name=”@string/process_text_action_name”>   <intent-filter>     <action android:name=”android.intent.action.PROCESS_TEXT”/     <category android:name=”android.intent.category.DEFAULT” />     <data android:mimeType=”text/plain” />   </intent-filter> </activity>

如果你想要多个操作，你需要为每个操作单独建立activity。如果你想建议专属于你自己的app的功能，不想被包含在其它app中，可以使用android:exported=”false”来确保这个操作只出现在你的app中。

注意Activity的android:name会作为文字选择工具栏的操作名来显示，所以确保它是简短的，动词化的，可以一眼就能识别出是你的app的。比如，谷歌翻译使用 ‘Translate’ 是因为翻译是一个不常用的操作（有多少人会安装多个翻译app？），而维基百科使用 ‘Search Wikipedia’ 是因为搜索对许多app来说是一个更常用的操作。

获取选中的文字

一旦你设置好了 intent filter ，其它的app就能通过选中文字并从文字选择工具栏中选择你的操作来启动你的activity。但是如果你并没有看到被选中的文字，其实这也没有什么卵用。

这就是 EXTRA_PROCESS_TEXT 的用处了。它是一个包含在代表被选中文字的intent中的 CharSequence 。－别被误导了，即便你使用的是一个text/plain intent filter，你也会得到带有一些 Spannable 的CharSequence，所以如果你在app中是直接使用的CharSequence并发现一些样式，不要感到惊讶（你总是可以调用 toString() 来去掉所有格式）。

所以，你的onCreate()方法看起来可能就像这样：

@Override protected void onCreate(Bundle savedInstanceState) {   super.onCreate(savedInstanceState);   setContentView(R.layout.process_text_main);   CharSequence text = getIntent()       .getCharSequenceExtra(Intent.EXTRA_PROCESS_TEXT);   // process the text }

给一个建议：如果你使用了 android:launchMode=”singleTop”,那么你应该也想在 onNewIntent() 中处理文字－一个比较好的做法是在 onCreate() 和onNewIntent() 中都调用一个你创建的handleIntent()方法。

以上就是你想使用 ACTION_PROCESS_TEXT 作为你app入口的全部信息：那么当进入你的入口之后，你该怎么做呢？

返回一个结果

在ACTION_PROCESS_TEXT Intent中还有另外一个extra ： EXTRA_PROCESS_TEXT_READONLY 。这个boolean extra指示你刚刚接收到的选中文字是否可以被用户编辑（比如在EditText中的情况）。

用下面的代码接收这个extra ：

boolean readonly = getIntent()   .getBooleanExtra(Intent.EXTRA_PROCESS_TEXT_READONLY, false);

你可以用它来为发送app提供替换选中文字的功能，这是因为你的Activity 实际上是 startActivityForResult() 来启动的－你可以在Activity 结束之前的任何时间调用 setResult() 来返回一个结果。

Intent intent = new Intent(); intent.putExtra(Intent.EXTRA_PROCESS_TEXT, replacementText); setResult(RESULT_OK, intent);

你可以想象使用一个 ‘Replace’ 这样的按钮去调用 setResult()，然后调用 finish() 来返回调用者Activity。

常见问题

在你写回复之前，这里是一些关于ACTION_PROCESS_TEXT的常见问题：

问题: 我可以触发带有ACTION_PROCESS_TEXT的Service 吗？

答案：不能直接这样做－系统只会查询包含了正确intent filter的Activity。但是这并不意味着你不能使用 Theme.Translucent.NoTitleBar 甚至 Theme.NoDisplay （只要你立即结束这个Activity ）主题Activity启动一个Service ，不过你要确保有对用户指明操作已收到的暗示。－比如一个通知或者Toast等。