ApplicationInfo.java

/*
 * Copyright (C) 2008 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.android.launcher2;

import android.content.ComponentName;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.content.pm.PackageManager.NameNotFoundException;
import android.content.pm.ResolveInfo;
import android.graphics.Bitmap;
import android.util.Log;

import java.util.ArrayList;
import java.util.HashMap;

/**
 * 在“所有程序”界面里表示一个图标
 */
class ApplicationInfo extends ItemInfo {
	private static final String TAG = "Launcher2.ApplicationInfo";

	/**
	 * 打开一个app的intent.
	 */
	Intent intent;

	/**
	 * 图标
	 */
	Bitmap iconBitmap;

	/**
	 * 安装时间
	 */
	long firstInstallTime;

	ComponentName componentName;

	static final int DOWNLOADED_FLAG = 1;
	static final int UPDATED_SYSTEM_APP_FLAG = 2;

	int flags = 0;

	ApplicationInfo() {
		itemType = LauncherSettings.BaseLauncherColumns.ITEM_TYPE_SHORTCUT;
	}

	/**
	 * Must not hold the Context. 不能持有Context
	 */
	public ApplicationInfo(PackageManager pm, ResolveInfo info,
			IconCache iconCache, HashMap<Object, CharSequence> labelCache) {
		final String packageName = info.activityInfo.applicationInfo.packageName;

		this.componentName = new ComponentName(packageName,
				info.activityInfo.name);
		this.container = ItemInfo.NO_ID;
		this.setActivity(componentName, Intent.FLAG_ACTIVITY_NEW_TASK
				| Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);

		try {
			int appFlags = pm.getApplicationInfo(packageName, 0).flags;
			if ((appFlags & android.content.pm.ApplicationInfo.FLAG_SYSTEM) == 0) {
				flags |= DOWNLOADED_FLAG;

				if ((appFlags & android.content.pm.ApplicationInfo.FLAG_UPDATED_SYSTEM_APP) != 0) {
					flags |= UPDATED_SYSTEM_APP_FLAG;
				}
			}
			firstInstallTime = pm.getPackageInfo(packageName, 0).firstInstallTime;
		} catch (NameNotFoundException e) {
			Log.d(TAG, "PackageManager.getApplicationInfo failed for "
					+ packageName);
		}

		iconCache.getTitleAndIcon(this, info, labelCache);
	}

	public ApplicationInfo(ApplicationInfo info) {
		super(info);
		componentName = info.componentName;
		title = info.title.toString();
		intent = new Intent(info.intent);
		flags = info.flags;
		firstInstallTime = info.firstInstallTime;
	}

	/**
	 * Returns the package name that the shortcut's intent will resolve to, or
	 * an empty string if none exists.
	 */
	String getPackageName() {
		return super.getPackageName(intent);
	}

	/**
	 * 建立app的intent. Sets {@link #itemType} to
	 * {@link LauncherSettings.BaseLauncherColumns#ITEM_TYPE_APPLICATION}.
	 * 
	 * @param className
	 *            the class name of the component representing the intent
	 * @param launchFlags
	 *            the launch flags
	 */
	final void setActivity(ComponentName className, int launchFlags) {
		intent = new Intent(Intent.ACTION_MAIN);
		intent.addCategory(Intent.CATEGORY_LAUNCHER);
		intent.setComponent(className);
		intent.setFlags(launchFlags);
		itemType = LauncherSettings.BaseLauncherColumns.ITEM_TYPE_APPLICATION;
	}

	@Override
	public String toString() {
		return "ApplicationInfo(title=" + title.toString() + ")";
	}

	public static void dumpApplicationInfoList(String tag, String label,
			ArrayList<ApplicationInfo> list) {
		Log.d(tag, label + " size=" + list.size());
		for (ApplicationInfo info : list) {
			Log.d(tag, "   title=\"" + info.title + "\" iconBitmap="
					+ info.iconBitmap + " firstInstallTime="
					+ info.firstInstallTime);
		}
	}

	public ShortcutInfo makeShortcut() {
		return new ShortcutInfo(this);
	}
}