Android 编程下快捷图标的创建

创建快捷图标的方式

在 Launcher 界面手工添加快捷图标

通过代码向 Launcher 中的广播接收者发送广播来创建快捷图标

创建快捷图标的原理

采用了 Android 系统的广播机制，发送一个广播，Android 系统的 Launcher 中的 InstallShortcutReceiver 在接收到这个广播之后，快捷图标就会被创建。

创建快捷图标的权限

参见：https://github.com/android/platform_packages_apps_launcher/blob/master/AndroidManifest.xml

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

桌面快捷图标的数据保存在手机的 /data/data/com.android.launcher/databases/launcher.db 中，同时系统对外提供了一个 LauncherProvider 供外界进行访问。在 launcher.db 的 favorites 表中保存了具体的数据，可以通过 LauncherProvider 中的 authorities 加 favorites 的形式来访问 favorites 表；考虑到程序的兼容性 authorities 的值要根据不同的 SDK 版本来进行设置，在 SDK 版本 2.0 之前 authorities 的值为：com.android.launcher.settings，而在 SDK 2.0 之后 authorities 的值为：com.android.launcher2.settings；具体参考不同 SDK 版本下 Laucher 中的 AndroidManifest.xml，本文中仅提供 2.0 版本之前的 LauncherProvider 配置信息：

<!-- The settings provider contains Home's data, like the workspace favorites -->
<provider
android:name="LauncherProvider"
android:authorities="com.android.launcher.settings"
android:writePermission="com.android.launcher.permission.WRITE_SETTINGS"
android:readPermission="com.android.launcher.permission.READ_SETTINGS" />

创建快捷图标的实现

文件：MainActivity

package cn.sunzn.cshortcut;

import android.app.Activity;
import android.content.ComponentName;
import android.content.Intent;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.os.Parcelable;
import android.view.Menu;

public class MainActivity extends Activity {

public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
createShortCut();
}

/**
* 创建快捷图标
*/
private void createShortCut() {
// 先判断该快捷是否存在
if (!isExist()) {
Intent intent = new Intent();
// 指定动作名称
intent.setAction("com.android.launcher.action.INSTALL_SHORTCUT");
// 指定快捷方式的图标
Parcelable icon = Intent.ShortcutIconResource.fromContext(this, R.drawable.youtube);
intent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, icon);
// 指定快捷方式的名称
intent.putExtra(Intent.EXTRA_SHORTCUT_NAME, "YouTube");
// 指定快捷图标激活哪个activity
Intent i = new Intent();
i.setAction(Intent.ACTION_MAIN);
i.addCategory(Intent.CATEGORY_LAUNCHER);
ComponentName component = new ComponentName(this, MainActivity.class);
i.setComponent(component);
intent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, i);
sendBroadcast(intent);
}
}

/**
* 判断快捷图标是否在数据库中已存在
*/
private boolean isExist() {
boolean isExist = false;
int version = getSdkVersion();
Uri uri = null;
if (version < 2.0) {
uri = Uri.parse("content://com.android.launcher.settings/favorites");
} else {
uri = Uri.parse("content://com.android.launcher2.settings/favorites");
}
String selection = " title = ?";
String[] selectionArgs = new String[] { "YouTube" };
Cursor c = getContentResolver().query(uri, null, selection, selectionArgs, null);

if (c != null && c.getCount() > 0) {
isExist = true;
}

if (c != null) {
c.close();
}

return isExist;
}

/**
* 得到当前系统SDK版本
*/
private int getSdkVersion() {
return android.os.Build.VERSION.SDK_INT;
}

public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.activity_main, menu);
return true;
}

}

文件：AndroidManifest.xml

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="cn.sunzn.cshortcut"
android:versionCode="1"
android:versionName="1.0" >

<uses-sdk
android:minSdkVersion="8"
android:targetSdkVersion="15" />
<uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"/>
<uses-permission android:name="com.android.launcher.permission.READ_SETTINGS"/>

<application
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<activity
android:name=".MainActivity"
android:label="@string/title_activity_main" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />

<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>

</manifest>