diff --git a/api/system-current.txt b/api/system-current.txt index 20f0ba86c00fb..3b4a0be6cd136 100644 --- a/api/system-current.txt +++ b/api/system-current.txt @@ -384,16 +384,16 @@ package android.app { public final class StatsManager { method public void addConfig(long, byte[]) throws android.app.StatsManager.StatsUnavailableException; - method public boolean addConfiguration(long, byte[]); - method public byte[] getData(long); - method public byte[] getMetadata(); + method public deprecated boolean addConfiguration(long, byte[]); + method public deprecated byte[] getData(long); + method public deprecated byte[] getMetadata(); method public byte[] getReports(long) throws android.app.StatsManager.StatsUnavailableException; method public byte[] getStatsMetadata() throws android.app.StatsManager.StatsUnavailableException; method public void removeConfig(long) throws android.app.StatsManager.StatsUnavailableException; - method public boolean removeConfiguration(long); + method public deprecated boolean removeConfiguration(long); method public void setBroadcastSubscriber(android.app.PendingIntent, long, long) throws android.app.StatsManager.StatsUnavailableException; - method public boolean setBroadcastSubscriber(long, long, android.app.PendingIntent); - method public boolean setDataFetchOperation(long, android.app.PendingIntent); + method public deprecated boolean setBroadcastSubscriber(long, long, android.app.PendingIntent); + method public deprecated boolean setDataFetchOperation(long, android.app.PendingIntent); method public void setFetchReportsOperation(android.app.PendingIntent, long) throws android.app.StatsManager.StatsUnavailableException; field public static final java.lang.String ACTION_STATSD_STARTED = "android.app.action.STATSD_STARTED"; field public static final java.lang.String EXTRA_STATS_BROADCAST_SUBSCRIBER_COOKIES = "android.app.extra.STATS_BROADCAST_SUBSCRIBER_COOKIES"; diff --git a/core/java/android/app/StatsManager.java b/core/java/android/app/StatsManager.java index 45754aee39c32..32fc0dcebbc84 100644 --- a/core/java/android/app/StatsManager.java +++ b/core/java/android/app/StatsManager.java @@ -115,8 +115,9 @@ public final class StatsManager { } } + // TODO: Temporary for backwards compatibility. Remove. /** - * TODO: Temporary for backwards compatibility. Remove. + * @deprecated Use {@link #addConfig(long, byte[])} */ @RequiresPermission(allOf = { DUMP, PACKAGE_USAGE_STATS }) public boolean addConfiguration(long configKey, byte[] config) { @@ -149,8 +150,9 @@ public final class StatsManager { } } + // TODO: Temporary for backwards compatibility. Remove. /** - * TODO: Temporary for backwards compatibility. Remove. + * @deprecated Use {@link #removeConfig(long)} */ @RequiresPermission(allOf = { DUMP, PACKAGE_USAGE_STATS }) public boolean removeConfiguration(long configKey) { @@ -216,8 +218,9 @@ public final class StatsManager { } } + // TODO: Temporary for backwards compatibility. Remove. /** - * TODO: Temporary for backwards compatibility. Remove. + * @deprecated Use {@link #setBroadcastSubscriber(PendingIntent, long, long)} */ @RequiresPermission(allOf = { DUMP, PACKAGE_USAGE_STATS }) public boolean setBroadcastSubscriber( @@ -268,8 +271,9 @@ public final class StatsManager { } } + // TODO: Temporary for backwards compatibility. Remove. /** - * TODO: Temporary for backwards compatibility. Remove. + * @deprecated Use {@link #setFetchReportsOperation(PendingIntent, long)} */ @RequiresPermission(allOf = { DUMP, PACKAGE_USAGE_STATS }) public boolean setDataFetchOperation(long configKey, PendingIntent pendingIntent) { @@ -304,8 +308,9 @@ public final class StatsManager { } } + // TODO: Temporary for backwards compatibility. Remove. /** - * TODO: Temporary for backwards compatibility. Remove. + * @deprecated Use {@link #getReports(long)} */ @RequiresPermission(allOf = { DUMP, PACKAGE_USAGE_STATS }) public @Nullable byte[] getData(long configKey) { @@ -339,12 +344,9 @@ public final class StatsManager { } } + // TODO: Temporary for backwards compatibility. Remove. /** - * Clients can request metadata for statsd. Will contain stats across all configurations but not - * the actual metrics themselves (metrics must be collected via {@link #getReports(long)}. - * This getter is not destructive and will not reset any metrics/counters. - * - * @return Serialized StatsdStatsReport proto. Returns null on failure (eg, if statsd crashed). + * @deprecated Use {@link #getStatsMetadata()} */ @RequiresPermission(allOf = { DUMP, PACKAGE_USAGE_STATS }) public @Nullable byte[] getMetadata() {