Merge "Make UsageStats API comply with API Council" into lmp-dev (e43abf49) · Commits · e / os / android_frameworks_base

api/current.txt

+1 −1

Original line number	Diff line number	Diff line
		@@ -5748,7 +5748,7 @@ package android.app.usage {
		}

		public final class UsageStatsManager {
		method public android.util.ArrayMap<java.lang.String, android.app.usage.UsageStats> queryAndAggregateUsageStats(long, long);
		method public java.util.Map<java.lang.String, android.app.usage.UsageStats> queryAndAggregateUsageStats(long, long);
		method public android.app.usage.UsageEvents queryEvents(long, long);
		method public java.util.List<android.app.usage.UsageStats> queryUsageStats(int, long, long);
		field public static final int INTERVAL_BEST = 4; // 0x4

+3 −1

Original line number	Diff line number	Diff line
		@@ -106,7 +106,9 @@ public final class UsageEvents implements Parcelable {
		}

		/**
		* The time at which this event occurred.
		* The time at which this event occurred, measured in milliseconds since the epoch.
		* <p/>
		* See {@link System#currentTimeMillis()}.
		*/
		public long getTimeStamp() {
		return mTimeStamp;

+12 −4

Original line number	Diff line number	Diff line
		@@ -81,28 +81,36 @@ public final class UsageStats implements Parcelable {
		}

		/**
		* Get the beginning of the time range this {@link android.app.usage.UsageStats} represents.
		* Get the beginning of the time range this {@link android.app.usage.UsageStats} represents,
		* measured in milliseconds since the epoch.
		* <p/>
		* See {@link System#currentTimeMillis()}.
		*/
		public long getFirstTimeStamp() {
		return mBeginTimeStamp;
		}

		/**
		* Get the end of the time range this {@link android.app.usage.UsageStats} represents.
		* Get the end of the time range this {@link android.app.usage.UsageStats} represents,
		* measured in milliseconds since the epoch.
		* <p/>
		* See {@link System#currentTimeMillis()}.
		*/
		public long getLastTimeStamp() {
		return mEndTimeStamp;
		}

		/**
		* Get the last time this package was used.
		* Get the last time this package was used, measured in milliseconds since the epoch.
		* <p/>
		* See {@link System#currentTimeMillis()}.
		*/
		public long getLastTimeUsed() {
		return mLastTimeUsed;
		}

		/**
		* Get the total time this package spent in the foreground.
		* Get the total time this package spent in the foreground, measured in milliseconds.
		*/
		public long getTotalTimeInForeground() {
		return mTotalTimeInForeground;

+4 −6

Original line number	Diff line number	Diff line
		@@ -23,6 +23,7 @@ import android.util.ArrayMap;

		import java.util.Collections;
		import java.util.List;
		import java.util.Map;

		/**
		* Provides access to device usage history and statistics. Usage data is aggregated into
		@@ -149,7 +150,6 @@ public final class UsageStatsManager {
		* @param endTime The exclusive end of the range of events to include in the results.
		* @return A {@link UsageEvents}.
		*/
		@SuppressWarnings("unchecked")
		public UsageEvents queryEvents(long beginTime, long endTime) {
		try {
		UsageEvents iter = mService.queryEvents(beginTime, endTime,
		@@ -170,15 +170,13 @@ public final class UsageStatsManager {
		*
		* @param beginTime The inclusive beginning of the range of stats to include in the results.
		* @param endTime The exclusive end of the range of stats to include in the results.
		* @return An {@link android.util.ArrayMap} keyed by package name or null if no stats are
		* @return A {@link java.util.Map} keyed by package name, or null if no stats are
		* available.
		*/
		public ArrayMap<String, UsageStats> queryAndAggregateUsageStats(long beginTime, long endTime) {
		public Map<String, UsageStats> queryAndAggregateUsageStats(long beginTime, long endTime) {
		List<UsageStats> stats = queryUsageStats(INTERVAL_BEST, beginTime, endTime);
		if (stats.isEmpty()) {
		@SuppressWarnings("unchecked")
		ArrayMap<String, UsageStats> emptyStats = ArrayMap.EMPTY;
		return emptyStats;
		return Collections.emptyMap();
		}

		ArrayMap<String, UsageStats> aggregatedStats = new ArrayMap<>();

+2 −2

Original line number	Diff line number	Diff line
		@@ -23,7 +23,6 @@ import android.app.usage.UsageStatsManager;
		import android.os.AsyncTask;
		import android.provider.Settings;
		import android.text.TextUtils;
		import android.util.ArrayMap;
		import android.util.Slog;
		import android.widget.AbsListView;
		import android.widget.GridView;
		@@ -73,6 +72,7 @@ import java.util.Comparator;
		import java.util.HashSet;
		import java.util.Iterator;
		import java.util.List;
		import java.util.Map;
		import java.util.Set;

		/**
		@@ -100,7 +100,7 @@ public class ResolverActivity extends Activity implements AdapterView.OnItemClic
		private boolean mResolvingHome = false;

		private UsageStatsManager mUsm;
		private ArrayMap<String, UsageStats> mStats;
		private Map<String, UsageStats> mStats;
		private static final long USAGE_STATS_PERIOD = 1000 * 60 * 60 * 24 * 14;

		private boolean mRegistered;