什么是Alternative menu(替代菜单)
举个例子,Activity显示一个文本文件。如果用户想对文本文件进行编辑,Activity不提供编辑能力,但可由其他activity或者其他应用提供。我们将相关信息存储在一个intent中,例如该文本的Uri。这个intent可以匹配系统的多个应用,替代菜单将这些应用一一列出,菜单项的title就是该可被调用的activity的名字,图标也为该可被调用的activity的图表。
小例子说明
我们通过一个小例子进行学习,简单地打开一个URL:wei://flowingflying/helloworld。在之前Intent的学习中,我们通过schema的配置,匹配该URL,也就是我们已经有其他应用的Activity(Intent Basic Test)可以打开该URL。我们同时在App中新增一个activity也能打开该URL。这样,将在alternative菜单中加入两个菜单项,点击它们,将打开相应的activity,并通过intent传递相关的数据信息。
新增的acitivity名字为Invoke Action(好像应该是invoked才对,不好意思)。在AndroidManifest.xml中加入intent-fliter的描述即可,具体见:Pro Android学习笔记(十一):了解Intent(中) 。
<activity android:name=".InvokeAction" android:label="@string/invokeAction" android:icon="@drawable/leaf" >
<intent-filter >
<action android:name="android.intent.action.VIEW" />
<data android:scheme="wei" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.ALTERNATIVE" /><!-- 将在最后讨论 -->
</intent-filter>
</activity>
Alternative menu代码
我们看看如何将替代菜单加入到OptionMenu中。Alternative menu还可以加载subMenu,Context Menu中。
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// 对比:加入一个普通菜单项
menu.add("普通菜单项");
//【步骤1】设置intent,本例简单实用一个已知的Uri。
Intent menuIntent = new Intent(null,Uri.parse("wei://flowingflying/helloWorld"));
//【步骤2】加入Alternative菜单。在之前的Item ID类别中已经讲过,Android对ID进行了划分,有alternative的ID范围。
int menuGroup = Menu.CATEGORY_ALTERNATIVE;
int startingItemId = Menu.CATEGORY_ALTERNATIVE;
int orderId = Menu.CATEGORY_ALTERNATIVE;
menu.addIntentOptions( //返回增加的菜单项数目,本例为2
menuGroup, /* int groupId */
startingItemId, /* int itemId:由于自动跳转到,此参数可以设置为Menu.NONE。 */
orderId, /*int order*/
this.getComponentName(), /* ComponentName caller:当前的activity名字,这是android系统处理alternatice menu是调用的queryIntentActivityOptions()函数所需要的参数。getComponentName()返回package名字和class名字,系统以此获知源activity是谁。 */
null, /* Intent[] specifics:匹配可能有多个intent,此用于过滤,但具体用途不详 */
menuIntent, /* Intent intent:关键的intent */
0, /* flages:关于items如何加入。0表示 no flag*/
null); /* MenuItem[] outSpecificItems ,与specifice相关*/
return super.onCreateOptionsMenu(menu);
}
关于Category和规范代码写法
我们注意到,在被唤起的actvity中有下面的描述:
[html] view plaincopy
- <category android:name="android.intent.category.ALTERNATIVE" />
在试验中,发现此项可有可无,并不真正影响结果。而在reference中却明确表示要为CATEGORY_ALTERNATIVE或者CATEGORY_SELECTED_ALTERNATIVE。为何?
我们以Alternative menu的方式调用其他activity,正规的做法是,被唤起的activity应允许被alternative菜单唤起。因此被唤起的activity在intent-fliter中需给出类别。同时alternative菜单的intent也应当标明自己类型。因此规范的代码是:
Intent menuIntent = new Intent(null,this.getIntent().getData());
menuIntent.addCategory(Intent.CATEGORY_ALTERNATIVE);
在小例子中,由于其他应用的Activity(Intent Basic Test)在Manifest XML中并没有给出相应的类别,不被匹配。运行结果如图:
关于flags
menu.addIntentOptions()的倒数第二个参数是flags,表示菜单项添加的方式。0,即缺省,表示如果groupId相同,则替代菜单将取代原有的菜单项设置。如果我们想保留原有的同一Group的菜单项,可以将flags设置为Menu.FLAG_APPEND_TO_GROUP。注意,如果groupId为Menu.NONE是不进行替换的,这个表示不设置GroupId,并非GroupId为0。
多个匹配的itemId等参数
让我们看看系统是如何实现Alternative菜单的。从reference中看到,Menu是一个interface,具体是通过MenuBuilder实现(源代码见android-17(version)/com/android/internal/view/menu/MenuBuilder.java。相关代码如下:
public int addIntentOptions(int group, int id, int categoryOrder, ComponentName caller,
Intent[] specifics, Intent intent, int flags, MenuItem[] outSpecificItems) {
PackageManager pm = mContext.getPackageManager();
final List<ResolveInfo> lri = //查询匹配的Activity信息
pm.queryIntentActivityOptions(caller, specifics, intent, 0);
final int N = lri != null ? lri.size() : 0;
//下面说明如果flag表示FLAG_APPEND_TO_GROUP,会删除整个group,取而代之
if ((flags & FLAG_APPEND_TO_GROUP) == 0) {
removeGroup(group);
}
for (int i=0; i<N; i++) {
final ResolveInfo ri = lri.get(i);
Intent rintent = new Intent(
ri.specificIndex < 0 ? intent : specifics[ri.specificIndex]);
rintent.setComponent(new ComponentName(
ri.activityInfo.applicationInfo.packageName,
ri.activityInfo.name));
final MenuItem item = add(group, id, categoryOrder, ri.loadLabel(pm))
.setIcon(ri.loadIcon(pm))
.setIntent(rintent);
if (outSpecificItems != null && ri.specificIndex >= 0) {
outSpecificItems[ri.specificIndex] = item;
}
}
return N;
}
从源代码,可能看出如果有多个匹配,这些菜单项具有相同的group,相同的id,和相同categoryOrder。虽然我们在小例子中使用了startingItemId,但是实际上itemId是相同的。在小例子中,我们增加了public boolean onOptionsItemSelected(MenuItem item),并在里面检查item的参数值,证实确实相同。
这段代码还说明了菜单项的名字和图片为何,以及为何能唤起Activity。采用了setIntent(),是在Pro Android学习笔记(三十):Menu(1):了解Menu学习过的的一种触发机制。
本博文涉及的例子代码,可以在Pro Android学习:Menu中下载。