如何自定义Intent.createChooser的显示结果
Intent是android核心的概念之一,Intent为android系统提供了真正的开放。android的姿态是开放了,但却没有做到位。
拿“发邮件”这一功能来说,为了使用Intent机制来发送邮件,调用方需要知道Intent的规则,如action、uri、MIMEtype和category。但是在哪里能找到这些规则呢?官方文档里没有,还好能求助google,然后就发现StackOverflow有无数的人提过或者困惑于这个问题。从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指定的应用。你会发现选择界面中出现了重复的应用。