Android Api Demos登顶之路（四十四）Launcher Shortcuts

通常情况下为一个应用添加快捷方式，只要在launcher中长按这个应用 的图标，系统就会为这个应用在桌面上创建一个快捷方式，名字与图标与launcher中应用的名字与图标相同。利用这种方法创建快捷方式 不需要对activity进行特殊的设置，是由系统自动完成的。
* 在android的早期版本中（我试了Api15的模拟器 该功能已经取消了）还可以通过在系统桌面长按，这时Android会显示用户可以选择添加 的桌面种类列表，选择Shortcut（快捷方式）后，Android会列出所有定义了android.intent.action.CREATE_SHORTCUT的所有应用. 我们就可以选择为列表中的某个activity添加快捷方式。利用这种方法添加快捷方式，需要处理activity，让它支持添加快捷方式。
* 这个demo演示的就是利用这种方式来为activity添加快捷方式。
activity_main.xml

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textAppearance="?android:attr/textAppearanceMedium"
        android:text="@string/hello_world" />
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textAppearance="?android:attr/textAppearanceMedium"
        android:text="intent:" />
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textAppearance="?android:attr/textAppearanceMedium"
        android:id="@+id/intent_info" />


</LinearLayout>

MainActivity

public class MainActivity extends Activity {

    private static final String EXTRA_KEY = "com.fishtosky.launchershortcuts.MainActivity";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // 在加载视图之前就进行判断，如果接收到的intent是创建快捷方式，那么就调用创建快捷方式的方法后，结束掉自己。
        Intent intent = getIntent();
        if (Intent.ACTION_CREATE_SHORTCUT.equals(intent.getAction())) {
            setupShortcut();
            finish();
            return;
        }
        // 如果是正常的打开应用则创建视图,并将意图的信息和意图中传递的数据显示在文本框中。
        // 在本例中如果使用launcher中正常的方式打开则extra为空，如果使用桌面的快捷方式打开则intent会传递字符串
        // 显示在文本上，以区别两种不同方式打开应用。
        setContentView(R.layout.activity_main);
        TextView intentInfo = (TextView) findViewById(R.id.intent_info);
        String info = intent.toString();
        String extra = intent.getStringExtra(EXTRA_KEY);
        if (extra != null) {
            info = info + " " + extra;
        }
        intentInfo.setText(info);
    }

    //设置快捷方式
    private void setupShortcut() {
        //创建一个意图，用于指明当我们点击快捷方式时需要打开的activity，这里打开的是自己
        Intent shortcutIntent=new Intent(Intent.ACTION_MAIN);
        shortcutIntent.setClassName(this, this.getClass().getName());
        shortcutIntent.putExtra(EXTRA_KEY, "这是通过快捷方式打开的应用！");

        //再创建一个意图，指明创建快捷方式的意图，快捷方式的名字和图标
        Intent intent=new Intent();
        intent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent);
        intent.putExtra(Intent.EXTRA_SHORTCUT_NAME, getString(R.string.app_name));
        Parcelable iconResource=Intent.ShortcutIconResource.fromContext(this, R.drawable.ic_launcher);
        intent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, iconResource);

        //设置返回的结果
        setResult(RESULT_OK, intent);
    }

}

配置文件：一是对activity进行配置。activity-alias在需要重复使用同一个activity时使用，直接理解就是activity的一个别名。比如在本例中我们可以在launcher中直接启动activity，也以可通过长按桌面为activity添加一个快捷方式，两种操作都调用了同一个activity，这个时候就需要用到activity-alias。

<activity-alias 
            android:name="ShortCut"
            android:targetActivity=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.CREATE_SHORTCUT" />
                <category android:name="android.intent.category.DEFAULT" />
            </intent-filter>
        </activity-alias>

二是要为创建快捷方式添加权限：

<uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"/>