如何自定义Intent.createChooser的显示结果

时间:2022-01-10 23:56:49

Intent是android核心的概念之一,Intent为android系统提供了真正的开放。android的姿态是开放了,但却没有做到位。

拿“发邮件”这一功能来说,为了使用Intent机制来发送邮件,调用方需要知道Intent的规则,如action、uri、MIMEtype和category。但是在哪里能找到这些规则呢?官方文档里没有,还好能求助google,然后就发现*有无数的人提过或者困惑于这个问题。从google搜索结果里没有看到导向官方文档的链接,由此大胆推测,官方文档确实没有相关的说明。

再者,从编写mail应用程序的角度来说,他们也迷茫-到底要支持那些Intent呢?我的Intent-filter到底要怎么写?难道是android team的geek精神作祟,一定要广大开发者分析gmail的apk才甘心?忍不住吐槽啊,这直接导致了用户体验不统一,程序猿编程不统一。

以上感受均来自我的一个非常合理的需求 - 发送多个附件的邮件

开始,我是这么做的

    Intent emailIntent = new Intent(Intent.ACTION_SEND_MULTIPLE);
emailIntent.putExtra(Intent.EXTRA_EMAIL, new String[]{emailTo});
emailIntent.putExtra(Intent.EXTRA_CC, new String[]{emailCC});
emailIntent.putExtra(Intent.EXTRA_SUBJECT, subject);
emailIntent.putExtra(Intent.EXTRA_TEXT, emailText);
ArrayList<Uri> uris = new ArrayList<Uri>();
for (String file : filePaths) {
File fileIn = new File(file);
Uri u = Uri.fromFile(fileIn);
uris.add(u);
}
emailIntent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, uris);
context.startActivity(Intent.createChooser(emailIntent, "Send mail..."));

结果除了我要的mail app,各种打酱油的Bluetooth、Evernote等等都出现在了选择列表中,选择太多对用户不是好事儿。这不是我想要的

为了限定所列出的选择全部都是mail application,我指定了Uri

    Intent emailIntent = new Intent(Intent.ACTION_SENDTO);
Uri uri = Uri.parse("mailto:"+emailTo+"?subject="+subject+"&body="+emailText);
emailIntent.setData(uri);
for (String file : filePaths) {
File fileIn = new File(file);
Uri u = Uri.fromFile(fileIn);
uris.add(u);
}
emailIntent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, uris);
context.startActivity(Intent.createChooser(emailIntent, "Send mail..."));

此时chooser界面显示的只有mail application了,但选择gmail时,程序崩溃;选择系统默认的邮件程序同样崩溃;只有K9 mail能够正常运行。查看了android源代码中mail application的源代码,发现在Uri的schema是mailto时,确实不支持附件;而K9源代码却处理了这种情况。

于是决定不
使用由Intent.createChooser启动的界面(其实就是ChooserActivity.java),而是自定义chooser界面。做了才发现,如果尽可能保持与ChooserActivity风格一致,工作量非常之大。最终放弃,去看看Intent还有没有什么可以挖掘的。

无心插柳柳成荫,发现Intent有个EXTRA_INITIAL_INTENTS,文档中这样描述

A Parcelable[] of Intent or LabeledIntent objects as set with
putExtra(String, Parcelable[]) of additional activities
 to place a the front of the list of choices,
when shown to the user with a ACTION_CHOOSER.

再看看ChooserActivity和ResolverActivity的源代码,由EXTRA_INITIAL_INTENTS指定的Intent会“有条件地”显示在选择界面上。什么条件呢?那就是一定要存在能够处理Intent.createIntent函数第一个参数Intent的Activity。于是代码如下

    Intent emailIntent = new Intent(Intent.ACTION_SEND_MULTIPLE);
emailIntent.putExtra(Intent.EXTRA_EMAIL, new String[]{emailTo});
emailIntent.putExtra(Intent.EXTRA_CC, new String[]{emailCC});
emailIntent.putExtra(Intent.EXTRA_SUBJECT, subject);
emailIntent.putExtra(Intent.EXTRA_TEXT, emailText);
ArrayList<Uri> uris = new ArrayList<Uri>();
for (String file : filePaths) {
File fileIn = new File(file);
Uri u = Uri.fromFile(fileIn);
uris.add(u);
}
emailIntent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, uris); PackageManager pm = context.getPackageManager();
Intent sendMultipleIntent = new Intent(Intent.ACTION_SEND_MULTIPLE);
List<ResolveInfo> aList = pm.queryIntentActivities(sendMultipleIntent, PackageManager.MATCH_DEFAULT_ONLY);
Intent mailIntent = new Intent(Intent.ACTION_SEND);
mailIntent.setData(Uri.fromParts("mailto", "", null));
List<ResolveInfo> bList = pm.queryIntentActivities(mailIntent, PackageManager.MATCH_DEFAULT_ONLY);
//TODO find out all target ResolbeInfo using aList and bList
List<ResolveInfo> targets = ...;
ArrayList<Intent> targetIntents = new ArrayList<Intent>();
for (ResolveInfo info : targets) {
ActivityInfo ai = info.activityInfo;
Intent intent = new Intent(emailIntent);
intent.setPackageName(ai.packageName);
intent.setClass(ai.packageName, ai.name);
targetIntents.add(intent);
}
Intent chooser = Intent.createChooser(targetIntents.remove(0), "Send mail...");
chooser.putParcelableArrayListExtra(Intent.EXTRA_INITIAL_INTENTS, targetIntents);
context.startActivity(chooser);

最终展现给用户的选择包括,符合createChooser第一个参数的应用(其实是指定了packageName和className的Intent),以及由EXTRA_INITIAL_INTENTS指定的应用。

注意,这里没有使用Intent.setComponent来明确指定要启动的Activity,而是通过setPackageName和setClass来指定。这是因为,在createChooser处理过程中,第一个参数intent指定的component会在ResolverActivity中强制被设置为null。这样的结果是什么呢?当component被设置为null后,targetIntents.remove(0)其实就是emailIntent,那么createChooser会显示所有满足emailIntent的应用,然后在加上由EXTRA_INITIAL_INTENTS指定的应用。你会发现选择界面中出现了重复的应用。