Android Launcher 详解
（1） Launcher的定义：Android系统启动后，加载的第一个程序，是其他应用程序的入口。
（2） Launcher的构成：HomeScreen（1.workspace(AppWidget,Wallpaper，Livefolder，ShortCut），2.HotSeats，3.AllApps/allApplist:GridView）
（3） 针对Launcher的开发类型：
1. 开发自定义的Launcher
2. 与Workspace相关的开发（AppWidget，Wallpaper，Livefolder，ShortCut）
（4） 解读Launcher源代码（以ShortCut为例），Launcher为系统级应用，位于Applications层。源代码位于MyAndroid\packages\apps\Launcher2中，可讲它导入eclipse中。
（5） 看Manifest文件可知，Launcher的主Activity为：com.android.launcher2.Launcher。下面是它的部分配置信息：
<activity android:name="com.android.launcher2.Launcher" android:launchMode="singleTask"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.HOME" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.MONKEY"/> </intent-filter> </activity>
（6） 关于Activity的四种加载模式（android:launchMode）：在多Activity开发中，有可能是自己应用之间的Activity跳转，或者夹带其他应用的可复用Activity。有可能会希望跳转到原来某个Activity实例，而不是产生大量重复的Activity。这就需要为Activity配置特定的加载模式，而不是默认的加载模式。
1. Standard：默认模式，每次激活Activity时都会创建Activity，并放入任务栈中。
2. singleTop：如果在任务栈栈顶正好存在该Activity的实例，就重用该实例（会调用实例的onNewIntent()），否则就会创建新的实例并放入栈顶，即使栈中已经存在该Activity的实例。
3. singleTask：如果在栈中已经有该Activity的实例，就会重用该实例，重用时，会让该实例回到栈顶，因此在它上面的实例将会被移出栈。
4. singleInstance：在一个新栈中创建该Activity的实例，并让多个应用共享该栈中的该Activity实例。一旦该模式的Activity实例已经存在于某个栈中，任何应用再激活该Activity时都会重用该栈中的实例( 会调用实例的onNewIntent() )。其效果相当于多个应用共享一个应用，不管谁激活该 Activity 都会进入同一个应用中。
（7） 当用户按菜单键中的添加按钮或者长按workspace中的空白区域，会弹出一个对话框（如下图所示）：
@Override
publicbooleanonOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
caseMENU_ADD:
addItems(); /* 按菜单键，添加按钮*/
returntrue;
caseMENU_MANAGE_APPS:
manageApps();
returntrue;
caseMENU_WALLPAPER_SETTINGS:
startWallpaper();
returntrue;
caseMENU_SEARCH:
@Override
publicbooleanonOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
caseMENU_ADD:
addItems(); /* 按菜单键，添加按钮*/
returntrue;
caseMENU_MANAGE_APPS:
manageApps();
returntrue;
caseMENU_WALLPAPER_SETTINGS:
startWallpaper();
returntrue;
caseMENU_SEARCH:
onSearchRequested();
returntrue;
caseMENU_NOTIFICATIONS:
showNotifications();
returntrue;
}
returnsuper.onOptionsItemSelected(item);
}
privatevoidaddItems() {
closeAllApps(true);
showAddDialog(mMenuAddInfo); /* 显示对话框 */
}
// 长按workspace空白区域
if (mWorkspace.allowLongPress()) {
if (cellInfo.cell == null) {
if (cellInfo.valid) {
// User long pressed on empty space
mWorkspace.setAllowLongPress(false);
mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS,
HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING);
showAddDialog(cellInfo);/* 显示对话框 */
}
} else {
if (!(cellInfo.cellinstanceof Folder)) {
// User long pressed on an item
mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS,
HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING);
mWorkspace.startDrag(cellInfo);
}
}
}
// showAddDialog方法
privatevoidshowAddDialog(CellLayout.CellInfocellInfo) {
mAddItemCellInfo = cellInfo;
mWaitingForResult = true;
showDialog(DIALOG_CREATE_SHORTCUT);
}
// showDialog方法会调用下面这个方法创建对话框
protected Dialog onCreateDialog(int id) {
switch (id) {
caseDIALOG_CREATE_SHORTCUT: // 注意这里的常量
returnnewCreateShortcut().createDialog();
caseDIALOG_RENAME_FOLDER:
returnnewRenameFolder().createDialog();
}
returnsuper.onCreateDialog(id);
}
// CreateShortcut为Launcher的内部类，看其中的pickShortcut()
// 方法，它实现很多接口
/**
* Displays the shortcut creation dialog and launches, if necessary, theappropriate activity.
*/
privateclassCreateShortcutimplementsDialogInterface.OnClickListener,
DialogInterface.OnCancelListener, DialogInterface.OnDismissListener,
DialogInterface.OnShowListener {
privateAddAdaptermAdapter;
Dialog createDialog() {
mAdapter = newAddAdapter(Launcher.this);
finalAlertDialog.Builder builder = newAlertDialog.Builder(Launcher.this);
builder.setTitle(getString(R.string.menu_item_add_item));
builder.setAdapter(mAdapter, this);
builder.setInverseBackgroundForced(true);
AlertDialog dialog = builder.create();
dialog.setOnCancelListener(this);
dialog.setOnDismissListener(this);
dialog.setOnShowListener(this);
return dialog;
}
publicvoidonCancel(DialogInterface dialog) {
mWaitingForResult = false;
cleanup();
}
publicvoidonDismiss(DialogInterface dialog) {
}
privatevoid cleanup() {
try {
dismissDialog(DIALOG_CREATE_SHORTCUT);
} catch (Exception e) {
// An exception is thrown if the dialog is not visible, which is fine
}
}
/**
* Handle the action clicked in the “Add to home” dialog.
*/
publicvoidonClick(DialogInterface dialog, int which) {
Resources res = getResources();
cleanup();
switch (which) {
caseAddAdapter.ITEM_SHORTCUT: {
// Insert extra item to handle picking application
pickShortcut(); //当点击对话框中的快捷方式项，会//调用此方法
break;
}
caseAddAdapter.ITEM_APPWIDGET: {
intappWidgetId = Launcher.this.mAppWidgetHost.allocateAppWidgetId();
Intent pickIntent = new Intent(AppWidgetManager.ACTION_APPWIDGET_PICK);
pickIntent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
// start the pick activity
startActivityForResult(pickIntent, REQUEST_PICK_APPWIDGET);
break;
}
caseAddAdapter.ITEM_LIVE_FOLDER: {
// Insert extra item to handle inserting folder
Bundle bundle = new Bundle();
ArrayList<String>shortcutNames = newArrayList<String>();
shortcutNames.add(res.getString(R.string.group_folder));
bundle.putStringArrayList(Intent.EXTRA_SHORTCUT_NAME, shortcutNames);
ArrayList<ShortcutIconResource>shortcutIcons =
newArrayList<ShortcutIconResource>();
shortcutIcons.add(ShortcutIconResource.fromContext(Launcher.this,
R.drawable.ic_launcher_folder));
bundle.putParcelableArrayList(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, shortcutIcons);
Intent pickIntent = new Intent(Intent.ACTION_PICK_ACTIVITY);
pickIntent.putExtra(Intent.EXTRA_INTENT,
new Intent(LiveFolders.ACTION_CREATE_LIVE_FOLDER));
pickIntent.putExtra(Intent.EXTRA_TITLE,
getText(R.string.title_select_live_folder));
pickIntent.putExtras(bundle);
startActivityForResult(pickIntent, REQUEST_PICK_LIVE_FOLDER);
break;
}
caseAddAdapter.ITEM_WALLPAPER: {
startWallpaper();
break;
}
}
}
publicvoidonShow(DialogInterface dialog) {
mWaitingForResult = true;
}
}
// pickShortcut()方法
privatevoidpickShortcut() {
Bundle bundle = new Bundle();
ArrayList<String>shortcutNames = newArrayList<String>();
shortcutNames.add(getString(R.string.group_applications));
bundle.putStringArrayList(Intent.EXTRA_SHORTCUT_NAME, shortcutNames);
ArrayList<ShortcutIconResource>shortcutIcons = newArrayList<ShortcutIconResource>();
shortcutIcons.add(ShortcutIconResource.fromContext(Launcher.this,
R.drawable.ic_launcher_application));
bundle.putParcelableArrayList(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, shortcutIcons);
Intent pickIntent = new Intent(Intent.ACTION_PICK_ACTIVITY);
pickIntent.putExtra(Intent.EXTRA_INTENT, new Intent(Intent.ACTION_CREATE_SHORTCUT));
pickIntent.putExtra(Intent.EXTRA_TITLE, getText(R.string.title_select_shortcut));
pickIntent.putExtras(bundle);
startActivityForResult(pickIntent,REQUEST_PICK_SHORTCUT); // 启动了一个Activity，其实是一个快捷方式//列表,一个回调方法
}
// 在onActivityResult()中
caseREQUEST_PICK_SHORTCUT:
processShortcut(data); // 回调此方法，data为Intent
break;
voidprocessShortcut(Intent intent) {
// Handle case where user selected "Applications"
String applicationName = getResources().getString(R.string.group_applications);
String shortcutName = intent.getStringExtra(Intent.EXTRA_SHORTCUT_NAME);
if (applicationName != null&&applicationName.equals(shortcutName)) {
Intent mainIntent = new Intent(Intent.ACTION_MAIN, null);
mainIntent.addCategory(Intent.CATEGORY_LAUNCHER);
Intent pickIntent = new Intent(Intent.ACTION_PICK_ACTIVITY);
pickIntent.putExtra(Intent.EXTRA_INTENT, mainIntent);
pickIntent.putExtra(Intent.EXTRA_TITLE, getText(R.string.title_select_application));
startActivityForResultSafely(pickIntent, REQUEST_PICK_APPLICATION);
} else {
startActivityForResultSafely(intent, REQUEST_CREATE_SHORTCUT); //这里还要启动一个Activity
}
}
caseREQUEST_CREATE_SHORTCUT:
completeAddShortcut(data, mAddItemCellInfo);
break;
/**
* Add a shortcut to the workspace.
*
* @param data The intent describing the shortcut.
* @paramcellInfo The position on screen where to create the shortcut.
*/
privatevoidcompleteAddShortcut(Intent data, CellLayout.CellInfocellInfo) {
cellInfo.screen = mWorkspace.getCurrentScreen();
if (!findSingleSlot(cellInfo)) return;
finalShortcutInfo info = mModel.addShortcut(this, data, cellInfo, false);
if (!mRestoring) {
final View view = createShortcut(info);
mWorkspace.addInCurrentScreen(view, cellInfo.cellX, cellInfo.cellY, 1, 1,
isWorkspaceLocked());
}
}
（8） 如何让你的应用支持创建Shortcut,即你的应用能够出现在快捷方式列表中。
// 单独创建一个Activity，例如ShortCut.java
// 配置此Activity
<activity
android:name=".ShortCut">
<intent-filter>
<actionandroid:name="android.intent.action.CREATE_SHORTCUT"/>
</intent-filter>
</activity>
// 以下是它的代码，这个startActivityForResultSafely(intent, //REQUEST_CREATE_SHORTCUT)方法会跳到这个Activity
publicclassShortCutextends Activity {
@Override
protectedvoidonCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
if(getIntent().getAction().equals(Intent.ACTION_CREATE_SHORTCUT)) {
Intent returnIntent = new Intent();
returnIntent.putExtra(Intent.EXTRA_SHORTCUT_NAME, "应用管理器");
returnIntent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, new Intent(this, ShowAppActivity.class));
/* returnIntent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,
Intent.ShortcutIconResource.fromContext(this, R.drawable.icon)); */
returnIntent.putExtra(Intent.EXTRA_SHORTCUT_ICON, R.drawable.icon);
setResult(RESULT_OK, returnIntent);
finish();
}
}
}
（9） 如何在用户第一次启动应用后，提示用户是否要创建Shortcut：现在Manifest文件中添加一个权限（<permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"></permission>）只要向Launcher发送一个广播，数据为一个Intent。此Intent与上面代码中的returnIntent类似，只要这个Intent添加一个Action（
intent.setAction("com.android.launcher.action.INSTALL_SHORTCUT")）。然后sendBroadcast(intent)。在Launcher中有个InstallShortcutReceiver.java，接受这个广播。
