Android ApiDemos示例解析(24)：App->Launcher Shortcuts

比如说你的应用中有个功能用户可能会经常使用，比如说地图中查询地址，正常情况下用户需要先启动主Activity，可能需要经过几次菜单选择或是其它方式才能进到这个功能，用户可能感觉到不方便，这是可以为这个功能在Home Screen建立一个快捷方式，用户按这个快捷方式后会直接进入这个功能界面，即使这个Activity不是主Activity。
Launcher Shortcuts就是介绍了如何为某个非主Activity在Home Screen上建立一个快捷方式。
实现这个快捷方式，可以分下面几步来完成：
1.为需要创建快捷方式的Activity的<intent-filter>添加<action android:name=”android.intent.action.CREATE_SHORTCUT” /> ，标识这个Activity可以支持在Home Screen上添加快捷方式。Launcher Shortcuts 是采用的是activity-alias，activity-alias为Target的别名，类似于Activity.
2.添加相应用户添加快捷方式的代码，一般在Activity的onCreate方法中为Activity安装快捷方式：
[java] 
1. if (Intent.ACTION_CREATE_SHORTCUT.equals(action)) 
2. { 
3.  setupShortcut(); 
4.  finish(); 
5.  return; 
6. } 
7.   
8. ... 
9. private void setupShortcut() { 
10.  // First, set up the shortcut intent.  
11.  //For this example, we simply create an intent that  
12.  // will bring us directly back to this activity.  
13.  //A more typical implementation would use a  
14.  // data Uri in order to display a more specific result,  
15.  //or a custom action in order to  
16.  // launch a specific operation.  
17.   
18.  Intent shortcutIntent = new Intent(Intent.ACTION_MAIN); 
19.  shortcutIntent.setClassName(this, this.getClass().getName()); 
20.  shortcutIntent.putExtra(EXTRA_KEY, "ApiDemos Provided This Shortcut"); 
21.   
22.  // Then, set up the container intent (the response to the caller)  
23.   
24.  Intent intent = new Intent(); 
25.  intent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent); 
26.  intent.putExtra(Intent.EXTRA_SHORTCUT_NAME, getString(R.string.shortcut_name)); 
27.  Parcelable iconResource = Intent.ShortcutIconResource.fromContext( 
28.  this,  R.drawable.app_sample_code); 
29.  intent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, iconResource); 
30.   
31.  // Now, return the result to the launcher  
32.   
33.  setResult(RESULT_OK, intent); 
34. } 
 

 
如果用户想为某个Activity创建快捷方式，方法是在Home Screen的空白处长按，这时Android会显示用户可以选择添加的桌面种类列表，选择Shortcut（快捷方式）后，Android会列出所有定义了android.intent.action.CREATE_SHORTCUT的所有应用：

 
此时如果选择ApiDemos，那么Add to Home Screen会启动LauncherShortcuts Activity，发出请求的Intent的action 会设置为Intent.ACTION_CREATE_SHORTCUT，因此可以在onCreate中使用Intent.ACTION_CREATE_SHORTCUT.equals(action)来判断请求是来自Add to Home Screen还是用户选择App->Launcher Shorts。如果是来自Add to Home Screen，Launcher Shortcuts则为本Activity创建一个快捷方式setupShortcut，然后退出。
Add to Home Screen 发出Intent请其后（运行startActivityForResult)，预期从LauncherShortcuts返回一个结果，这也是为什么setupShortcut需要返回一个结果。对应创建的快捷方式的Intent至少需要定义三个参数：SHORTCUT_INTENT (value: Intent), SHORTCUT_NAME (value: String),  SHORTCUT_ICON (value: Bitmap)或SHORTCUT_ICON_RESOURCE (value: ShortcutIconResource).
本例是为当前Activity(LauncherShortcuts)创建快捷方式，实际应用中可以根据需要为别的Activity或是提供一个列表供用户来选择需创建的快捷方式。
本例在Home Screen创建一个Sample 快捷方式，选择该快捷方式后，直接进入Launcher Shortcuts，而无需从App再进入Launcher Shortcuts
 
作者：mapdigit
 
 

补充：移动开发 , Android ,

上一个：Android ApiDemos示例解析(26)：App->Notification->IncomingMessage
下一个：Android ApiDemos示例解析(25)：App->Menu->Inflate from XML