diff options
| -rw-r--r-- | core/java/android/app/ActivityManagerNative.java | 29 | ||||
| -rw-r--r-- | core/java/android/app/IActivityManager.java | 3 | ||||
| -rw-r--r-- | core/java/android/app/Notification.java | 16 | ||||
| -rw-r--r-- | core/java/android/app/PendingIntent.java | 14 | ||||
| -rw-r--r-- | core/java/android/os/BatteryStats.java | 96 | ||||
| -rw-r--r-- | core/java/com/android/internal/util/LocalLog.java | 66 | ||||
| -rw-r--r-- | core/java/com/android/internal/widget/LockPatternUtils.java | 10 | ||||
| -rw-r--r-- | core/res/res/values/config.xml | 8 | ||||
| -rw-r--r-- | docs/downloads/training/NotifyUser.zip | bin | 0 -> 130795 bytes | |||
| -rw-r--r-- | docs/html/about/versions/jelly-bean.jd | 2 | ||||
| -rw-r--r-- | docs/html/distribute/googleplay/about/visibility.jd | 3 | ||||
| -rw-r--r-- | docs/html/google/gcm/adv.jd (renamed from docs/html/guide/google/gcm/adv.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/c2dm.jd (renamed from docs/html/guide/google/gcm/c2dm.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/allclasses-frame.html (renamed from docs/html/guide/google/gcm/client-javadoc/allclasses-frame.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/allclasses-noframe.html (renamed from docs/html/guide/google/gcm/client-javadoc/allclasses-noframe.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/com/google/android/gcm/GCMBaseIntentService.html (renamed from docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/GCMBaseIntentService.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/com/google/android/gcm/GCMBroadcastReceiver.html (renamed from docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/GCMBroadcastReceiver.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/com/google/android/gcm/GCMConstants.html (renamed from docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/GCMConstants.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/com/google/android/gcm/GCMRegistrar.html (renamed from docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/GCMRegistrar.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/com/google/android/gcm/package-frame.html (renamed from docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/package-frame.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/com/google/android/gcm/package-summary.html (renamed from docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/package-summary.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/com/google/android/gcm/package-tree.html (renamed from docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/package-tree.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/constant-values.html (renamed from docs/html/guide/google/gcm/client-javadoc/constant-values.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/default.css (renamed from docs/html/guide/google/gcm/client-javadoc/default.css) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/deprecated-list.html (renamed from docs/html/guide/google/gcm/client-javadoc/deprecated-list.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/help-doc.html (renamed from docs/html/guide/google/gcm/client-javadoc/help-doc.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/index-all.html (renamed from docs/html/guide/google/gcm/client-javadoc/index-all.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/index.html (renamed from docs/html/guide/google/gcm/client-javadoc/index.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/overview-tree.html (renamed from docs/html/guide/google/gcm/client-javadoc/overview-tree.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/package-list (renamed from docs/html/guide/google/gcm/client-javadoc/package-list) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/resources/inherit.gif (renamed from docs/html/guide/google/gcm/client-javadoc/resources/inherit.gif) | bin | 57 -> 57 bytes | |||
| -rw-r--r-- | docs/html/google/gcm/client-javadoc/stylesheet.css (renamed from docs/html/guide/google/gcm/client-javadoc/stylesheet.css) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/demo.jd (renamed from docs/html/guide/google/gcm/demo.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/gcm.jd (renamed from docs/html/guide/google/gcm/gcm.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/gs.jd (renamed from docs/html/guide/google/gcm/gs.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/index.jd (renamed from docs/html/guide/google/gcm/index.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/allclasses-frame.html (renamed from docs/html/guide/google/gcm/server-javadoc/allclasses-frame.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/allclasses-noframe.html (renamed from docs/html/guide/google/gcm/server-javadoc/allclasses-noframe.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Constants.html (renamed from docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Constants.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/InvalidRequestException.html (renamed from docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/InvalidRequestException.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Message.Builder.html (renamed from docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Message.Builder.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Message.html (renamed from docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Message.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/MulticastResult.html (renamed from docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/MulticastResult.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Result.html (renamed from docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Result.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Sender.html (renamed from docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Sender.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/package-frame.html (renamed from docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/package-frame.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/package-summary.html (renamed from docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/package-summary.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/package-tree.html (renamed from docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/package-tree.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/constant-values.html (renamed from docs/html/guide/google/gcm/server-javadoc/constant-values.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/default.css (renamed from docs/html/guide/google/gcm/server-javadoc/default.css) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/deprecated-list.html (renamed from docs/html/guide/google/gcm/server-javadoc/deprecated-list.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/help-doc.html (renamed from docs/html/guide/google/gcm/server-javadoc/help-doc.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/index-all.html (renamed from docs/html/guide/google/gcm/server-javadoc/index-all.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/index.html (renamed from docs/html/guide/google/gcm/server-javadoc/index.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/overview-tree.html (renamed from docs/html/guide/google/gcm/server-javadoc/overview-tree.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/package-list (renamed from docs/html/guide/google/gcm/server-javadoc/package-list) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/resources/inherit.gif (renamed from docs/html/guide/google/gcm/server-javadoc/resources/inherit.gif) | bin | 57 -> 57 bytes | |||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/serialized-form.html (renamed from docs/html/guide/google/gcm/server-javadoc/serialized-form.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/gcm/server-javadoc/stylesheet.css (renamed from docs/html/guide/google/gcm/server-javadoc/stylesheet.css) | 0 | ||||
| -rw-r--r-- | docs/html/google/google_toc.cs | 149 | ||||
| -rw-r--r-- | docs/html/google/index.jd | 86 | ||||
| -rw-r--r-- | docs/html/google/play-services/analytics.jd | 56 | ||||
| -rw-r--r-- | docs/html/google/play-services/auth.jd | 196 | ||||
| -rw-r--r-- | docs/html/google/play-services/dist.jd | 56 | ||||
| -rw-r--r-- | docs/html/google/play-services/download.jd | 140 | ||||
| -rw-r--r-- | docs/html/google/play-services/index.jd | 76 | ||||
| -rw-r--r-- | docs/html/google/play-services/maps.jd | 73 | ||||
| -rw-r--r-- | docs/html/google/play-services/overview.jd | 49 | ||||
| -rw-r--r-- | docs/html/google/play-services/plus.jd | 65 | ||||
| -rw-r--r-- | docs/html/google/play-services/reference/packages.jd | 6 | ||||
| -rw-r--r-- | docs/html/google/play/billing/billing_about.html (renamed from docs/html/guide/google/play/billing/billing_about.html) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/billing/billing_admin.jd (renamed from docs/html/guide/google/play/billing/billing_admin.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/billing/billing_best_practices.jd (renamed from docs/html/guide/google/play/billing/billing_best_practices.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/billing/billing_integrate.jd (renamed from docs/html/guide/google/play/billing/billing_integrate.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/billing/billing_overview.jd (renamed from docs/html/guide/google/play/billing/billing_overview.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/billing/billing_reference.jd (renamed from docs/html/guide/google/play/billing/billing_reference.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/billing/billing_subscriptions.jd (renamed from docs/html/guide/google/play/billing/billing_subscriptions.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/billing/billing_testing.jd (renamed from docs/html/guide/google/play/billing/billing_testing.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/billing/index.jd (renamed from docs/html/guide/google/play/billing/index.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/dist.jd | 52 | ||||
| -rw-r--r-- | docs/html/google/play/expansion-files.jd (renamed from docs/html/guide/google/play/expansion-files.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/filters.jd (renamed from docs/html/guide/google/play/filters.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/licensing/adding-licensing.jd (renamed from docs/html/guide/google/play/licensing/adding-licensing.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/licensing/index.jd (renamed from docs/html/guide/google/play/licensing/index.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/licensing/licensing-reference.jd (renamed from docs/html/guide/google/play/licensing/licensing-reference.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/licensing/overview.jd (renamed from docs/html/guide/google/play/licensing/overview.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/licensing/setting-up.jd (renamed from docs/html/guide/google/play/licensing/setting-up.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/publishing/multiple-apks.jd (renamed from docs/html/guide/google/play/publishing/multiple-apks.jd) | 0 | ||||
| -rw-r--r-- | docs/html/google/play/services.jd (renamed from docs/html/guide/google/play/services.jd) | 0 | ||||
| -rw-r--r-- | docs/html/guide/google/index.jd | 134 | ||||
| -rw-r--r-- | docs/html/guide/guide_toc.cs | 96 | ||||
| -rw-r--r-- | docs/html/images/gps-analytics.png | bin | 0 -> 7276 bytes | |||
| -rw-r--r-- | docs/html/images/gps-maps.png | bin | 0 -> 96526 bytes | |||
| -rw-r--r-- | docs/html/images/gps-plus.png | bin | 0 -> 28391 bytes | |||
| -rw-r--r-- | docs/html/images/gps-small.png | bin | 0 -> 13986 bytes | |||
| -rw-r--r-- | docs/html/images/gps.png | bin | 0 -> 138100 bytes | |||
| -rw-r--r-- | docs/html/images/play-services-diagram.graffle/data.plist | 1020 | ||||
| -rw-r--r-- | docs/html/images/play-services-diagram.graffle/image3.png | bin | 0 -> 59774 bytes | |||
| -rw-r--r-- | docs/html/images/play-services-diagram.graffle/image4.png | bin | 0 -> 4535 bytes | |||
| -rw-r--r-- | docs/html/images/play-services-diagram.graffle/image5.pdf | bin | 0 -> 43222 bytes | |||
| -rw-r--r-- | docs/html/images/play-services-diagram.graffle/image8.tiff | bin | 0 -> 22904 bytes | |||
| -rw-r--r-- | docs/html/images/play-services-diagram.png | bin | 0 -> 35166 bytes | |||
| -rw-r--r-- | docs/html/images/training/notifications-bigview.png | bin | 0 -> 20177 bytes | |||
| -rw-r--r-- | docs/html/images/training/notifications-normalview.png | bin | 0 -> 5879 bytes | |||
| -rw-r--r-- | docs/html/training/notify-user/build-notification.jd | 160 | ||||
| -rw-r--r-- | docs/html/training/notify-user/display-progress.jd | 182 | ||||
| -rw-r--r-- | docs/html/training/notify-user/expanded.jd | 167 | ||||
| -rw-r--r-- | docs/html/training/notify-user/index.jd | 102 | ||||
| -rw-r--r-- | docs/html/training/notify-user/managing.jd | 107 | ||||
| -rw-r--r-- | docs/html/training/notify-user/navigation.jd | 228 | ||||
| -rw-r--r-- | docs/html/training/training_toc.cs | 84 | ||||
| -rw-r--r-- | graphics/jni/android_renderscript_RenderScript.cpp | 10 | ||||
| -rw-r--r-- | packages/SystemUI/src/com/android/systemui/recent/RecentTasksLoader.java | 4 | ||||
| -rw-r--r-- | packages/SystemUI/src/com/android/systemui/recent/RecentsHorizontalScrollView.java | 13 | ||||
| -rw-r--r-- | packages/SystemUI/src/com/android/systemui/recent/RecentsPanelView.java | 41 | ||||
| -rw-r--r-- | packages/SystemUI/src/com/android/systemui/recent/RecentsVerticalScrollView.java | 13 | ||||
| -rw-r--r-- | packages/SystemUI/src/com/android/systemui/statusbar/phone/QuickSettings.java | 3 | ||||
| -rw-r--r-- | packages/SystemUI/src/com/android/systemui/statusbar/policy/Clock.java | 4 | ||||
| -rw-r--r-- | policy/src/com/android/internal/policy/impl/keyguard/KeyguardViewManager.java | 6 | ||||
| -rw-r--r-- | policy/src/com/android/internal/policy/impl/keyguard/KeyguardViewMediator.java | 5 | ||||
| -rw-r--r-- | services/java/com/android/server/AlarmManagerService.java | 232 | ||||
| -rw-r--r-- | services/java/com/android/server/AppWidgetServiceImpl.java | 24 | ||||
| -rw-r--r-- | services/java/com/android/server/DevicePolicyManagerService.java | 38 | ||||
| -rw-r--r-- | services/java/com/android/server/InputMethodManagerService.java | 14 | ||||
| -rw-r--r-- | services/java/com/android/server/am/ActivityManagerService.java | 14 | ||||
| -rw-r--r-- | services/java/com/android/server/net/NetworkStatsService.java | 10 | ||||
| -rw-r--r-- | services/java/com/android/server/wm/WindowManagerService.java | 13 | ||||
| -rw-r--r-- | services/java/com/android/server/wm/WindowState.java | 21 | ||||
| -rw-r--r-- | services/java/com/android/server/wm/WindowStateAnimator.java | 2 | ||||
| -rw-r--r-- | tests/StatusBar/res/layout/notification_builder_test.xml | 1047 | ||||
| -rw-r--r-- | tests/StatusBar/res/values/styles.xml | 17 | ||||
| -rw-r--r-- | tests/StatusBar/src/com/android/statusbartest/NotificationBuilderTest.java | 85 | ||||
| -rw-r--r-- | tools/aapt/Android.mk | 1 | ||||
| -rw-r--r-- | tools/aapt/ResourceIdCache.cpp | 107 | ||||
| -rw-r--r-- | tools/aapt/ResourceIdCache.h | 30 | ||||
| -rw-r--r-- | tools/aapt/ResourceTable.cpp | 15 |
136 files changed, 4378 insertions, 922 deletions
diff --git a/core/java/android/app/ActivityManagerNative.java b/core/java/android/app/ActivityManagerNative.java index 67d3930..61b2067 100644 --- a/core/java/android/app/ActivityManagerNative.java +++ b/core/java/android/app/ActivityManagerNative.java @@ -1701,6 +1701,21 @@ public abstract class ActivityManagerNative extends Binder implements IActivityM return true; } + case GET_INTENT_FOR_INTENT_SENDER_TRANSACTION: { + data.enforceInterface(IActivityManager.descriptor); + IIntentSender r = IIntentSender.Stub.asInterface( + data.readStrongBinder()); + Intent intent = getIntentForIntentSender(r); + reply.writeNoException(); + if (intent != null) { + reply.writeInt(1); + intent.writeToParcel(reply, Parcelable.PARCELABLE_WRITE_RETURN_VALUE); + } else { + reply.writeInt(0); + } + return true; + } + case UPDATE_PERSISTENT_CONFIGURATION_TRANSACTION: { data.enforceInterface(IActivityManager.descriptor); Configuration config = Configuration.CREATOR.createFromParcel(data); @@ -3977,6 +3992,20 @@ class ActivityManagerProxy implements IActivityManager return res; } + public Intent getIntentForIntentSender(IIntentSender sender) throws RemoteException { + Parcel data = Parcel.obtain(); + Parcel reply = Parcel.obtain(); + data.writeInterfaceToken(IActivityManager.descriptor); + data.writeStrongBinder(sender.asBinder()); + mRemote.transact(GET_INTENT_FOR_INTENT_SENDER_TRANSACTION, data, reply, 0); + reply.readException(); + Intent res = reply.readInt() != 0 + ? Intent.CREATOR.createFromParcel(reply) : null; + data.recycle(); + reply.recycle(); + return res; + } + public void updatePersistentConfiguration(Configuration values) throws RemoteException { Parcel data = Parcel.obtain(); diff --git a/core/java/android/app/IActivityManager.java b/core/java/android/app/IActivityManager.java index 8fc1c86..8af17a4 100644 --- a/core/java/android/app/IActivityManager.java +++ b/core/java/android/app/IActivityManager.java @@ -341,6 +341,8 @@ public interface IActivityManager extends IInterface { public boolean isIntentSenderAnActivity(IIntentSender sender) throws RemoteException; + public Intent getIntentForIntentSender(IIntentSender sender) throws RemoteException; + public void updatePersistentConfiguration(Configuration values) throws RemoteException; public long[] getProcessPss(int[] pids) throws RemoteException; @@ -621,4 +623,5 @@ public interface IActivityManager extends IInterface { int REQUEST_BUG_REPORT_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+157; int INPUT_DISPATCHING_TIMED_OUT_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+158; int CLEAR_PENDING_BACKUP_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+159; + int GET_INTENT_FOR_INTENT_SENDER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+160; } diff --git a/core/java/android/app/Notification.java b/core/java/android/app/Notification.java index 2c92d09..8f8df0a 100644 --- a/core/java/android/app/Notification.java +++ b/core/java/android/app/Notification.java @@ -388,8 +388,8 @@ public class Notification implements Parcelable * Priority is an indication of how much of the user's valuable attention should be consumed by * this notification. Low-priority notifications may be hidden from the user in certain * situations, while the user might be interrupted for a higher-priority notification. The - * system will make a determination about how to interpret notification priority as described in - * MUMBLE MUMBLE. + * system will make a determination about how to interpret this priority when presenting + * the notification. */ public int priority; @@ -846,7 +846,9 @@ public class Notification implements Parcelable } // TODO(dsandler): defaults take precedence over local values, so reorder the branches below sb.append(" vibrate="); - if (this.vibrate != null) { + if ((this.defaults & DEFAULT_VIBRATE) != 0) { + sb.append("default"); + } else if (this.vibrate != null) { int N = this.vibrate.length-1; sb.append("["); for (int i=0; i<N; i++) { @@ -857,16 +859,14 @@ public class Notification implements Parcelable sb.append(this.vibrate[N]); } sb.append("]"); - } else if ((this.defaults & DEFAULT_VIBRATE) != 0) { - sb.append("default"); } else { sb.append("null"); } sb.append(" sound="); - if (this.sound != null) { - sb.append(this.sound.toString()); - } else if ((this.defaults & DEFAULT_SOUND) != 0) { + if ((this.defaults & DEFAULT_SOUND) != 0) { sb.append("default"); + } else if (this.sound != null) { + sb.append(this.sound.toString()); } else { sb.append("null"); } diff --git a/core/java/android/app/PendingIntent.java b/core/java/android/app/PendingIntent.java index d36d99d..5c75aff 100644 --- a/core/java/android/app/PendingIntent.java +++ b/core/java/android/app/PendingIntent.java @@ -790,6 +790,20 @@ public final class PendingIntent implements Parcelable { } /** + * @hide + * Return the Intent of this PendingIntent. + */ + public Intent getIntent() { + try { + return ActivityManagerNative.getDefault() + .getIntentForIntentSender(mTarget); + } catch (RemoteException e) { + // Should never happen. + return null; + } + } + + /** * Comparison operator on two PendingIntent objects, such that true * is returned then they both represent the same operation from the * same package. This allows you to use {@link #getActivity}, diff --git a/core/java/android/os/BatteryStats.java b/core/java/android/os/BatteryStats.java index 54f2fe3..9821824 100644 --- a/core/java/android/os/BatteryStats.java +++ b/core/java/android/os/BatteryStats.java @@ -18,6 +18,8 @@ package android.os; import java.io.PrintWriter; import java.util.ArrayList; +import java.util.Collections; +import java.util.Comparator; import java.util.Formatter; import java.util.List; import java.util.Map; @@ -1127,8 +1129,10 @@ public abstract class BatteryStats implements Parcelable { if (totalTimeMillis != 0) { sb.append(linePrefix); formatTimeMs(sb, totalTimeMillis); - if (name != null) sb.append(name); - sb.append(' '); + if (name != null) { + sb.append(name); + sb.append(' '); + } sb.append('('); sb.append(count); sb.append(" times)"); @@ -1440,8 +1444,21 @@ public abstract class BatteryStats implements Parcelable { } } + static final class TimerEntry { + final String mName; + final int mId; + final BatteryStats.Timer mTimer; + final long mTime; + TimerEntry(String name, int id, BatteryStats.Timer timer, long time) { + mName = name; + mId = id; + mTimer = timer; + mTime = time; + } + } + @SuppressWarnings("unused") - public final void dumpLocked(PrintWriter pw, String prefix, int which, int reqUid) { + public final void dumpLocked(PrintWriter pw, String prefix, final int which, int reqUid) { final long rawUptime = SystemClock.uptimeMillis() * 1000; final long rawRealtime = SystemClock.elapsedRealtime() * 1000; final long batteryUptime = getBatteryUptime(rawUptime); @@ -1516,19 +1533,43 @@ public abstract class BatteryStats implements Parcelable { long txTotal = 0; long fullWakeLockTimeTotalMicros = 0; long partialWakeLockTimeTotalMicros = 0; - + + final Comparator<TimerEntry> timerComparator = new Comparator<TimerEntry>() { + @Override + public int compare(TimerEntry lhs, TimerEntry rhs) { + long lhsTime = lhs.mTime; + long rhsTime = rhs.mTime; + if (lhsTime < rhsTime) { + return 1; + } + if (lhsTime > rhsTime) { + return -1; + } + return 0; + } + }; + if (reqUid < 0) { Map<String, ? extends BatteryStats.Timer> kernelWakelocks = getKernelWakelockStats(); if (kernelWakelocks.size() > 0) { + final ArrayList<TimerEntry> timers = new ArrayList<TimerEntry>(); for (Map.Entry<String, ? extends BatteryStats.Timer> ent : kernelWakelocks.entrySet()) { - + BatteryStats.Timer timer = ent.getValue(); + long totalTimeMillis = computeWakeLock(timer, batteryRealtime, which); + if (totalTimeMillis > 0) { + timers.add(new TimerEntry(ent.getKey(), 0, timer, totalTimeMillis)); + } + } + Collections.sort(timers, timerComparator); + for (int i=0; i<timers.size(); i++) { + TimerEntry timer = timers.get(i); String linePrefix = ": "; sb.setLength(0); sb.append(prefix); sb.append(" Kernel Wake lock "); - sb.append(ent.getKey()); - linePrefix = printWakeLock(sb, ent.getValue(), batteryRealtime, null, which, - linePrefix); + sb.append(timer.mName); + linePrefix = printWakeLock(sb, timer.mTimer, batteryRealtime, null, + which, linePrefix); if (!linePrefix.equals(": ")) { sb.append(" realtime"); // Only print out wake locks that were held @@ -1537,7 +1578,9 @@ public abstract class BatteryStats implements Parcelable { } } } - + + final ArrayList<TimerEntry> timers = new ArrayList<TimerEntry>(); + for (int iu = 0; iu < NU; iu++) { Uid u = uidStats.valueAt(iu); rxTotal += u.getTcpBytesReceived(which); @@ -1557,8 +1600,18 @@ public abstract class BatteryStats implements Parcelable { Timer partialWakeTimer = wl.getWakeTime(WAKE_TYPE_PARTIAL); if (partialWakeTimer != null) { - partialWakeLockTimeTotalMicros += partialWakeTimer.getTotalTimeLocked( + long totalTimeMicros = partialWakeTimer.getTotalTimeLocked( batteryRealtime, which); + if (totalTimeMicros > 0) { + if (reqUid < 0) { + // Only show the ordered list of all wake + // locks if the caller is not asking for data + // about a specific uid. + timers.add(new TimerEntry(ent.getKey(), u.getUid(), + partialWakeTimer, totalTimeMicros)); + } + partialWakeLockTimeTotalMicros += totalTimeMicros; + } } } } @@ -1571,7 +1624,7 @@ public abstract class BatteryStats implements Parcelable { sb.append(prefix); sb.append(" Total full wakelock time: "); formatTimeMs(sb, (fullWakeLockTimeTotalMicros + 500) / 1000); - sb.append(", Total partial waklock time: "); formatTimeMs(sb, + sb.append(", Total partial wakelock time: "); formatTimeMs(sb, (partialWakeLockTimeTotalMicros + 500) / 1000); pw.println(sb.toString()); @@ -1676,9 +1729,26 @@ public abstract class BatteryStats implements Parcelable { pw.println(getDischargeAmountScreenOnSinceCharge()); pw.print(prefix); pw.print(" Amount discharged while screen off: "); pw.println(getDischargeAmountScreenOffSinceCharge()); - pw.println(" "); + pw.println(); + } + + if (timers.size() > 0) { + Collections.sort(timers, timerComparator); + pw.print(prefix); pw.println(" All partial wake locks:"); + for (int i=0; i<timers.size(); i++) { + TimerEntry timer = timers.get(i); + sb.setLength(0); + sb.append(" Wake lock #"); + sb.append(timer.mId); + sb.append(" "); + sb.append(timer.mName); + printWakeLock(sb, timer.mTimer, batteryRealtime, null, which, ": "); + sb.append(" realtime"); + pw.println(sb.toString()); + } + timers.clear(); + pw.println(); } - for (int iu=0; iu<NU; iu++) { final int uid = uidStats.keyAt(iu); diff --git a/core/java/com/android/internal/util/LocalLog.java b/core/java/com/android/internal/util/LocalLog.java new file mode 100644 index 0000000..f0e6171 --- /dev/null +++ b/core/java/com/android/internal/util/LocalLog.java @@ -0,0 +1,66 @@ +/* + * Copyright (C) 2012 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.internal.util; + +import java.io.PrintWriter; +import java.util.ArrayList; + +import android.util.Slog; + +/** + * Helper class for logging serious issues, which also keeps a small + * snapshot of the logged events that can be printed later, such as part + * of a system service's dumpsys output. + * @hide + */ +public class LocalLog { + private final String mTag; + private final int mMaxLines = 20; + private final ArrayList<String> mLines = new ArrayList<String>(mMaxLines); + + public LocalLog(String tag) { + mTag = tag; + } + + public void w(String msg) { + synchronized (mLines) { + Slog.w(mTag, msg); + if (mLines.size() >= mMaxLines) { + mLines.remove(0); + } + mLines.add(msg); + } + } + + public boolean dump(PrintWriter pw, String header, String prefix) { + synchronized (mLines) { + if (mLines.size() <= 0) { + return false; + } + if (header != null) { + pw.println(header); + } + for (int i=0; i<mLines.size(); i++) { + if (prefix != null) { + pw.print(prefix); + } + pw.println(mLines.get(i)); + } + return true; + } + } +} diff --git a/core/java/com/android/internal/widget/LockPatternUtils.java b/core/java/com/android/internal/widget/LockPatternUtils.java index 75fef24..5fa0b78 100644 --- a/core/java/com/android/internal/widget/LockPatternUtils.java +++ b/core/java/com/android/internal/widget/LockPatternUtils.java @@ -116,16 +116,6 @@ public class LockPatternUtils { public static final String KEYGUARD_SHOW_APPWIDGET = "showappwidget"; /** - * Options used to lock the device upon user switch. - */ - public static final Bundle USER_SWITCH_LOCK_OPTIONS = new Bundle(); - - static { - USER_SWITCH_LOCK_OPTIONS.putBoolean(KEYGUARD_SHOW_USER_SWITCHER, true); - USER_SWITCH_LOCK_OPTIONS.putBoolean(KEYGUARD_SHOW_SECURITY_CHALLENGE, true); - } - - /** * The bit in LOCK_BIOMETRIC_WEAK_FLAGS to be used to indicate whether liveliness should * be used */ diff --git a/core/res/res/values/config.xml b/core/res/res/values/config.xml index 3523db6..460a811 100644 --- a/core/res/res/values/config.xml +++ b/core/res/res/values/config.xml @@ -1016,9 +1016,9 @@ --> <integer-array name="config_defaultNotificationVibePattern"> <item>0</item> - <item>150</item> - <item>200</item> + <item>350</item> <item>250</item> + <item>350</item> </integer-array> <!-- Vibrator pattern to be used as the default for notifications @@ -1027,8 +1027,8 @@ --> <integer-array name="config_notificationFallbackVibePattern"> <item>0</item> - <item>33</item> + <item>100</item> <item>150</item> - <item>50</item> + <item>100</item> </integer-array> </resources> diff --git a/docs/downloads/training/NotifyUser.zip b/docs/downloads/training/NotifyUser.zip Binary files differnew file mode 100644 index 0000000..c335157 --- /dev/null +++ b/docs/downloads/training/NotifyUser.zip diff --git a/docs/html/about/versions/jelly-bean.jd b/docs/html/about/versions/jelly-bean.jd index 87ebbe0..5350941 100644 --- a/docs/html/about/versions/jelly-bean.jd +++ b/docs/html/about/versions/jelly-bean.jd @@ -464,7 +464,7 @@ in CPU only on a Galaxy Nexus device.</p> <p style="image-caption">Renderscript image-processing benchmarks comparing operations run with GPU + CPU to those run in CPU only on the same Nexus 10 device.</p> </div> -<p>If you have a direct acyclic graph of Renderscript operations to run, you can +<p>If you have a directed acyclic graph of Renderscript operations to run, you can use a builder class to create a script group defining the operations. At execution time, Renderscript optimizes the run order and the connections between these operations for best performance.</p> diff --git a/docs/html/distribute/googleplay/about/visibility.jd b/docs/html/distribute/googleplay/about/visibility.jd index 38fb395..2ff1293 100644 --- a/docs/html/distribute/googleplay/about/visibility.jd +++ b/docs/html/distribute/googleplay/about/visibility.jd @@ -112,7 +112,8 @@ popular apps at the top. </p> users, right from the Apps and Games home pages. The charts are generated several times each day based on recent download activity, keeping them fresh and allowing new apps to move upward in the charts. To make the charts as relevant -as possible for users across the world, they are also country-specific.</p> +as possible for users across the world, they are also country-specific in +Google Play's most popular countries.</p> <p>As your apps get traction and build momentum in downloads and ratings, they’ll climb one or more of the top charts and gain even more exposure.</p> diff --git a/docs/html/guide/google/gcm/adv.jd b/docs/html/google/gcm/adv.jd index 1360624..1360624 100644 --- a/docs/html/guide/google/gcm/adv.jd +++ b/docs/html/google/gcm/adv.jd diff --git a/docs/html/guide/google/gcm/c2dm.jd b/docs/html/google/gcm/c2dm.jd index e80a41f..e80a41f 100644 --- a/docs/html/guide/google/gcm/c2dm.jd +++ b/docs/html/google/gcm/c2dm.jd diff --git a/docs/html/guide/google/gcm/client-javadoc/allclasses-frame.html b/docs/html/google/gcm/client-javadoc/allclasses-frame.html index e1bed36..e1bed36 100644 --- a/docs/html/guide/google/gcm/client-javadoc/allclasses-frame.html +++ b/docs/html/google/gcm/client-javadoc/allclasses-frame.html diff --git a/docs/html/guide/google/gcm/client-javadoc/allclasses-noframe.html b/docs/html/google/gcm/client-javadoc/allclasses-noframe.html index dc34021..dc34021 100644 --- a/docs/html/guide/google/gcm/client-javadoc/allclasses-noframe.html +++ b/docs/html/google/gcm/client-javadoc/allclasses-noframe.html diff --git a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/GCMBaseIntentService.html b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/GCMBaseIntentService.html index ff15218..ff15218 100644 --- a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/GCMBaseIntentService.html +++ b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/GCMBaseIntentService.html diff --git a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/GCMBroadcastReceiver.html b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/GCMBroadcastReceiver.html index ae80bf7..ae80bf7 100644 --- a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/GCMBroadcastReceiver.html +++ b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/GCMBroadcastReceiver.html diff --git a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/GCMConstants.html b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/GCMConstants.html index 205bcf0..205bcf0 100644 --- a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/GCMConstants.html +++ b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/GCMConstants.html diff --git a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/GCMRegistrar.html b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/GCMRegistrar.html index c29bf90..c29bf90 100644 --- a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/GCMRegistrar.html +++ b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/GCMRegistrar.html diff --git a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/package-frame.html b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/package-frame.html index a2a599d..a2a599d 100644 --- a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/package-frame.html +++ b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/package-frame.html diff --git a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/package-summary.html b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/package-summary.html index c8e0341..c8e0341 100644 --- a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/package-summary.html +++ b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/package-summary.html diff --git a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/package-tree.html b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/package-tree.html index 0e27efe..0e27efe 100644 --- a/docs/html/guide/google/gcm/client-javadoc/com/google/android/gcm/package-tree.html +++ b/docs/html/google/gcm/client-javadoc/com/google/android/gcm/package-tree.html diff --git a/docs/html/guide/google/gcm/client-javadoc/constant-values.html b/docs/html/google/gcm/client-javadoc/constant-values.html index 796d196..796d196 100644 --- a/docs/html/guide/google/gcm/client-javadoc/constant-values.html +++ b/docs/html/google/gcm/client-javadoc/constant-values.html diff --git a/docs/html/guide/google/gcm/client-javadoc/default.css b/docs/html/google/gcm/client-javadoc/default.css index f11daf7..f11daf7 100644 --- a/docs/html/guide/google/gcm/client-javadoc/default.css +++ b/docs/html/google/gcm/client-javadoc/default.css diff --git a/docs/html/guide/google/gcm/client-javadoc/deprecated-list.html b/docs/html/google/gcm/client-javadoc/deprecated-list.html index d9a63c5..d9a63c5 100644 --- a/docs/html/guide/google/gcm/client-javadoc/deprecated-list.html +++ b/docs/html/google/gcm/client-javadoc/deprecated-list.html diff --git a/docs/html/guide/google/gcm/client-javadoc/help-doc.html b/docs/html/google/gcm/client-javadoc/help-doc.html index af1bca8..af1bca8 100644 --- a/docs/html/guide/google/gcm/client-javadoc/help-doc.html +++ b/docs/html/google/gcm/client-javadoc/help-doc.html diff --git a/docs/html/guide/google/gcm/client-javadoc/index-all.html b/docs/html/google/gcm/client-javadoc/index-all.html index 408edee..408edee 100644 --- a/docs/html/guide/google/gcm/client-javadoc/index-all.html +++ b/docs/html/google/gcm/client-javadoc/index-all.html diff --git a/docs/html/guide/google/gcm/client-javadoc/index.html b/docs/html/google/gcm/client-javadoc/index.html index fa7af90..fa7af90 100644 --- a/docs/html/guide/google/gcm/client-javadoc/index.html +++ b/docs/html/google/gcm/client-javadoc/index.html diff --git a/docs/html/guide/google/gcm/client-javadoc/overview-tree.html b/docs/html/google/gcm/client-javadoc/overview-tree.html index 392f3e0..392f3e0 100644 --- a/docs/html/guide/google/gcm/client-javadoc/overview-tree.html +++ b/docs/html/google/gcm/client-javadoc/overview-tree.html diff --git a/docs/html/guide/google/gcm/client-javadoc/package-list b/docs/html/google/gcm/client-javadoc/package-list index 149691e..149691e 100644 --- a/docs/html/guide/google/gcm/client-javadoc/package-list +++ b/docs/html/google/gcm/client-javadoc/package-list diff --git a/docs/html/guide/google/gcm/client-javadoc/resources/inherit.gif b/docs/html/google/gcm/client-javadoc/resources/inherit.gif Binary files differindex c814867..c814867 100644 --- a/docs/html/guide/google/gcm/client-javadoc/resources/inherit.gif +++ b/docs/html/google/gcm/client-javadoc/resources/inherit.gif diff --git a/docs/html/guide/google/gcm/client-javadoc/stylesheet.css b/docs/html/google/gcm/client-javadoc/stylesheet.css index 6ea9e51..6ea9e51 100644 --- a/docs/html/guide/google/gcm/client-javadoc/stylesheet.css +++ b/docs/html/google/gcm/client-javadoc/stylesheet.css diff --git a/docs/html/guide/google/gcm/demo.jd b/docs/html/google/gcm/demo.jd index 7e35fd6..7e35fd6 100644 --- a/docs/html/guide/google/gcm/demo.jd +++ b/docs/html/google/gcm/demo.jd diff --git a/docs/html/guide/google/gcm/gcm.jd b/docs/html/google/gcm/gcm.jd index 7fc192b..7fc192b 100644 --- a/docs/html/guide/google/gcm/gcm.jd +++ b/docs/html/google/gcm/gcm.jd diff --git a/docs/html/guide/google/gcm/gs.jd b/docs/html/google/gcm/gs.jd index fc5c4a2..fc5c4a2 100644 --- a/docs/html/guide/google/gcm/gs.jd +++ b/docs/html/google/gcm/gs.jd diff --git a/docs/html/guide/google/gcm/index.jd b/docs/html/google/gcm/index.jd index 8079eba..8079eba 100644 --- a/docs/html/guide/google/gcm/index.jd +++ b/docs/html/google/gcm/index.jd diff --git a/docs/html/guide/google/gcm/server-javadoc/allclasses-frame.html b/docs/html/google/gcm/server-javadoc/allclasses-frame.html index 80ee784..80ee784 100644 --- a/docs/html/guide/google/gcm/server-javadoc/allclasses-frame.html +++ b/docs/html/google/gcm/server-javadoc/allclasses-frame.html diff --git a/docs/html/guide/google/gcm/server-javadoc/allclasses-noframe.html b/docs/html/google/gcm/server-javadoc/allclasses-noframe.html index 966598d..966598d 100644 --- a/docs/html/guide/google/gcm/server-javadoc/allclasses-noframe.html +++ b/docs/html/google/gcm/server-javadoc/allclasses-noframe.html diff --git a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Constants.html b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Constants.html index 515bba4..515bba4 100644 --- a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Constants.html +++ b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Constants.html diff --git a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/InvalidRequestException.html b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/InvalidRequestException.html index bb0974c..bb0974c 100644 --- a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/InvalidRequestException.html +++ b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/InvalidRequestException.html diff --git a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Message.Builder.html b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Message.Builder.html index c2ee648..c2ee648 100644 --- a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Message.Builder.html +++ b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Message.Builder.html diff --git a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Message.html b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Message.html index 5dbd262..5dbd262 100644 --- a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Message.html +++ b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Message.html diff --git a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/MulticastResult.html b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/MulticastResult.html index 0721488..0721488 100644 --- a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/MulticastResult.html +++ b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/MulticastResult.html diff --git a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Result.html b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Result.html index a4aad29..a4aad29 100644 --- a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Result.html +++ b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Result.html diff --git a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Sender.html b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Sender.html index fabda98..fabda98 100644 --- a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/Sender.html +++ b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/Sender.html diff --git a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/package-frame.html b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/package-frame.html index 1bc4fd9..1bc4fd9 100644 --- a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/package-frame.html +++ b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/package-frame.html diff --git a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/package-summary.html b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/package-summary.html index de791c7..de791c7 100644 --- a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/package-summary.html +++ b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/package-summary.html diff --git a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/package-tree.html b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/package-tree.html index d509312..d509312 100644 --- a/docs/html/guide/google/gcm/server-javadoc/com/google/android/gcm/server/package-tree.html +++ b/docs/html/google/gcm/server-javadoc/com/google/android/gcm/server/package-tree.html diff --git a/docs/html/guide/google/gcm/server-javadoc/constant-values.html b/docs/html/google/gcm/server-javadoc/constant-values.html index 68db1cb..68db1cb 100644 --- a/docs/html/guide/google/gcm/server-javadoc/constant-values.html +++ b/docs/html/google/gcm/server-javadoc/constant-values.html diff --git a/docs/html/guide/google/gcm/server-javadoc/default.css b/docs/html/google/gcm/server-javadoc/default.css index 7c395c7..7c395c7 100644 --- a/docs/html/guide/google/gcm/server-javadoc/default.css +++ b/docs/html/google/gcm/server-javadoc/default.css diff --git a/docs/html/guide/google/gcm/server-javadoc/deprecated-list.html b/docs/html/google/gcm/server-javadoc/deprecated-list.html index 04b9aa5..04b9aa5 100644 --- a/docs/html/guide/google/gcm/server-javadoc/deprecated-list.html +++ b/docs/html/google/gcm/server-javadoc/deprecated-list.html diff --git a/docs/html/guide/google/gcm/server-javadoc/help-doc.html b/docs/html/google/gcm/server-javadoc/help-doc.html index c479cff..c479cff 100644 --- a/docs/html/guide/google/gcm/server-javadoc/help-doc.html +++ b/docs/html/google/gcm/server-javadoc/help-doc.html diff --git a/docs/html/guide/google/gcm/server-javadoc/index-all.html b/docs/html/google/gcm/server-javadoc/index-all.html index 97aa300..97aa300 100644 --- a/docs/html/guide/google/gcm/server-javadoc/index-all.html +++ b/docs/html/google/gcm/server-javadoc/index-all.html diff --git a/docs/html/guide/google/gcm/server-javadoc/index.html b/docs/html/google/gcm/server-javadoc/index.html index d3c3821..d3c3821 100644 --- a/docs/html/guide/google/gcm/server-javadoc/index.html +++ b/docs/html/google/gcm/server-javadoc/index.html diff --git a/docs/html/guide/google/gcm/server-javadoc/overview-tree.html b/docs/html/google/gcm/server-javadoc/overview-tree.html index c9afea6..c9afea6 100644 --- a/docs/html/guide/google/gcm/server-javadoc/overview-tree.html +++ b/docs/html/google/gcm/server-javadoc/overview-tree.html diff --git a/docs/html/guide/google/gcm/server-javadoc/package-list b/docs/html/google/gcm/server-javadoc/package-list index 5955cc0..5955cc0 100644 --- a/docs/html/guide/google/gcm/server-javadoc/package-list +++ b/docs/html/google/gcm/server-javadoc/package-list diff --git a/docs/html/guide/google/gcm/server-javadoc/resources/inherit.gif b/docs/html/google/gcm/server-javadoc/resources/inherit.gif Binary files differindex c814867..c814867 100644 --- a/docs/html/guide/google/gcm/server-javadoc/resources/inherit.gif +++ b/docs/html/google/gcm/server-javadoc/resources/inherit.gif diff --git a/docs/html/guide/google/gcm/server-javadoc/serialized-form.html b/docs/html/google/gcm/server-javadoc/serialized-form.html index ab99e41..ab99e41 100644 --- a/docs/html/guide/google/gcm/server-javadoc/serialized-form.html +++ b/docs/html/google/gcm/server-javadoc/serialized-form.html diff --git a/docs/html/guide/google/gcm/server-javadoc/stylesheet.css b/docs/html/google/gcm/server-javadoc/stylesheet.css index 6ea9e51..6ea9e51 100644 --- a/docs/html/guide/google/gcm/server-javadoc/stylesheet.css +++ b/docs/html/google/gcm/server-javadoc/stylesheet.css diff --git a/docs/html/google/google_toc.cs b/docs/html/google/google_toc.cs new file mode 100644 index 0000000..d371fa1 --- /dev/null +++ b/docs/html/google/google_toc.cs @@ -0,0 +1,149 @@ +<?cs # Table of contents for Dev Guide. + + For each document available in translation, add an localized title to this TOC. + Do not add localized title for docs not available in translation. + Below are template spans for adding localized doc titles. Please ensure that + localized titles are added in the language order specified below. +?> + +<ul id="nav"> + <li class="nav-section"> + <div class="nav-section-header empty"><a href="<?cs var:toroot ?>google/index.html"> + <span class="en">Overview</span> + </a></div> + </li> + + <li class="nav-section"> + <div class="nav-section-header"><a href="<?cs var:toroot ?>google/play-services/index.html"> + <span class="en">Google Play services</span></a> + </div> + <ul> + <li><a href="<?cs var:toroot?>google/play-services/overview.html"> + <span class="en">Overview</span></a> + </li> + + <li><a href="<?cs var:toroot?>google/play-services/download.html"> + <span class="en">Downloading and Configuring</span></a> + </li> + <li><a href="<?cs var:toroot?>google/play-services/auth.html"> + <span class="en">Authentication</span></a> + </li> + + <li><a href="<?cs var:toroot?>google/play-services/analytics.html"> + <span class="en">Analytics</span></a> + </li> + + <li><a href="<?cs var:toroot?>google/play-services/plus.html"> + <span class="en">Google+</span></a> + </li> + + <li><a href="<?cs var:toroot?>google/play-services/maps.html"> + <span class="en">Maps</span></a> + </li> + + <li id="tree-list"> + <a href="<?cs var:toroot?>google/play-services/reference/packages.html"> + <span class="en">Reference</span></a> + </li> + </ul> + </li> + + <li class="nav-section"> + <div class="nav-section-header"><a href="<?cs var:toroot ?>google/play/billing/index.html"> + <span class="en">Google Play <br />In-app Billing</span></a> + </div> + <ul> + <li><a href="<?cs var:toroot?>google/play/billing/billing_overview.html"> + <span class="en">In-app Billing Overview</span></a> + </li> + <li><a href="<?cs var:toroot?>google/play/billing/billing_integrate.html"> + <span class="en">Implementing In-app Billing</span></a> + </li> + <li><a href="<?cs var:toroot?>google/play/billing/billing_subscriptions.html"> + <span class="en">Subscriptions</span></a> + </li> + <li><a href="<?cs var:toroot?>google/play/billing/billing_best_practices.html"> + <span class="en">Security and Design</span></a> + </li> + <li><a href="<?cs var:toroot?>google/play/billing/billing_testing.html"> + <span class="en">Testing <br/>In-app Billing</span></a> + </li> + <li><a href="<?cs var:toroot?>google/play/billing/billing_admin.html"> + <span class="en">Administering In-app Billing</span></a> + </li> + <li><a href="<?cs var:toroot?>google/play/billing/billing_reference.html"> + <span class="en">In-app Billing Reference</span></a> + </li> + </ul> + </li> + + <li class="nav-section"> + <div class="nav-section-header"><a href="<?cs var:toroot ?>google/play/dist.html"> + <span class="en">Google Play Distribution and Licensing</span></a> + </div> + <ul> + <li><a href="<?cs var:toroot ?>google/play/filters.html"> + <span class="en">Filters on Google Play</span></a> + </li> + + <li><a href="<?cs var:toroot ?>google/play/publishing/multiple-apks.html"> + <span class="en">Multiple APK Support</span></a> + </li> + + <li><a href="<?cs var:toroot ?>google/play/expansion-files.html"> + <span class="en">APK Expansion Files</span></a> + </li> + + <li class="nav-section"> + <div class="nav-section-header"><a href="<?cs var:toroot ?>google/play/licensing/index.html"> + <span class="en">Application Licensing</span></a> + </div> + <ul> + <li><a href="<?cs var:toroot?>google/play/licensing/overview.html"> + <span class="en">Licensing Overview</span></a> + </li> + <li><a href="<?cs var:toroot?>google/play/licensing/setting-up.html"> + <span class="en">Setting Up for Licensing</span></a> + </li> + <li><a href="<?cs var:toroot?>google/play/licensing/adding-licensing.html"> + <span class="en">Adding Licensing to Your App</span></a> + </li> + <li><a href="<?cs var:toroot?>google/play/licensing/licensing-reference.html"> + <span class="en">Licensing Reference</span></a> + </li> + </ul> + </li> + </ul> + + + <li class="nav-section"> + <div class="nav-section-header"><a href="<?cs var:toroot ?>google/gcm/index.html"> + <span class="en">Google Cloud Messaging</span></a> + </div> + <ul> + <li><a href="<?cs var:toroot?>google/gcm/gs.html"> + <span class="en">Getting Started</span></a> + </li> + <li><a href="<?cs var:toroot?>google/gcm/gcm.html"> + <span class="en">Architectural Overview</span></a> + </li> + <li><a href="<?cs var:toroot?>google/gcm/demo.html"> + <span class="en">Demo App Tutorial</span></a> + </li> + <li><a href="<?cs var:toroot?>google/gcm/adv.html"> + <span class="en">Advanced Topics</span></a> + </li> + <li><a href="<?cs var:toroot?>google/gcm/c2dm.html"> + <span class="en">Migration</span></a> + </li> + </ul> + </li> +</ul> + +<script type="text/javascript"> +<!-- + buildToggleLists(); + changeNavLang(getLangPref()); +//--> +</script> + diff --git a/docs/html/google/index.jd b/docs/html/google/index.jd new file mode 100644 index 0000000..ab2c58c --- /dev/null +++ b/docs/html/google/index.jd @@ -0,0 +1,86 @@ +page.title=Google Services +@jd:body + +<p> + Google offers a variety of services that help you build new revenue streams, enhance your app's + capabilities, manage distribution and payloads, and track usage and installs. + The sections below highlight some of the services offered by Google and link you to more information about + how to use them in your Android app. +</p> + <h2> + Integrate Google Products + </h2> + <img src="{@docRoot}images/gps-small.png" style="float:left; padding-right:10px"> + <p>Utilize the most up-to-date features of Google products in your app + without worrying the Android versions running on your users' devices. Users receive updates to Google Play + services through the Google Play store whenever available, ensuring + that exciting, new features of your app reach the most devices possible. + All of this comes with an easy-to-use authentication flow for you and your users. + </p><a href="{@docRoot}guide/google/play-services/index.html">Learn more »</a> + +<div class="vspace size-1"> + +</div> + +<h2 id="monetization"> + Monetize Your App +</h2> +<p> + Make the most out of your app's revenue potential by using monetization policies targeted + at your users' needs. +</p> + +<div class="vspace size-1"> + +</div> + +<div class="layout-content-row"> + <div class="layout-content-col span-6"> + <h4> + Google Play In-App Billing + </h4> + <p> + Engage users by offering features such as new content or virtual goods directly in your app. + </p><a href="{@docRoot}guide/google/play/billing/index.html">Learn more »</a> + </div> + + <div class="layout-content-col span-6"> + <h4> + Google AdMob Ads + </h4> + <p> + Generate revenue by displaying ads in your app with multiple ad networks. + </p><a href="http://www.google.com/ads/admob/index.html">Learn more »</a> + </div> +</div> + + + +<h2 id="gcm"> + Receive Messages from the Cloud +</h2> + <img src="/images/gcm/gcm-logo.png" width="150px" style="padding:9px; float:left"> + + <p>Use Google Cloud Messaging to notify your apps of important events with + that are lightweight and battery-saving. There are no quotas or charges + to use Google Cloud Messaging, no matter how big your messaging needs are.</p> + + <a href="{@docRoot}guide/google/gcm/index.html">Learn more »</a> + +<div class="vspace size-1"> + +</div> + + +<h2 id="distribution"> + Manage App Distribution and Licensing +</h2> +<p> + Google Play allows you to manage your app distribution with features such as app licensing + and device filtering. Take advantage of features that let you reach the right users with + the right content while protecting your app from unauthorized use. +</p> + + <a href="{@docRoot}guide/google/play/dist.html">Learn more »</a> +</div> + diff --git a/docs/html/google/play-services/analytics.jd b/docs/html/google/play-services/analytics.jd new file mode 100644 index 0000000..df93cbe --- /dev/null +++ b/docs/html/google/play-services/analytics.jd @@ -0,0 +1,56 @@ +page.title=Google Analytics +page.landing=true +page.landing.intro=The Google Analytics Platform lets you measure user interactions with your business across various devices and environments. The platform provides all the computing resources to collect, store, process, and report on these user-interactions. +page.landing.link=https://developers.google.com/analytics/devguides/collection/android/v2/ +page.landing.link.text=developers.google.com/analytics +page.landing.image=images/gps-analytics.png + +@jd:body + +<div class="landing-docs"> + <div class="col-6"> + <h3 style="clear:left">Key Developer Features</h3> + + <a href="https://developers.google.com/analytics/devguides/collection/android/v2/campaigns"> + <h4>Discover user geography and habits</h4> + Discover where your users are coming from and how they are accessing your app, + from the moment they download your app from the Google Play Store.</a> + + <a href="https://developers.google.com/analytics/devguides/collection/android/v2/ecommerce"> + <h4>Track monetization performance</h4> + Monitor the success of mobile marketing campaigns by taking advantage of the end-to-end visibility + into the performance of your in-app purchases and transactions. + </a> + + <a href="https://developers.google.com/analytics/devguides/collection/android/v2/screens"> + <h4>Monitor app usage</h4> + Record data about the screens your users are viewing in your app and gain insight + on what features they use most. All of this information can help you pinpoint specific + markets and enhance features to make your app the best it can be. + </a> + + </div> + + <div class="col-6 normal-links"> + <h3 style="clear:left">Getting Started</h3> + <h4>Get the Google Play services SDK</h4> + <p>The Google Analytics Android APIs are part of the Google Play services platform.</p> + <p><a href="{@docRoot}google/play-services/download.html">Download and configure</a> + the SDK to begin integrating Google Analytics into your app. + </p> + + <h4>Visit the Google Analytics developer site</h4> + <p>For instructions on how to fully integrate Google+ into your app, with code snippets, visit the + <a href="https://developers.google.com/analytics/devguides/collection/android/v2/">Google + Analytics developer documentation</a> located at developers.google.com. + </p> + + <h4>See the reference documentation</h4> + <p> + The <a href="{@docRoot}google/play-services/reference/com/google/android/gms/analytics/package-summary.html">Google + Analytics API reference</a> as well as the entire <a href="{@docRoot}google/play-services/reference/packages.html">Google + Play services platform reference</a> is provided for you on this site. + </p> + + </div> +</div>
\ No newline at end of file diff --git a/docs/html/google/play-services/auth.jd b/docs/html/google/play-services/auth.jd new file mode 100644 index 0000000..8787ec9 --- /dev/null +++ b/docs/html/google/play-services/auth.jd @@ -0,0 +1,196 @@ +page.title=Authentication +@jd:body + +<div id="qv-wrapper"> + <div id="qv"> + <h2>In this document</h2> + <ol> + <li><a href="#choose">Choosing an account</a></li> + <li><a href="#obtain">Obtaining an authorization token</a></li> + <li><a href="#handle">Handling exceptions</a></li> + <li><a href="#use">Using the token</a></li> + </ol> + </div> +</div> + +<p> + Google Play services offers a standard authentication flow for all Google APIs and + all components of Google Play services. In addition, you can leverage the authentication + portion of the Google Play services SDK to authenticate to services that are not yet supported + in the Google Play services platform by using the authentication token to manually make API + requests or using a client library provided by the service provider. +</p> + +<p>For implementation details, see the sample in <code><android-sdk>/extras/google-play-services/samples/auth</code>, which shows you how +to carry out these basic steps for obtaining an authentication token.</p> + +<h2 id="choose">Choosing an Account</h2> +<p> + Google Play services leverage existing accounts on an Android-powered device + to authenticate to the services that you want to use. To obtain an authorization token, + a valid Google account is required and it must exist on the device. You can ask your users which + account they want to use by enumerating the Google accounts on the device or using the + built-in +<a href="{@docRoot}google/play-services/reference/com/google/android/gms/common/AccountPicker.html">AccountPicker</a> + class to display a standard account picker view. You'll need the + {@link android.Manifest.permission#GET_ACCOUNTS} + permission set in your manifest file for both methods. +</p> +<p> + For example, here's how to gather all of the Google accounts on a device and return them + in an array. When obtaining an authorization token, only the email address of the account is + needed, so that is what the array stores: +</p> + +<pre> +private String[] getAccountNames() { + mAccountManager = AccountManager.get(this); + Account[] accounts = mAccountManager.getAccountsByType( + GoogleAuthUtil.GOOGLE_ACCOUNT_TYPE); + String[] names = new String[accounts.length]; + for (int i = 0; i < names.length; i++) { + names[i] = accounts[i].name; + } + return names; +} +</pre> +<h2 id="obtain">Obtaining an Authorization Token</h2> +<p> + With an email address, you can now obtain an authorization token. There are two general + ways to get a token:</p> + + <ul> + <li>Call one of the two overloaded <a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/GoogleAuthUtil.html#getToken(android.content.Context, java.lang.String, java.lang.String)">GoogleAuthUtil.getToken()</a> methods in a foreground activity where you can + display a dialog to the user to interactively handle authentication errors.</li> + <li>Call one of the three <a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/GoogleAuthUtil.html#getTokenWithNotification(android.content.Context, java.lang.String, java.lang.String, android.os.Bundle)">getTokenWithNotification()</a> + methods if you are authenticating in a background service or sync adapter so that a notification is displayed if an authentication + error occurs.</a></li> + </ul> + + <h3>Using getToken()</h3> + The following code snippet obtains an authentication token with an email address, the scope that you want to use for the service, and a {@link android.content.Context}: +<pre> +HelloActivity mActivity; +String mEmail; +String mScope; +String token; + +... + +try { + token = GoogleAuthUtil.getToken(mActivity, mEmail, mScope); +} catch { + ... +} +</pre> + +<p>Call this method off of the main UI thread since it executes network transactions. An easy way to do this + is in an <a href="http://developer.android.com/reference/android/os/AsyncTask.html">AsyncTask</a>. + The sample in the Google Play services SDK shows you how to wrap this call in an AsyncTask. + If authentication is successful, the token is returned. If not, the exceptions described in <a href="#handle">Handling Exceptions</a> + are thrown that you can catch and handle appropriately. +</p> + + <h3>Using getTokenWithNotification()</h3> + <p>If you are obtaining authentication tokens in a background service or sync adapter, there are three overloaded <code>getTokenWithNotification()</code> methods + that you can use:</p> + <ul> + <li><a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/GoogleAuthUtil.html#getTokenWithNotification(android.content.Context, java.lang.String, java.lang.String, android.os.Bundle)">getTokenWithNotification(Context context, String accountName, String scope, Bundle extras)</a>: + For background services. Displays a notification to the user when authentication errors occur.</li> + <li><a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/GoogleAuthUtil.html#getTokenWithNotification(android.content.Context, java.lang.String, java.lang.String, android.os.Bundle, android.content.Intent)">getTokenWithNotification(Context context, String accountName, String scope, Bundle extras, Intent callback)</a>: + This method is for use in background services. It displays a notification to the user when authentication errors occur. If a user clicks the notification and then authorizes the app to access the account, the intent is broadcasted. When using this method: + <ul> + <li>Create a {@link android.content.BroadcastReceiver} that registers the intent and handles it appropriately</li> + <li>In the app's manifest file, set the <code>android:exported</code> attribute to <code>true</code> for the broadcast receiver</li> + <li>Ensure that the intent is serializable using the {@link android.content.Intent#toUri toUri(Intent.URI_INTENT_SCHEME)} and + {@link android.content.Intent#parseUri parseUri(intentUri, Intent.URI_INTENT_SCHEME)} methods.</li> + </ul> + <li><a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/GoogleAuthUtil.html#getTokenWithNotification(android.content.Context, java.lang.String, java.lang.String, android.os.Bundle, java.lang.String, android.os.Bundle)">getTokenWithNotification(Context context, String accountName, String scope, Bundle extras, String authority, Bundle syncBundle)</a>: This method is for use in sync adapters. It displays a notification to the user when authentication errors occur. If a user clicks the notification and then authorizes the app to access the account, the sync adapter retries syncing with the information + contained in the <code>syncBundle</code> parameter.</li> + </ul> + + <p>See the sample in <code><android-sdk>/extras/google-play-services/samples/auth</code> for implementation details.</p> + +<h2 id="handle">Handling Exceptions</h2> +<p> + When requesting an authentication token with + <a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/GoogleAuthUtil.html#getToken(android.content.Context, java.lang.String, java.lang.String)">GoogleAuthUtil.getToken()</a>, + the following exceptions can be thrown: +</p> +<ul> + <li> +<a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/UserRecoverableAuthException.html">UserRecoverableAuthException</a>: + This exception is thrown when an error occurs that users can resolve, such as not yet granting access to their accounts or if they changed their password. + This exception class contains a {@link android.app.Activity#getIntent getIntent()} + method that you can call to obtain an intent that you can use with +{@link android.app.Activity#startActivityForResult startActivityForResult()} + to obtain the user's resolution. You will need to handle the +{@link android.app.Activity#onActivityResult onActivityResult()} + callback when this activity returns to take action based on the user's actions. + </li> + <li> +<a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/GooglePlayServicesAvailabilityException.html">GooglePlayServicesAvailabilityException</a>: + This exception is a special case of <a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/UserRecoverableAuthException.html">UserRecoverableAuthException</a> + and occurs when the actual Google Play services APK is not installed or unavailable. + This exception provides additional client support to + handle and fix this issue by providing an error code that describes the exact cause of the problem. + This exception also contains an intent that you can obtain and use to start + an activity to resolve the issue. + </li> + <li> +<a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/GoogleAuthException.html">GoogleAuthException</a>: + This exception is thrown when the authorization fails, such as when an invalid scope is + specified or if the email address used to authenticate is actually not on the user's + device. + </li> + <li> +<a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/UserRecoverableNotifiedException.html">UserRecoverableNotifiedException</a>: + This exception is thrown when the authorization fails using one of the <code>getTokenWithNotification()</code> methods and if the error + is recoverable with a user action. + </li> +</ul> +<p> + For more information on how to handle these exceptions and code snippets, see the reference + documentation for the +<a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/GoogleAuthUtil.html">GoogleAuthUtil</a> + class. +</p> +<h2 id="use">Using the Token</h2> +<p> + Once you have successfully obtained a token, you can use it to access Google services. + Many Google services provide client libraries, so it is recommended that you use these when + possible, but you can make raw HTTP requests as well with the token. The following example + shows you how to do this and handle HTTP error and success responses accordingly: +</p> + +<pre> +URL url = new URL("https://www.googleapis.com/oauth2/v1/userinfo?access_token=" + + token); +HttpURLConnection con = (HttpURLConnection) url.openConnection(); +int serverCode = con.getResponseCode(); +//successful query +if (serverCode == 200) { + InputStream is = con.getInputStream(); + String name = getFirstName(readResponse(is)); + mActivity.show("Hello " + name + "!"); + is.close(); + return; +//bad token, invalidate and get a new one +} else if (serverCode == 401) { + GoogleAuthUtil.invalidateToken(mActivity, token); + onError("Server auth error, please try again.", null); + Log.e(TAG, "Server auth error: " + readResponse(con.getErrorStream())); + return; +//unknown error, do something else +} else { + Log.e("Server returned the following error code: " + serverCode, null); + return; +} +</pre> + +<p> + Notice that you must manually invalidate the token if the response from the server + signifies an authentication error (401). This could mean the authentication token + being used is invalid for the service's scope or the token may have expired. If this is the + case, obtain a new token using <a href="{@docRoot}google/play-services/reference/com/google/android/gms/auth/GoogleAuthUtil.html#getToken(android.content.Context, java.lang.String, java.lang.String)">GoogleAuthUtil.getToken()</a>. +</p>
\ No newline at end of file diff --git a/docs/html/google/play-services/dist.jd b/docs/html/google/play-services/dist.jd new file mode 100644 index 0000000..85a64f9 --- /dev/null +++ b/docs/html/google/play-services/dist.jd @@ -0,0 +1,56 @@ +page.title=Google Play Distribution and Licensing +@jd:body + + +<h2 id="distribution"> + Manage App Distribution and Licensing +</h2> +<p> + Google Play allows you to manage your app distribution with features that let you control which users + can download your app as well as deliver separate versions of your app based on certain + characteristics like platform version. +</p> +<div class="vspace size-1"> + +</div> +<div class="layout-content-row"> + <div class="layout-content-col span-6"> + <h4> + Device Filtering + </h4> + <p> + Make sure your app gets to the right users by filtering on a wide range of characteristics + such as platform versions and hardware features. + </p><p><a href="{@docRoot}guide/google/play/filters.html">Learn more »</a></p> + </div> + + <div class="layout-content-col span-6"> + <h4> + Multiple APK Support + </h4> + <p> + Distribute different APKs based on a variety of properties such as platform version, screen + size, and GLES texture compression support. + </p><p><a href="{@docRoot}guide/google/play/publishing/multiple-apks.html">Learn more »</a></p> + </div> + +<div class="layout-content-row"> + <div class="layout-content-col span-6"> + <h4> + APK Expansion files + </h4> + <p> + Tap into Google's content delivery services by serving up to 4GB of assets for free. Provide + users with high-fidelity graphics, media files, or other large assets that are required by + your app. + </p><a href="{@docRoot}guide/google/play/expansion-files.html">Learn more »</a> + </div> + + <div class="layout-content-col span-6"> + <h4> + Application Licensing + </h4> + <p>Protect your revenue streams and integrate policies for usage into your app. + </p><a href="{@docRoot}guide/google/play/licensing/index.html">Learn more »</a> + </div> +</div>
\ No newline at end of file diff --git a/docs/html/google/play-services/download.jd b/docs/html/google/play-services/download.jd new file mode 100644 index 0000000..fb03035 --- /dev/null +++ b/docs/html/google/play-services/download.jd @@ -0,0 +1,140 @@ +page.title=Downloading and Configuring the Google Play services SDK +@jd:body + +<div id="qv-wrapper"> + <div id="qv"> + <h2>In this document</h2> + <ol> + <li><a href="#ensure">Ensuring Devices Have the Google Play services APK</a></li> + </ol> + </div> +</div> + + +<p> + The Google Play services SDK is an extension to the Android SDK and is available to you as a + downloadable SDK component. This download includes the client library and code samples. +</p> + +<p> + Before you get started developing, make sure that you have an updated version of the Android SDK + installed on your computer, including the SDK Tools component. If you don't have the SDK, + visit the <a href="{@docRoot}sdk/index.html">SDK Download page</a> + on the Android Developers site. +</p> + +<p> + To download and configure the Google Play services SDK: +</p> + +<ol> + <li> + Launch Eclipse and select <b>Window > Android SDK Manager</b> or run <code>android</code> + at the command line. + </li> + <li> + Scroll to the bottom of the package list and select <b>Extras > Google Play services</b>. + The add-on is downloaded to your computer and installed in your SDK environment at + <code><android-sdk-folder>/extras/google/google_play_services/</code>. + </li> + <li> + Reference the Google Play services client library project located in + <code><android-sdk-folder>/extras/google/google_play_services/libproject/google-play-services_lib</code> as + a library project for your Android project. See the + <a href="{@docRoot}tools/projects/projects-eclipse.html#ReferencingLibraryProject">Referencing a Library Project for Eclipse</a> + or <a href="{@docRoot}tools/projects/projects-cmdline.html#ReferencingLibraryProject">Referencing a Library Project on the Command Line</a> + for more information on how to do this. + </li> + <li>If you are using <a href="{@docRoot}tools/help/proguard.html">ProGuard</a>, add the following + lines in the <code><project_directory>/proguard-project.txt</code> file: + to prevent ProGuard from stripping away required classes: +<pre> +-keep class * extends java.util.ListResourceBundle { + protected Object[][] getContents(); +} +</pre> +</ol> + +<h2 id="ensure">Ensuring Devices Have the Google Play services APK</h2> +<p> + Google Play delivers updates to the majority of the devices that support Google Play services + (Android 2.2 devices with the Google Play Store app installed). However, updates might not reach + supported devices in a timely manner, which are desribed in the following four scenarios: +<p class="note"> +<strong>Important:</strong> +<span> + Because it is hard to anticipate the state devices are in, you must <em>always</em> check for a + compatible Google Play services APK in your app when you are accessing Google Play services + features. For many apps, this is each time in the + {@link android.app.Activity#onResume onResume()} method of the main activity. +</span> +</p> +<ol> + <li> + A recent version of the Google Play Store app is installed, and the most recent Google Play + services APK has been downloaded. + </li> + <li> + A recent version of the Google Play Store app is installed, but the most recent Google Play + services APK has <em>not</em> been downloaded. + </li> + <li> + An old version of the Google Play Store app, which does not proactively download Google Play + services updates, is present. + </li> + <li> + The Google Play services APK is missing or disabled on the device, which might happen if the + user explicitly uninstalls or disables it. + </li> +</ol> +<p> + Case 1 is the success scenario and is the most common. However, because the other scenarios can + still happen, you must handle them every time your app connects to a Google Play service to + ensure that the Google Play services APK is present, up-to-date, and enabled. +</p> +<p> + To help you, the Google Play services client library has utility methods to assist in + determining whether or not the Google Play services APK is recent enough to support the + version of the client library that you are using. If not, the client library sends users to the + Google Play Store to download a recent version of the Google Play services APK. +</p> + +<p class="note"> +<b>Note:</b> +<span> + The Google Play services APK is not visible by searching the Google Play Store. The client + library provides a deep link into the Google Play Store when it detects that the device has a + missing or incompatible Google Play services APK. +</span> +</p> + +<p> + It is up to you choose the appropriate place in your app to do the following steps to check for + a valid Google Play services APK. For example, if Google Play services is required for your app, + you might want to do it when your app first launches. On the other hand, if Google Play services + is an optional part of your app, you can do these checks if the user navigates to that portion + of your app: +</p> + +<ol> + <li> + Query for the status of Google Play services on the device with the +<a href="{@docRoot}google/play-services/reference/com/google/android/gms/common/GooglePlayServicesUtil.html#isGooglePlayServicesAvailable(android.content.Context)">isGooglePlayServicesAvailable()</a> + method, which returns a result code. + </li> + <li> + If the result code is +<a href="{@docRoot}google/play-services/reference/com/google/android/gms/common/ConnectionResult.html#SUCCESS">SUCCESS</a>, + then the Google Play services APK is up-to-date, and you can proceed as normal. + </li> + <li> + If the result is +<a href="{@docRoot}google/play-services/reference/com/google/android/gms/common/ConnectionResult.html#SERVICE_MISSING">SERVICE_MISSING</a>, +<a href="{@docRoot}google/play-services/reference/com/google/android/gms/common/ConnectionResult.html#SERVICE_VERSION_UPDATE_REQUIRED">SERVICE_VERSION_UPDATE_REQUIRED</a>, + or +<a href="{@docRoot}google/play-services/reference/com/google/android/gms/common/ConnectionResult.html#SERVICE_DISABLED">SERVICE_DISABLED</a>, + call <a href="{@docRoot}google/play-services/reference/com/google/android/gms/common/GooglePlayServicesUtil.html#getErrorDialog(int, android.app.Activity, int)">getErrorDialog()</a> + to display an error message to the user, which will then allow the user to download the APK + from the Google Play Store or enable it in the device's system settings. + </li> +</ol>
\ No newline at end of file diff --git a/docs/html/google/play-services/index.jd b/docs/html/google/play-services/index.jd new file mode 100644 index 0000000..60a689d --- /dev/null +++ b/docs/html/google/play-services/index.jd @@ -0,0 +1,76 @@ +page.title=Google Maps +page.landing=true +page.landing.intro=Add Google maps to your Android apps and let your users explore the world. Give your users all of the benefits of the Google Maps, but with the customizations that you need for your app and users. +page.landing.link=https://developers.google.com/maps/documentation/android/ +page.landing.link.text=developers.google.com/maps +page.landing.image=images/gps.png + +@jd:body +<img src="{@docRoot}images/gps.png" style="float:right;" /> + +<p> + Google Play services is a platform delivered through the Google Play Store that + lets you integrate Google products into your Android apps. + The Google Play services framework consists of a services component + that runs on the device and a thin client library that you package with your app. +</p> + + +<p> +<a class="next-page-link topic-start-link" +href="{@docRoot}google/play-services/overview.html"> +OVERVIEW</a> +</p> + +<div class="vspace size-1"> </div> + +<div class="layout-content-row"> + <div class="layout-content-col span-4"> + +<h4>Google Technology</h4> +<p>Add exciting and useful Google features such as Maps, Google+, Analytics, and more +to your Android apps. Easy-to-use client libraries are provided for the products in Google +Play services, so you can implement the functionality you want faster. New features +and products are continuously being added, so make sure to check back often.</p> + + </div> + <div class="layout-content-col span-4"> + +<h4>Standard Authentication</h4> +<p>All products in Google Play services share a common authentication API + that leverages the existing Google accounts on the device. You and your + users have a consistent and safe way to grant and receive OAuth2 authentication + to Google services. Even services that are not bundled in Google Play services + can take advantage of the authentication APIs as long as they accept OAuth2 + tokens associated with a Google account.</p> + + </div> + <div class="layout-content-col span-4"> + +<h4>Automatic Updates</h4> +<p>Devices running Android 2.2 and newer and that have the Google Play Store app installed +automatically receive updates to Google Play services. New products, features, and fixes are +automatically pushed to a wide range of devices, old and new. You can now enhance your app with the most +up-to-date version of Google Play services without worrying about your users' Android platform version.</p> + + </div> +</div> + +<h2>Services</h2> + <div class="landing-docs"> + <a href=""> + <h4>Google+</h4> + <p>Add social features to your app to with Google+.</p> + </a> + + <a href=""> + <h4>Google Analytics</h4> + <p>Make sure you're reaching the right users and find ways to reach more with Google Analytics.</p> + </a> + + <a href=""> + <h4>Google Maps</h4> + <p>Add compelling location-based features to your app to direct your users where they + want to go.</p> + </a> +</div>
\ No newline at end of file diff --git a/docs/html/google/play-services/maps.jd b/docs/html/google/play-services/maps.jd new file mode 100644 index 0000000..eea17e9 --- /dev/null +++ b/docs/html/google/play-services/maps.jd @@ -0,0 +1,73 @@ +page.title=Google Maps +page.landing=true +page.landing.intro=Add Google maps to your Android apps and let your users explore the world. Give your users all of the benefits of the Google Maps, but with the customizations that you need for your app and users. +page.landing.link=https://developers.google.com/maps/documentation/android/ +page.landing.link.text=developers.google.com/maps +page.landing.image=images/gps-maps.png + +@jd:body + +<div class="landing-docs"> + <div class="col-6"> + <h3 style="clear:left">Key Developer Features</h3> + <a href="https://developers.google.com/maps/documentation/android/map"> + <h4>Bring Maps to your Mobile Apps</h4> + The Google Maps APIs let you embed Google Maps into an Activity with a simple XML snippet + in the form of a fragment. With MapFragment, you can take advantage of exciting features such as 3D maps; + indoor, satellite, terrain, and hybrid maps; and vector-based tiles for efficient caching and drawing. + </a> + + <a href="https://developers.google.com/maps/documentation/android/marker"> + <h4>Highlight important places and routes</h4> + <p> + Overlay markers onto your maps to highlight places your users are interested + in. You can also define custom colors or icons for your map markers to + coincide with the look and feel of your app.</p> + + <p>In addition, you can draw polylines, a set of connected line segments on a map + and polygons, a set of polylines in a closed loop.</p> + </a> + + <a href="https://developers.google.com/maps/documentation/android/views"> + <h4>Change views and perspectives</h4> + Give your users a different view of the world with the ability to control rotation, tilting, + zooming, and panning properties of the maps you are displaying. Show 3D views of maps, + zoom in on terrain maps, allow users to swipe across areas, and much more. + </a> + + </div> + + <div class="col-6 normal-links"> + <h3 style="clear:left">Getting Started</h3> + <h4>Configure Maps</h4> + <p>The Google Maps Android APIs are part of the Google Play services platform.</p> + <p>To use Google Maps, <a href="{@docRoot}google/play-services/download.html">download and configure</a> + the Google Play services SDK and see the <a href="https://developers.google.com/maps/documentation/android/start#installing_the_google_maps_android_v2_api"> + Getting Started guide</a> on how to configure Google Maps for your app. + </p> + + <h4>Run the sample</h4> + <p> + The Google Maps sample is located in <code><android-sdk>/extras/google-play-services/samples/maps</code> + and shows you how to use the major components of the Google Maps Android APIs. + </p> + + <h4>Visit the Google Maps developer site</h4> + <p> + For instructions on how to fully integrate Google+ into your app, with code snippets, visit the + <a href="https://developers.google.com/maps/documentation/android/intro">Google Maps developer documentation</a> + located at developers.google.com. + </p> + + <h4>See the reference documentation</h4> + <p> + The <a href="{@docRoot}google/play-services/reference/com/google/android/gms/maps/package-summary.html">Google Maps API reference</a> + is provided for you on this site and is also available at <a href="https://developers.google.com/maps/documentation/android/reference/com/google/android/gms/maps/package-summary">developers.google.com</a> if you + prefer to read them there.</p> + <p> + In addition, the entire <a href="{@docRoot}google/play-services/reference/packages.html">Google Play + services platform reference</a> is hosted on this site for your convenience. + </p> + </div> + </div> +</div>
\ No newline at end of file diff --git a/docs/html/google/play-services/overview.jd b/docs/html/google/play-services/overview.jd new file mode 100644 index 0000000..5ea72d9 --- /dev/null +++ b/docs/html/google/play-services/overview.jd @@ -0,0 +1,49 @@ +page.title=Overview +@jd:body + +<p> +Google Play services is a platform delivered by the Google Play Store that offers integration with Google products, +such as Google+, in Android apps. The Google Play services platform consists of a services component that runs on +the device and a thin client library that you package with your app. The following diagram shows the interaction +between the two components: +</p> + +<img src="{@docRoot}images/play-services-diagram.png" /> + +<p> + The Google Play services component is delivered as an APK through the Google Play Store, so + updates to Google Play services are not dependent on carrier or OEM system image updates. Newer + devices will also have Google Play services as part of the device's system image, but updates + are still pushed to these newer devices through the Google Play Store. In general, devices + running Android 2.2 (Froyo) or later that have the Google Play Store receive updates within a + few days. This allows you to leverage the newest APIs for Google products and reach most of the + devices in the Android ecosystem. Devices older than Android 2.2 or devices without the Google + Play Store app are not supported. +</p> + +<p> + The Google Play services component contains much of the logic to communicate with the specific + Google product that you want to interact with. An easy-to-use authentication flow is also + provided to gain access to supported Google products, which provides consistency for both the + developer and user. From the developer's point of view, requesting credentials is mostly taken + care of by the services component through calls to the client library. From the user's point of + view, authorization is granted with a few simple clicks. +</p> + +<p> + The client library contains the interfaces to call into the services component. It also contains + APIs that allow you to resolve any issues at runtime such as a missing, disabled, or out-of-date + Google Play services APK. The client library has a light footprint if you use + ProGuard as part of your build process, so it won't have an adverse impact on your app's file size. See the + <a href="{@docRoot}google/play-services/overview.html">Downloading and Configuring the Google Play services SDK</a> for more + information on how to configure + <a href="{@docRoot}tools/help/proguard.html">ProGuard</a>. +</p> + +<p> + If you want to access added features or products that are periodically added to the client + library, you can upgrade to a new version as they are released. However, upgrading is not + necessary if you don't care about new features or bug fixes in the new versions of the client + library. We anticipate more Google services to be continuously added, so be on the lookout for + these updates. +</p>
\ No newline at end of file diff --git a/docs/html/google/play-services/plus.jd b/docs/html/google/play-services/plus.jd new file mode 100644 index 0000000..7742318 --- /dev/null +++ b/docs/html/google/play-services/plus.jd @@ -0,0 +1,65 @@ +page.title=Google+ +page.landing=true +page.landing.intro=Create an engaging social experience and connect with more users by integrating G+ into your app. +page.landing.link=https://developers.google.com/+/mobile/android/ +page.landing.link.text=developers.google.com/+ +page.landing.image=images/gps-plus.png + +@jd:body + +<div class="landing-docs"> + <div class="col-6"> + <h3 style="clear:left">Key Developer Features</h3> + + <a href="https://developers.google.com/+/mobile/android/share"> + <h4>Share to Google+</h4> + Display a Share dialog that lets your users share rich content from your app, including text, + photos, URL attachments, and location, into the Google+ stream. + </a> + + <a href="https://developers.google.com/+/mobile/android/recommend"> + <h4>Recommend content</h4> + Add a native +1 button so users can recommend content from your app. When users +1, they can + also share content with their circles. These endorsements can give your app more + credibility and help it grow faster. + </a> + + <a href="https://developers.google.com/+/mobile/android/sign-in"> + <h4>Sign in with Google+</h4> + Allow users to easily and securely sign in to your app using their Google+ credentials. + This allows you to know who they are on Google+ and to build a more personalized experience in your app. + </a> + <a href="https://developers.google.com/+/mobile/android/write-moments"> + <h4>Save moments</h4> + Save user actions from your app such as check-ins, reviews, video views, comments, and more, + to your users' private Google+ history. From there, users can share these moments with others. + </a> + </div> + + <div class="col-6 normal-links"> + <h3 style="clear:left">Getting Started</h3> + <h4>Get the Google Play services SDK</h4> + <p>The Google+ Android APIs are part of the Google Play services platform.</p> + <p><a href="{@docRoot}google/play-services/download.html">Download and configure</a> + the SDK to begin integrating Google+ into your app. + </p> + + <h4>Run the sample</h4> + <p> + The Google+ sample is located in <code><android-sdk>/extras/google-play-services/samples/plus</code> and shows you + how to use the major components of the Google+ Android APIs. + </p> + + <h4>Visit the Google+ developer site</h4> + <p>For instructions on how to fully integrate Google+ into your app, with code snippets, visit the + <a href="https://developers.google.com/+/mobile/android/">Google+ developer documentation</a> located at + developers.google.com. + </p> + + <h4>See the reference documentation</h4> + <p>The <a href="{@docRoot}google/play-services/reference/com/google/android/gms/plus/package-summary.html">Google+ API reference</a> + as well as the entire <a href="{@docRoot}google/play-services/reference/packages.html">Google Play services platform reference</a> + is provided for you on this site. + </p> + </div> +</div>
\ No newline at end of file diff --git a/docs/html/google/play-services/reference/packages.jd b/docs/html/google/play-services/reference/packages.jd new file mode 100644 index 0000000..4f1ce79 --- /dev/null +++ b/docs/html/google/play-services/reference/packages.jd @@ -0,0 +1,6 @@ +page.title=Reference +@jd:body + +<p> + See offline docs +</p>
\ No newline at end of file diff --git a/docs/html/guide/google/play/billing/billing_about.html b/docs/html/google/play/billing/billing_about.html index 9f41fa6..9f41fa6 100644 --- a/docs/html/guide/google/play/billing/billing_about.html +++ b/docs/html/google/play/billing/billing_about.html diff --git a/docs/html/guide/google/play/billing/billing_admin.jd b/docs/html/google/play/billing/billing_admin.jd index cb288a5..cb288a5 100644 --- a/docs/html/guide/google/play/billing/billing_admin.jd +++ b/docs/html/google/play/billing/billing_admin.jd diff --git a/docs/html/guide/google/play/billing/billing_best_practices.jd b/docs/html/google/play/billing/billing_best_practices.jd index 850c661..850c661 100644 --- a/docs/html/guide/google/play/billing/billing_best_practices.jd +++ b/docs/html/google/play/billing/billing_best_practices.jd diff --git a/docs/html/guide/google/play/billing/billing_integrate.jd b/docs/html/google/play/billing/billing_integrate.jd index 2d1582e..2d1582e 100644 --- a/docs/html/guide/google/play/billing/billing_integrate.jd +++ b/docs/html/google/play/billing/billing_integrate.jd diff --git a/docs/html/guide/google/play/billing/billing_overview.jd b/docs/html/google/play/billing/billing_overview.jd index 82f6cf4..82f6cf4 100644 --- a/docs/html/guide/google/play/billing/billing_overview.jd +++ b/docs/html/google/play/billing/billing_overview.jd diff --git a/docs/html/guide/google/play/billing/billing_reference.jd b/docs/html/google/play/billing/billing_reference.jd index c5541fa..c5541fa 100644 --- a/docs/html/guide/google/play/billing/billing_reference.jd +++ b/docs/html/google/play/billing/billing_reference.jd diff --git a/docs/html/guide/google/play/billing/billing_subscriptions.jd b/docs/html/google/play/billing/billing_subscriptions.jd index 68eda19..68eda19 100644 --- a/docs/html/guide/google/play/billing/billing_subscriptions.jd +++ b/docs/html/google/play/billing/billing_subscriptions.jd diff --git a/docs/html/guide/google/play/billing/billing_testing.jd b/docs/html/google/play/billing/billing_testing.jd index e2d4a01..e2d4a01 100644 --- a/docs/html/guide/google/play/billing/billing_testing.jd +++ b/docs/html/google/play/billing/billing_testing.jd diff --git a/docs/html/guide/google/play/billing/index.jd b/docs/html/google/play/billing/index.jd index 134140d..134140d 100644 --- a/docs/html/guide/google/play/billing/index.jd +++ b/docs/html/google/play/billing/index.jd diff --git a/docs/html/google/play/dist.jd b/docs/html/google/play/dist.jd new file mode 100644 index 0000000..7e60315 --- /dev/null +++ b/docs/html/google/play/dist.jd @@ -0,0 +1,52 @@ +page.title=Google Play Distribution and Licensing +@jd:body + +<p> + Google Play allows you to manage your app distribution with features that let you control which users + can download your app as well as deliver separate versions of your app based on certain + characteristics like platform version. +</p> +<div class="vspace size-1"> + +</div> +<div class="layout-content-row"> + <div class="layout-content-col span-6"> + <h4> + Device Filtering + </h4> + <p> + Make sure your app gets to the right users by filtering on a wide range of characteristics + such as platform versions and hardware features. + </p><p><a href="{@docRoot}guide/google/play/filters.html">Learn more »</a></p> + </div> + + <div class="layout-content-col span-6"> + <h4> + Multiple APK Support + </h4> + <p> + Distribute different APKs based on a variety of properties such as platform version, screen + size, and GLES texture compression support. + </p><p><a href="{@docRoot}guide/google/play/publishing/multiple-apks.html">Learn more »</a></p> + </div> + +<div class="layout-content-row"> + <div class="layout-content-col span-6"> + <h4> + APK Expansion files + </h4> + <p> + Tap into Google's content delivery services by serving up to 4GB of assets for free. Provide + users with high-fidelity graphics, media files, or other large assets that are required by + your app. + </p><a href="{@docRoot}guide/google/play/expansion-files.html">Learn more »</a> + </div> + + <div class="layout-content-col span-6"> + <h4> + Application Licensing + </h4> + <p>Protect your revenue streams and integrate policies for usage into your app. + </p><a href="{@docRoot}guide/google/play/licensing/index.html">Learn more »</a> + </div> +</div>
\ No newline at end of file diff --git a/docs/html/guide/google/play/expansion-files.jd b/docs/html/google/play/expansion-files.jd index 9cd1bb1..9cd1bb1 100644 --- a/docs/html/guide/google/play/expansion-files.jd +++ b/docs/html/google/play/expansion-files.jd diff --git a/docs/html/guide/google/play/filters.jd b/docs/html/google/play/filters.jd index 3db9cb6..3db9cb6 100644 --- a/docs/html/guide/google/play/filters.jd +++ b/docs/html/google/play/filters.jd diff --git a/docs/html/guide/google/play/licensing/adding-licensing.jd b/docs/html/google/play/licensing/adding-licensing.jd index 4a45de3..4a45de3 100644 --- a/docs/html/guide/google/play/licensing/adding-licensing.jd +++ b/docs/html/google/play/licensing/adding-licensing.jd diff --git a/docs/html/guide/google/play/licensing/index.jd b/docs/html/google/play/licensing/index.jd index d393738..d393738 100644 --- a/docs/html/guide/google/play/licensing/index.jd +++ b/docs/html/google/play/licensing/index.jd diff --git a/docs/html/guide/google/play/licensing/licensing-reference.jd b/docs/html/google/play/licensing/licensing-reference.jd index d3d5224..d3d5224 100644 --- a/docs/html/guide/google/play/licensing/licensing-reference.jd +++ b/docs/html/google/play/licensing/licensing-reference.jd diff --git a/docs/html/guide/google/play/licensing/overview.jd b/docs/html/google/play/licensing/overview.jd index 467a3a2..467a3a2 100644 --- a/docs/html/guide/google/play/licensing/overview.jd +++ b/docs/html/google/play/licensing/overview.jd diff --git a/docs/html/guide/google/play/licensing/setting-up.jd b/docs/html/google/play/licensing/setting-up.jd index 80a4419..80a4419 100644 --- a/docs/html/guide/google/play/licensing/setting-up.jd +++ b/docs/html/google/play/licensing/setting-up.jd diff --git a/docs/html/guide/google/play/publishing/multiple-apks.jd b/docs/html/google/play/publishing/multiple-apks.jd index 0619dfc..0619dfc 100644 --- a/docs/html/guide/google/play/publishing/multiple-apks.jd +++ b/docs/html/google/play/publishing/multiple-apks.jd diff --git a/docs/html/guide/google/play/services.jd b/docs/html/google/play/services.jd index 092642c..092642c 100644 --- a/docs/html/guide/google/play/services.jd +++ b/docs/html/google/play/services.jd diff --git a/docs/html/guide/google/index.jd b/docs/html/guide/google/index.jd deleted file mode 100644 index e1fc581..0000000 --- a/docs/html/guide/google/index.jd +++ /dev/null @@ -1,134 +0,0 @@ -page.title=Google Services -footer.hide=1 -@jd:body - -<p> - Google offers a variety of services that help you build new revenue streams, enhance your app's - capabilities, manage distribution and payloads, and track usage and installs. - The sections below highlight some of the services offered by Google and link you to more information about - how to use them in your Android app. -</p> -<h2 id="monetization"> - Monetize your app -</h2> -<p> - There are many ways to monetize your Android app, such as with ad impressions or In-App billing. If you - choose to charge a price to download your app, Android also provides the ability to check - for valid application licenses to protect your revenue. Because different apps require - different strategies, you can pick which ones are best for your app. -</p> -<div class="vspace size-1"> - -</div> -<div class="layout-content-row"> - <div class="layout-content-col span-4"> - <h4> - Google AdMob Ads - </h4> - <p> - Generate revenue by displaying ads in your app with multiple ad networks. - </p><a href="http://www.google.com/ads/admob/index.html">Learn more »</a> - </div> - <div class="layout-content-col span-4"> - <h4> - In-App Billing - </h4> - <p> - Engage users by offering features such as new content or virtual goods directly in your app. - </p><a href="{@docRoot}guide/google/play/billing/index.html">Learn more »</a> - </div> - <div class="layout-content-col span-4"> - <h4> - Application Licensing - </h4> - <p>Protect your revenue streams and integrate policies for usage into your a -pp. - </p><a href="{@docRoot}guide/google/play/licensing/index.html">Learn more »</a> - </div> -</div> -<h2 id="integration"> - Enhance Your App's Capabilities -</h2> -<p> - Android and Google technologies work together to provide your users with compelling interactions - with technologies such as Maps and Google+. -</p> -<div class="vspace size-1"> - -</div> -<div class="layout-content-row"> - <div class="layout-content-col span-4"> - <h4> - Google Play Services - </h4><img src="{@docRoot}images/play_dev.png"> - <p> - Leverage Google products in your app with an easy to use authentication flow for your users. - </p><a href="{@docRoot}guide/google/play/services.html">Learn more »</a> - </div> - <div class="layout-content-col span-4"> - <h4> - Google Cloud Messaging - </h4><img src="{@docRoot}images/gcm/gcm-logo.png" width="150px" style="padding:9px;"> - <p> - Notify your apps of important events with messages that are lightweight and battery-saving. - </p><a href="{@docRoot}guide/google/gcm/index.html">Learn more »</a> - </div> - <div class="layout-content-col span-4"> - <h4> - Google Maps - </h4><img src="{@docRoot}images/google-apis.png"> - <p> - The Google Maps library for Android brings powerful mapping capabilities to your app. - </p><a href="https://developers.google.com/android/add-ons/google-apis/index">Learn more - »</a> - </div> -</div> -<h2 id="integration"> - Manage App Distribution -</h2> -<p> - Google Play allows you to manage your app distribution with features that let you control which users - can download your app as well as deliver separate versions of your app based on certain - characteristics like platform version. -</p> -<div class="vspace size-1"> - -</div> -<div class="layout-content-row"> - <div class="layout-content-col span-4"> - <h4> - Filters on Google Play - </h4> - <p> - Make sure your app gets to the right users by filtering on a wide range of characteristics - such as platform versions and hardware features. - </p><a href="{@docRoot}guide/google/play/filters.html">Learn more »</a> - </div> - <div class="layout-content-col span-4"> - <h4> - Multiple APK Support - </h4> - <p> - Distribute different APKs based on a variety of properties such as platform version, screen - size, and GLES texture compression support. - </p><a href="{@docRoot}guide/google/play/publishing/multiple-apks.html">Learn more »</a> - </div> - <div class="layout-content-col span-4"> - <h4> - APK Expansion files - </h4> - <p> - Tap into Google's content delivery services by serving up to 4GB of assets for free. Provide - users with high-fidelity graphics, media files, or other large assets that are required by - your app. - </p><a href="{@docRoot}guide/google/play/expansion-files.html">Learn more »</a> - </div> -</div> -<h2 id="integration"> - Track Performance with Analytics -</h2> -<p> - Google Analytics let you find out how users find your apps and how they use them. Start - integrating analytics to measure your app's success. -</p><a href="https://developers.google.com/analytics/devguides/collection/android/">Learn more -»</a> diff --git a/docs/html/guide/guide_toc.cs b/docs/html/guide/guide_toc.cs index d875f47..d7aacbf 100644 --- a/docs/html/guide/guide_toc.cs +++ b/docs/html/guide/guide_toc.cs @@ -533,102 +533,6 @@ </ul> </li> - - <li class="nav-section"> - <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/google/index.html"> - <span class="en">Google Services</span> - </a></div> - <ul> - - <li class="nav-section"> - <div class="nav-section-header"><a href="<?cs var:toroot?>guide/google/play/billing/index.html"> - <span class="en">In-app Billing</span></a> - </div> - <ul> - <li><a href="<?cs var:toroot?>guide/google/play/billing/billing_overview.html"> - <span class="en">In-app Billing Overview</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/play/billing/billing_integrate.html"> - <span class="en">Implementing In-app Billing</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/play/billing/billing_subscriptions.html"> - <span class="en">Subscriptions</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/play/billing/billing_best_practices.html"> - <span class="en">Security and Design</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/play/billing/billing_testing.html"> - <span class="en">Testing In-app Billing</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/play/billing/billing_admin.html"> - <span class="en">Administering In-app Billing</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/play/billing/billing_reference.html"> - <span class="en">In-app Billing Reference</span></a> - </li> - </ul> - </li> - - <li class="nav-section"> - <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/google/play/licensing/index.html"> - <span class="en">Application Licensing</span></a> - </div> - <ul> - <li><a href="<?cs var:toroot?>guide/google/play/licensing/overview.html"> - <span class="en">Licensing Overview</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/play/licensing/setting-up.html"> - <span class="en">Setting Up for Licensing</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/play/licensing/adding-licensing.html"> - <span class="en">Adding Licensing to Your App</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/play/licensing/licensing-reference.html"> - <span class="en">Licensing Reference</span></a> - </li> - </ul> - </li> - <li><a href="<?cs var:toroot ?>guide/google/play/services.html"> - <span class="en">Google Play Services</span></a> - </li> - <li><a href="<?cs var:toroot ?>guide/google/play/filters.html"> - <span class="en">Filters on Google Play</span></a> - </li> - <li><a href="<?cs var:toroot ?>guide/google/play/publishing/multiple-apks.html"> - <span class="en">Multiple APK Support</span></a> - </li> - <li><a href="<?cs var:toroot ?>guide/google/play/expansion-files.html"> - <span class="en">APK Expansion Files</span></a> - </li> - - <li class="nav-section"> - <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/google/gcm/index.html"> - <span class="en">Google Cloud Messaging</span></a> - </div> - <ul> - <li><a href="<?cs var:toroot?>guide/google/gcm/gs.html"> - <span class="en">Getting Started</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/gcm/gcm.html"> - <span class="en">Architectural Overview</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/gcm/demo.html"> - <span class="en">Demo App Tutorial</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/gcm/adv.html"> - <span class="en">Advanced Topics</span></a> - </li> - <li><a href="<?cs var:toroot?>guide/google/gcm/c2dm.html"> - <span class="en">Migration</span></a> - </li> - </ul> - </li> - - </ul> - </li><!-- end Google Play --> - - - <!-- this needs to move <li class="nav-section"> <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/practices/ui_guidelines/index.html"> diff --git a/docs/html/images/gps-analytics.png b/docs/html/images/gps-analytics.png Binary files differnew file mode 100644 index 0000000..7da0be1 --- /dev/null +++ b/docs/html/images/gps-analytics.png diff --git a/docs/html/images/gps-maps.png b/docs/html/images/gps-maps.png Binary files differnew file mode 100644 index 0000000..2e2a716 --- /dev/null +++ b/docs/html/images/gps-maps.png diff --git a/docs/html/images/gps-plus.png b/docs/html/images/gps-plus.png Binary files differnew file mode 100644 index 0000000..630ba0a --- /dev/null +++ b/docs/html/images/gps-plus.png diff --git a/docs/html/images/gps-small.png b/docs/html/images/gps-small.png Binary files differnew file mode 100644 index 0000000..790e483 --- /dev/null +++ b/docs/html/images/gps-small.png diff --git a/docs/html/images/gps.png b/docs/html/images/gps.png Binary files differnew file mode 100644 index 0000000..84d761d --- /dev/null +++ b/docs/html/images/gps.png diff --git a/docs/html/images/play-services-diagram.graffle/data.plist b/docs/html/images/play-services-diagram.graffle/data.plist new file mode 100644 index 0000000..837341c --- /dev/null +++ b/docs/html/images/play-services-diagram.graffle/data.plist @@ -0,0 +1,1020 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> +<plist version="1.0"> +<dict> + <key>ActiveLayerIndex</key> + <integer>0</integer> + <key>ApplicationVersion</key> + <array> + <string>com.omnigroup.OmniGrafflePro</string> + <string>138.33.0.157554</string> + </array> + <key>AutoAdjust</key> + <true/> + <key>BackgroundGraphic</key> + <dict> + <key>Bounds</key> + <string>{{0, 0}, {576, 733}}</string> + <key>Class</key> + <string>SolidGraphic</string> + <key>ID</key> + <integer>2</integer> + <key>Style</key> + <dict> + <key>shadow</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>stroke</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + </dict> + </dict> + <key>CanvasOrigin</key> + <string>{0, 0}</string> + <key>ColumnAlign</key> + <integer>1</integer> + <key>ColumnSpacing</key> + <real>36</real> + <key>CreationDate</key> + <string>2012-11-14 22:20:40 +0000</string> + <key>Creator</key> + <string>Robert Ly</string> + <key>DisplayScale</key> + <string>1 0/72 in = 1 0/72 in</string> + <key>FileType</key> + <string>auto</string> + <key>GraphDocumentVersion</key> + <integer>8</integer> + <key>GraphicsList</key> + <array> + <dict> + <key>Bounds</key> + <string>{{206.5, 311.05804}, {55, 24}}</string> + <key>Class</key> + <string>ShapedGraphic</string> + <key>FitText</key> + <string>YES</string> + <key>Flow</key> + <string>Resize</string> + <key>FontInfo</key> + <dict> + <key>Color</key> + <dict> + <key>a</key> + <string>0.65</string> + <key>w</key> + <string>0</string> + </dict> + <key>Font</key> + <string>DroidSans</string> + <key>Size</key> + <real>10</real> + </dict> + <key>ID</key> + <integer>199</integer> + <key>Line</key> + <dict> + <key>ID</key> + <integer>198</integer> + <key>Offset</key> + <real>-2</real> + <key>Position</key> + <real>0.59412848949432373</real> + <key>RotationType</key> + <integer>0</integer> + </dict> + <key>Magnets</key> + <array> + <string>{0, 1}</string> + <string>{0, -1}</string> + <string>{1, 0}</string> + <string>{-1, 0}</string> + </array> + <key>Shape</key> + <string>Rectangle</string> + <key>Style</key> + <dict> + <key>shadow</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>stroke</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + </dict> + <key>Text</key> + <dict> + <key>RTFD</key> + <data> + BAtzdHJlYW10eXBlZIHoA4QBQISEhBJOU0F0dHJpYnV0 + ZWRTdHJpbmcAhIQITlNPYmplY3QAhZKEhIQITlNTdHJp + bmcBlIQBKwdVcGRhdGVzhoQCaUkBB5KEhIQMTlNEaWN0 + aW9uYXJ5AJSEAWkDkoSWlgdOU0NvbG9yhpKEhIQHTlND + b2xvcgCUhAFjA4QCZmYAg2ZmJj+GkoSWlgZOU0ZvbnSG + koSEhAZOU0ZvbnQelJkchAVbMjhjXQYAAAAUAAAA//5I + AGUAbAB2AGUAdABpAGMAYQCEAWYMmwCbAZsAmwCGkoSW + lhBOU1BhcmFncmFwaFN0eWxlhpKEhIQQTlNQYXJhZ3Jh + cGhTdHlsZQCUhARDQ0BTAgCEhIQHTlNBcnJheQCUmQyS + hISECU5TVGV4dFRhYgCUhAJDZgAchpKEpaQAOIaShKWk + AFSGkoSlpABwhpKEpaQAgYwAhpKEpaQAgagAhpKEpaQA + gcQAhpKEpaQAgeAAhpKEpaQAgfwAhpKEpaQAgRgBhpKE + paQAgTQBhpKEpaQAgVABhoYAhoaG + </data> + <key>Text</key> + <string>{\rtf1\ansi\ansicpg1252\cocoartf1187\cocoasubrtf340 +\cocoascreenfonts1{\fonttbl\f0\fswiss\fcharset0 Helvetica;} +{\colortbl;\red255\green255\blue255;\red0\green0\blue0;} +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural\qc + +\f0\fs24 \cf2 Updates}</string> + <key>alpha</key> + <array> + <array> + <integer>0</integer> + <integer>7</integer> + <real>0.64999997615814209</real> + </array> + </array> + </dict> + <key>Wrap</key> + <string>NO</string> + </dict> + <dict> + <key>Class</key> + <string>LineGraphic</string> + <key>FontInfo</key> + <dict> + <key>Font</key> + <string>DroidSans</string> + <key>Size</key> + <real>11</real> + </dict> + <key>ID</key> + <integer>198</integer> + <key>OrthogonalBarAutomatic</key> + <false/> + <key>OrthogonalBarPoint</key> + <string>{0, 0}</string> + <key>OrthogonalBarPosition</key> + <real>4.1290435791015625</real> + <key>Points</key> + <array> + <string>{165.58636, 347.00049}</string> + <string>{232, 325}</string> + <string>{271, 300}</string> + </array> + <key>Style</key> + <dict> + <key>stroke</key> + <dict> + <key>Color</key> + <dict> + <key>a</key> + <string>0.7</string> + <key>b</key> + <string>0</string> + <key>g</key> + <string>0</string> + <key>r</key> + <string>0</string> + </dict> + <key>CornerRadius</key> + <real>4</real> + <key>HeadArrow</key> + <string>0</string> + <key>LineType</key> + <integer>2</integer> + <key>TailArrow</key> + <string>FilledArrow</string> + </dict> + </dict> + <key>Tail</key> + <dict> + <key>ID</key> + <integer>1800</integer> + </dict> + </dict> + <dict> + <key>Bounds</key> + <string>{{282.74756, 257.67365}, {273.33658, 82.000977}}</string> + <key>Class</key> + <string>ShapedGraphic</string> + <key>ID</key> + <integer>1806</integer> + <key>ImageID</key> + <integer>8</integer> + <key>Shape</key> + <string>Rectangle</string> + <key>Style</key> + <dict> + <key>fill</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>shadow</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>stroke</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + </dict> + </dict> + <dict> + <key>Class</key> + <string>LineGraphic</string> + <key>FontInfo</key> + <dict> + <key>Font</key> + <string>DroidSans</string> + <key>Size</key> + <real>11</real> + </dict> + <key>Head</key> + <dict> + <key>ID</key> + <integer>1800</integer> + <key>Info</key> + <integer>4</integer> + </dict> + <key>ID</key> + <integer>196</integer> + <key>OrthogonalBarAutomatic</key> + <false/> + <key>OrthogonalBarPoint</key> + <string>{0, 0}</string> + <key>OrthogonalBarPosition</key> + <real>4.1290435791015625</real> + <key>Points</key> + <array> + <string>{57.379539, 223}</string> + <string>{43.586342, 347.00049}</string> + </array> + <key>Style</key> + <dict> + <key>stroke</key> + <dict> + <key>Color</key> + <dict> + <key>a</key> + <string>0.7</string> + <key>b</key> + <string>0</string> + <key>g</key> + <string>0</string> + <key>r</key> + <string>0</string> + </dict> + <key>CornerRadius</key> + <real>4</real> + <key>HeadArrow</key> + <string>FilledArrow</string> + <key>LineType</key> + <integer>2</integer> + <key>TailArrow</key> + <string>0</string> + </dict> + </dict> + <key>Tail</key> + <dict> + <key>ID</key> + <integer>203</integer> + <key>Info</key> + <integer>4</integer> + </dict> + </dict> + <dict> + <key>Bounds</key> + <string>{{57.379539, 207}, {94.413635, 32}}</string> + <key>Class</key> + <string>ShapedGraphic</string> + <key>FontInfo</key> + <dict> + <key>Color</key> + <dict> + <key>a</key> + <string>0.65</string> + <key>w</key> + <string>0</string> + </dict> + <key>Font</key> + <string>DroidSans</string> + <key>Size</key> + <real>10</real> + </dict> + <key>ID</key> + <integer>203</integer> + <key>Magnets</key> + <array> + <string>{0, 1}</string> + <string>{0, -1}</string> + <string>{1, 0}</string> + <string>{-1, 0}</string> + </array> + <key>Shape</key> + <string>Rectangle</string> + <key>Style</key> + <dict> + <key>shadow</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>stroke</key> + <dict> + <key>Color</key> + <dict> + <key>b</key> + <string>0.578326</string> + <key>g</key> + <string>0.578615</string> + <key>r</key> + <string>0.578453</string> + </dict> + <key>CornerRadius</key> + <real>15</real> + <key>Pattern</key> + <integer>1</integer> + </dict> + </dict> + <key>Text</key> + <dict> + <key>RTFD</key> + <data> + BAtzdHJlYW10eXBlZIHoA4QBQISEhBJOU0F0dHJpYnV0 + ZWRTdHJpbmcAhIQITlNPYmplY3QAhZKEhIQITlNTdHJp + bmcBlIQBKw5DbGllbnQgTGlicmFyeYaEAmlJAQ6ShISE + DE5TRGljdGlvbmFyeQCUhAFpBJKElpYOTlNPcmlnaW5h + bEZvbnSGkoSEhAZOU0ZvbnQelJkchAVbMjhjXQYAAAAU + AAAA//5IAGUAbAB2AGUAdABpAGMAYQCEAWYMhAFjAJ0B + nQCdAIaShJaWEE5TUGFyYWdyYXBoU3R5bGWGkoSEhBdO + U011dGFibGVQYXJhZ3JhcGhTdHlsZQCEhBBOU1BhcmFn + cmFwaFN0eWxlAJSEBENDQFMCAIUAhpKElpYGTlNGb250 + hpKakoSWlgdOU0NvbG9yhpKEhIQHTlNDb2xvcgCUnQOE + AmZmAINmZiY/hoaG + </data> + <key>Text</key> + <string>{\rtf1\ansi\ansicpg1252\cocoartf1187\cocoasubrtf340 +\cocoascreenfonts1{\fonttbl\f0\fswiss\fcharset0 Helvetica;} +{\colortbl;\red255\green255\blue255;\red0\green0\blue0;} +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural\qc + +\f0\fs24 \cf2 Client Library}</string> + <key>VerticalPad</key> + <integer>10</integer> + <key>alpha</key> + <array> + <array> + <integer>0</integer> + <integer>14</integer> + <real>0.64999997615814209</real> + </array> + </array> + </dict> + <key>TextPlacement</key> + <integer>0</integer> + </dict> + <dict> + <key>Bounds</key> + <string>{{43.586342, 306}, {122.00003, 82.000977}}</string> + <key>Class</key> + <string>ShapedGraphic</string> + <key>FontInfo</key> + <dict> + <key>Color</key> + <dict> + <key>a</key> + <string>0.65</string> + <key>w</key> + <string>0</string> + </dict> + <key>Font</key> + <string>DroidSans-Bold</string> + <key>NSKern</key> + <real>0.0</real> + <key>Size</key> + <real>12</real> + </dict> + <key>ID</key> + <integer>1800</integer> + <key>Magnets</key> + <array> + <string>{0, 1}</string> + <string>{0, -1}</string> + <string>{1, 0}</string> + <string>{-1, 0}</string> + </array> + <key>Shape</key> + <string>Rectangle</string> + <key>Style</key> + <dict> + <key>fill</key> + <dict> + <key>Color</key> + <dict> + <key>b</key> + <string>0.938075</string> + <key>g</key> + <string>0.938269</string> + <key>r</key> + <string>0.938154</string> + </dict> + </dict> + <key>shadow</key> + <dict> + <key>Color</key> + <dict> + <key>a</key> + <string>0.45</string> + <key>b</key> + <string>0</string> + <key>g</key> + <string>0</string> + <key>r</key> + <string>0</string> + </dict> + <key>Draws</key> + <string>NO</string> + <key>Fuzziness</key> + <real>0.0</real> + <key>ShadowVector</key> + <string>{0.5, 2}</string> + </dict> + <key>stroke</key> + <dict> + <key>Color</key> + <dict> + <key>b</key> + <string>0.700224</string> + <key>g</key> + <string>0.700574</string> + <key>r</key> + <string>0.700377</string> + </dict> + <key>CornerRadius</key> + <real>3</real> + <key>Width</key> + <real>3</real> + </dict> + </dict> + <key>Text</key> + <dict> + <key>RTFD</key> + <data> + BAtzdHJlYW10eXBlZIHoA4QBQISEhBJOU0F0dHJpYnV0 + ZWRTdHJpbmcAhIQITlNPYmplY3QAhZKEhIQITlNTdHJp + bmcBlIQBKxlHb29nbGUgUGxheQpzZXJ2aWNlcyBBUEsK + hoQCaUkBGZKEhIQMTlNEaWN0aW9uYXJ5AJSEAWkDkoSW + lgdOU0NvbG9yhpKEhIQHTlNDb2xvcgCUhAFjA4QCZmYA + g2ZmJj+GkoSWlgZOU0ZvbnSGkoSEhAZOU0ZvbnQelJkc + hAVbMjhjXQYAAAAUAAAA//5IAGUAbAB2AGUAdABpAGMA + YQCEAWYMmwCbAZsAmwCGkoSWlhBOU1BhcmFncmFwaFN0 + eWxlhpKEhIQQTlNQYXJhZ3JhcGhTdHlsZQCUhARDQ0BT + AgCEhIQHTlNBcnJheQCUmQyShISECU5TVGV4dFRhYgCU + hAJDZgAchpKEpaQAOIaShKWkAFSGkoSlpABwhpKEpaQA + gYwAhpKEpaQAgagAhpKEpaQAgcQAhpKEpaQAgeAAhpKE + paQAgfwAhpKEpaQAgRgBhpKEpaQAgTQBhpKEpaQAgVAB + hoYAhoaG + </data> + <key>Text</key> + <string>{\rtf1\ansi\ansicpg1252\cocoartf1187\cocoasubrtf340 +\cocoascreenfonts1{\fonttbl\f0\fswiss\fcharset0 Helvetica;} +{\colortbl;\red255\green255\blue255;\red0\green0\blue0;} +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural\qc + +\f0\fs24 \cf2 Google Play\ +services APK\ +}</string> + <key>VerticalPad</key> + <integer>10</integer> + <key>alpha</key> + <array> + <array> + <integer>0</integer> + <integer>25</integer> + <real>0.64999997615814209</real> + </array> + </array> + </dict> + <key>TextPlacement</key> + <integer>2</integer> + </dict> + <dict> + <key>Bounds</key> + <string>{{43.586342, 195}, {122.00003, 82.000977}}</string> + <key>Class</key> + <string>ShapedGraphic</string> + <key>FontInfo</key> + <dict> + <key>Color</key> + <dict> + <key>a</key> + <string>0.65</string> + <key>w</key> + <string>0</string> + </dict> + <key>Font</key> + <string>DroidSans-Bold</string> + <key>NSKern</key> + <real>0.0</real> + <key>Size</key> + <real>12</real> + </dict> + <key>ID</key> + <integer>249</integer> + <key>Magnets</key> + <array> + <string>{0, 1}</string> + <string>{0, -1}</string> + <string>{1, 0}</string> + <string>{-1, 0}</string> + </array> + <key>Shape</key> + <string>Rectangle</string> + <key>Style</key> + <dict> + <key>fill</key> + <dict> + <key>Color</key> + <dict> + <key>b</key> + <string>0.938075</string> + <key>g</key> + <string>0.938269</string> + <key>r</key> + <string>0.938154</string> + </dict> + </dict> + <key>shadow</key> + <dict> + <key>Color</key> + <dict> + <key>a</key> + <string>0.45</string> + <key>b</key> + <string>0</string> + <key>g</key> + <string>0</string> + <key>r</key> + <string>0</string> + </dict> + <key>Draws</key> + <string>NO</string> + <key>Fuzziness</key> + <real>0.0</real> + <key>ShadowVector</key> + <string>{0.5, 2}</string> + </dict> + <key>stroke</key> + <dict> + <key>Color</key> + <dict> + <key>b</key> + <string>0.700224</string> + <key>g</key> + <string>0.700574</string> + <key>r</key> + <string>0.700377</string> + </dict> + <key>CornerRadius</key> + <real>3</real> + <key>Width</key> + <real>3</real> + </dict> + </dict> + <key>Text</key> + <dict> + <key>RTFD</key> + <data> + BAtzdHJlYW10eXBlZIHoA4QBQISEhBJOU0F0dHJpYnV0 + ZWRTdHJpbmcAhIQITlNPYmplY3QAhZKEhIQITlNTdHJp + bmcBlIQBKwhZb3VyIEFwcIaEAmlJAQiShISEDE5TRGlj + dGlvbmFyeQCUhAFpBJKElpYOTlNPcmlnaW5hbEZvbnSG + koSEhAZOU0ZvbnQelJkchAVbMjhjXQYAAAAUAAAA//5I + AGUAbAB2AGUAdABpAGMAYQCEAWYMhAFjAJ0BnQCdAIaS + hJaWEE5TUGFyYWdyYXBoU3R5bGWGkoSEhBdOU011dGFi + bGVQYXJhZ3JhcGhTdHlsZQCEhBBOU1BhcmFncmFwaFN0 + eWxlAJSEBENDQFMCAIUAhpKElpYGTlNGb250hpKakoSW + lgdOU0NvbG9yhpKEhIQHTlNDb2xvcgCUnQOEAmZmAINm + ZiY/hoaG + </data> + <key>Text</key> + <string>{\rtf1\ansi\ansicpg1252\cocoartf1187\cocoasubrtf340 +\cocoascreenfonts1{\fonttbl\f0\fswiss\fcharset0 Helvetica;} +{\colortbl;\red255\green255\blue255;\red0\green0\blue0;} +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural\qc + +\f0\fs24 \cf2 Your App}</string> + <key>VerticalPad</key> + <integer>10</integer> + <key>alpha</key> + <array> + <array> + <integer>0</integer> + <integer>8</integer> + <real>0.64999997615814209</real> + </array> + </array> + </dict> + <key>TextPlacement</key> + <integer>2</integer> + </dict> + <dict> + <key>Class</key> + <string>Group</string> + <key>Graphics</key> + <array> + <dict> + <key>Bounds</key> + <string>{{25.847038, 415.18762}, {157.43497, 20.991331}}</string> + <key>Class</key> + <string>ShapedGraphic</string> + <key>ID</key> + <integer>1795</integer> + <key>ImageID</key> + <integer>4</integer> + <key>Shape</key> + <string>Rectangle</string> + <key>Style</key> + <dict> + <key>fill</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>shadow</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>stroke</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + </dict> + </dict> + <dict> + <key>Bounds</key> + <string>{{167.76729, 156.73196}, {15.743497, 10.058347}}</string> + <key>Class</key> + <string>ShapedGraphic</string> + <key>FontInfo</key> + <dict> + <key>Font</key> + <string>Helvetica</string> + <key>Size</key> + <real>9</real> + </dict> + <key>ID</key> + <integer>1796</integer> + <key>Shape</key> + <string>Rectangle</string> + <key>Style</key> + <dict> + <key>fill</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>shadow</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>stroke</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + </dict> + <key>Text</key> + <dict> + <key>Align</key> + <integer>2</integer> + <key>Pad</key> + <integer>2</integer> + <key>RTFD</key> + <data> + BAtzdHJlYW10eXBlZIHoA4QBQISE + hBJOU0F0dHJpYnV0ZWRTdHJpbmcA + hIQITlNPYmplY3QAhZKEhIQITlNT + dHJpbmcBlIQBKwQyOjMwhoQCaUkB + BJKEhIQMTlNEaWN0aW9uYXJ5AJSE + AWkDkoSWlgdOU0NvbG9yhpKEhIQH + TlNDb2xvcgCUhAFjAoQEZmZmZoPO + zEw+g7a1NT+D5+VlPwGGkoSWlhBO + U1BhcmFncmFwaFN0eWxlhpKEhIQQ + TlNQYXJhZ3JhcGhTdHlsZQCUhARD + Q0BTAQCEhIQHTlNBcnJheQCUmQyS + hISECU5TVGV4dFRhYgCUhAJDZgAc + hpKEoqEAOIaShKKhAFSGkoSioQBw + hpKEoqEAgYwAhpKEoqEAgagAhpKE + oqEAgcQAhpKEoqEAgeAAhpKEoqEA + gfwAhpKEoqEAgRgBhpKEoqEAgTQB + hpKEoqEAgVABhoYAhpKElpYGTlNG + b250hpKEhIQGTlNGb250HpSZHIQF + WzI4Y10GAAAAFAAAAP/+SABlAGwA + dgBlAHQAaQBjAGEAhAFmCJsAmwGb + AJsAhoaG + </data> + <key>Text</key> + <string>{\rtf1\ansi\ansicpg1252\cocoartf1187\cocoasubrtf340 +\cocoascreenfonts1{\fonttbl\f0\fswiss\fcharset0 Helvetica;} +{\colortbl;\red255\green255\blue255;\red45\green166\blue222;} +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural\qr + +\f0\fs16 \cf2 2:30}</string> + <key>VerticalPad</key> + <integer>2</integer> + </dict> + <key>Wrap</key> + <string>NO</string> + </dict> + <dict> + <key>Bounds</key> + <string>{{25.847008, 156.29468}, {157.47868, 10.932985}}</string> + <key>Class</key> + <string>ShapedGraphic</string> + <key>ID</key> + <integer>1797</integer> + <key>ImageID</key> + <integer>3</integer> + <key>Shape</key> + <string>Rectangle</string> + <key>Style</key> + <dict> + <key>fill</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>shadow</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>stroke</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + </dict> + </dict> + <dict> + <key>Bounds</key> + <string>{{10.999992, 113}, {187.17274, 367.34827}}</string> + <key>Class</key> + <string>ShapedGraphic</string> + <key>ID</key> + <integer>1798</integer> + <key>ImageID</key> + <integer>5</integer> + <key>Shape</key> + <string>Rectangle</string> + <key>Style</key> + <dict> + <key>fill</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>shadow</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>stroke</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + </dict> + </dict> + <dict> + <key>Bounds</key> + <string>{{25.847038, 156.29462}, {157.43497, 279.8844}}</string> + <key>Class</key> + <string>ShapedGraphic</string> + <key>ID</key> + <integer>1799</integer> + <key>Shape</key> + <string>Rectangle</string> + <key>Style</key> + <dict> + <key>shadow</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + <key>stroke</key> + <dict> + <key>Draws</key> + <string>NO</string> + </dict> + </dict> + </dict> + </array> + <key>ID</key> + <integer>1794</integer> + </dict> + <dict> + <key>Bounds</key> + <string>{{269.83173, 246.96591}, {299.16827, 99.416443}}</string> + <key>Class</key> + <string>ShapedGraphic</string> + <key>ID</key> + <integer>4</integer> + <key>Shape</key> + <string>Rectangle</string> + <key>Style</key> + <dict> + <key>stroke</key> + <dict> + <key>CornerRadius</key> + <real>9</real> + </dict> + </dict> + </dict> + </array> + <key>GridInfo</key> + <dict/> + <key>GuidesLocked</key> + <string>NO</string> + <key>GuidesVisible</key> + <string>YES</string> + <key>HPages</key> + <integer>1</integer> + <key>ImageCounter</key> + <integer>9</integer> + <key>ImageLinkBack</key> + <array> + <dict/> + <dict/> + <dict/> + <dict/> + </array> + <key>ImageList</key> + <array> + <string>image8.tiff</string> + <string>image5.pdf</string> + <string>image4.png</string> + <string>image3.png</string> + </array> + <key>KeepToScale</key> + <false/> + <key>Layers</key> + <array> + <dict> + <key>Lock</key> + <string>NO</string> + <key>Name</key> + <string>Layer 1</string> + <key>Print</key> + <string>YES</string> + <key>View</key> + <string>YES</string> + </dict> + </array> + <key>LayoutInfo</key> + <dict> + <key>Animate</key> + <string>NO</string> + <key>circoMinDist</key> + <real>18</real> + <key>circoSeparation</key> + <real>0.0</real> + <key>layoutEngine</key> + <string>dot</string> + <key>neatoSeparation</key> + <real>0.0</real> + <key>twopiSeparation</key> + <real>0.0</real> + </dict> + <key>LinksVisible</key> + <string>NO</string> + <key>MagnetsVisible</key> + <string>NO</string> + <key>MasterSheets</key> + <array/> + <key>ModificationDate</key> + <string>2012-11-14 23:00:27 +0000</string> + <key>Modifier</key> + <string>Robert Ly</string> + <key>NotesVisible</key> + <string>NO</string> + <key>Orientation</key> + <integer>2</integer> + <key>OriginVisible</key> + <string>NO</string> + <key>PageBreaks</key> + <string>YES</string> + <key>PrintInfo</key> + <dict> + <key>NSBottomMargin</key> + <array> + <string>float</string> + <string>41</string> + </array> + <key>NSHorizonalPagination</key> + <array> + <string>int</string> + <string>0</string> + </array> + <key>NSLeftMargin</key> + <array> + <string>float</string> + <string>18</string> + </array> + <key>NSPaperSize</key> + <array> + <string>coded</string> + <string>BAtzdHJlYW10eXBlZIHoA4QBQISEhAdOU1ZhbHVlAISECE5TT2JqZWN0AIWEASqEhAx7X05TU2l6ZT1mZn2WgWQCgRgDhg==</string> + </array> + <key>NSPrintReverseOrientation</key> + <array> + <string>int</string> + <string>0</string> + </array> + <key>NSRightMargin</key> + <array> + <string>float</string> + <string>18</string> + </array> + <key>NSTopMargin</key> + <array> + <string>float</string> + <string>18</string> + </array> + </dict> + <key>PrintOnePage</key> + <false/> + <key>ReadOnly</key> + <string>NO</string> + <key>RowAlign</key> + <integer>1</integer> + <key>RowSpacing</key> + <real>36</real> + <key>SheetTitle</key> + <string>Canvas 1</string> + <key>SmartAlignmentGuidesActive</key> + <string>YES</string> + <key>SmartDistanceGuidesActive</key> + <string>YES</string> + <key>UniqueID</key> + <integer>1</integer> + <key>UseEntirePage</key> + <false/> + <key>VPages</key> + <integer>1</integer> + <key>WindowInfo</key> + <dict> + <key>CurrentSheet</key> + <integer>0</integer> + <key>ExpandedCanvases</key> + <array> + <dict> + <key>name</key> + <string>Canvas 1</string> + </dict> + </array> + <key>ListView</key> + <true/> + <key>OutlineWidth</key> + <integer>142</integer> + <key>RightSidebar</key> + <false/> + <key>ShowRuler</key> + <true/> + <key>Sidebar</key> + <true/> + <key>SidebarWidth</key> + <integer>120</integer> + <key>VisibleRegion</key> + <string>{{-392, -138}, {1359, 1010}}</string> + <key>Zoom</key> + <real>1</real> + <key>ZoomValues</key> + <array> + <array> + <string>Canvas 1</string> + <real>1</real> + <real>1</real> + </array> + </array> + </dict> + <key>saveQuickLookFiles</key> + <string>NO</string> +</dict> +</plist> diff --git a/docs/html/images/play-services-diagram.graffle/image3.png b/docs/html/images/play-services-diagram.graffle/image3.png Binary files differnew file mode 100644 index 0000000..87e38f9 --- /dev/null +++ b/docs/html/images/play-services-diagram.graffle/image3.png diff --git a/docs/html/images/play-services-diagram.graffle/image4.png b/docs/html/images/play-services-diagram.graffle/image4.png Binary files differnew file mode 100644 index 0000000..89a8bb3 --- /dev/null +++ b/docs/html/images/play-services-diagram.graffle/image4.png diff --git a/docs/html/images/play-services-diagram.graffle/image5.pdf b/docs/html/images/play-services-diagram.graffle/image5.pdf Binary files differnew file mode 100644 index 0000000..c2baa60 --- /dev/null +++ b/docs/html/images/play-services-diagram.graffle/image5.pdf diff --git a/docs/html/images/play-services-diagram.graffle/image8.tiff b/docs/html/images/play-services-diagram.graffle/image8.tiff Binary files differnew file mode 100644 index 0000000..c934b78 --- /dev/null +++ b/docs/html/images/play-services-diagram.graffle/image8.tiff diff --git a/docs/html/images/play-services-diagram.png b/docs/html/images/play-services-diagram.png Binary files differnew file mode 100644 index 0000000..09b9a69 --- /dev/null +++ b/docs/html/images/play-services-diagram.png diff --git a/docs/html/images/training/notifications-bigview.png b/docs/html/images/training/notifications-bigview.png Binary files differnew file mode 100644 index 0000000..83a5610 --- /dev/null +++ b/docs/html/images/training/notifications-bigview.png diff --git a/docs/html/images/training/notifications-normalview.png b/docs/html/images/training/notifications-normalview.png Binary files differnew file mode 100644 index 0000000..06ea970 --- /dev/null +++ b/docs/html/images/training/notifications-normalview.png diff --git a/docs/html/training/notify-user/build-notification.jd b/docs/html/training/notify-user/build-notification.jd new file mode 100644 index 0000000..ba66028 --- /dev/null +++ b/docs/html/training/notify-user/build-notification.jd @@ -0,0 +1,160 @@ +page.title=Building a Notification +parent.title=Notifying the User +parent.link=index.html + +trainingnavtop=true +next.title=Preserving Navigation when Starting an Activity +next.link=navigation.html + +@jd:body + +<div id="tb-wrapper"> +<div id="tb"> + +<!-- table of contents --> +<h2>This lesson teaches you to</h2> +<ol> + <li><a href="#builder">Create a Notification Builder</a></li> + <li><a href="#action">Define the Notification's Action</a></li> + <li><a href="#click">Set the Notification's Click Behavior</a></li> + <li><a href="#notify">Issue the Notification</a></li> +</ol> + +<!-- other docs (NOT javadocs) --> +<h2>You should also read</h2> + +<ul> + <li> + <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">Notifications</a> API Guide + </li> + <li> + <a href="{@docRoot}guide/components/intents-filters.html"> + Intents and Intent Filters + </a> + </li> + <li> + <a href="{@docRoot}design/patterns/notifications.html">Notifications</a> Design Guide + </li> +</ul> + + +</div> +</div> + + +<p>This lesson explains how to create and issue a notification.</p> + +<p>The examples in this class are based on the +{@link android.support.v4.app.NotificationCompat.Builder} class. +{@link android.support.v4.app.NotificationCompat.Builder} +is in the <a href="{@docRoot}">Support Library</a>. You should use +{@link android.support.v4.app.NotificationCompat} and its subclasses, +particularly {@link android.support.v4.app.NotificationCompat.Builder}, to +provide the best notification support for a wide range of platforms. </p> + +<h2 id="builder">Create a Notification Builder</h2> + +<p>When creating a notification, specify the UI content and actions with a +{@link android.support.v4.app.NotificationCompat.Builder} object. At bare minimum, +a {@link android.support.v4.app.NotificationCompat.Builder Builder} +object must include the following:</p> + +<ul> + <li> + A small icon, set by + {@link android.support.v4.app.NotificationCompat.Builder#setSmallIcon setSmallIcon()} + </li> + <li> + A title, set by + {@link android.support.v4.app.NotificationCompat.Builder#setContentTitle setContentTitle()} + </li> + <li> + Detail text, set by + {@link android.support.v4.app.NotificationCompat.Builder#setContentText setContentText()} + </li> +</ul> +<p> For example: </p> +<pre> +NotificationCompat.Builder mBuilder = + new NotificationCompat.Builder(this) + .setSmallIcon(R.drawable.notification_icon) + .setContentTitle("My notification") + .setContentText("Hello World!"); +</pre> + +<h2 id="action">Define the Notification's Action</h2> + + +<p>Although actions are optional, you should add at least one action to your +notification. An action takes users directly from the notification to an +{@link android.app.Activity} in your application, where they can look at the +event that caused the notification or do further work. Inside a notification, the action itself is +defined by a {@link android.app.PendingIntent} containing an {@link +android.content.Intent} that starts an {@link android.app.Activity} in your +application.</p> + +<p>How you construct the {@link android.app.PendingIntent} depends on what type +of {@link android.app.Activity} you're starting. When you start an {@link +android.app.Activity} from a notification, you must preserve the user's expected +navigation experience. In the snippet below, clicking the notification opens a +new activity that effectively extends the behavior of the notification. In this +case there is no need to create an artificial back stack (see +<a href="navigation.html">Preserving Navigation when Starting an Activity</a> for +more information):</p> + +<pre>Intent resultIntent = new Intent(this, ResultActivity.class); +... +// Because clicking the notification opens a new ("special") activity, there's +// no need to create an artificial back stack. +PendingIntent resultPendingIntent = + PendingIntent.getActivity( + this, + 0, + resultIntent, + PendingIntent.FLAG_UPDATE_CURRENT +); +</pre> + +<h2 id="click">Set the Notification's Click Behavior</h2> + +<p> +To associate the {@link android.app.PendingIntent} created in the previous +step with a gesture, call the appropriate method of {@link +android.support.v4.app.NotificationCompat.Builder}. For example, to start an +activity when the user clicks the notification text in the notification drawer, +add the {@link android.app.PendingIntent} by calling {@link +android.support.v4.app.NotificationCompat.Builder#setContentIntent +setContentIntent()}. For example:</p> + +<pre>PendingIntent resultPendingIntent; +... +mBuilder.setContentIntent(resultPendingIntent);</pre> + +<h2 id="notify">Issue the Notification</h2> + +<p>To issue the notification:</p> +<ul> +<li>Get an instance of {@link android.app.NotificationManager}.</li> + +<li>Use the {@link android.app.NotificationManager#notify notify()} method to issue the +notification. When you call {@link android.app.NotificationManager#notify notify()}, specify a notification ID. +You can use this ID to update the notification later on. This is described in more detail in +<a href="managing.html">Managing Notifications</a>.</li> + +<li>Call {@link +android.support.v4.app.NotificationCompat.Builder#build() build()}, which +returns a {@link android.app.Notification} object containing your +specifications.</li> + +<p>For example:</p> + +<pre> +// Sets an ID for the notification +int mNotificationId = 001; +// Gets an instance of the NotificationManager service +NotificationManager mNotifyMgr = + (NotificationManager) getSystemService(NOTIFICATION_SERVICE); +// Builds the notification and issues it. +mNotifyMgr.notify(mNotificationId, builder.build()); +</pre> + diff --git a/docs/html/training/notify-user/display-progress.jd b/docs/html/training/notify-user/display-progress.jd new file mode 100644 index 0000000..2b2b3ae --- /dev/null +++ b/docs/html/training/notify-user/display-progress.jd @@ -0,0 +1,182 @@ +page.title=Displaying Progress in a Notification +parent.title=Notifying the User +parent.link=index.html + +trainingnavtop=true +previous.title=Using Expanded Notification Styles +previous.link=expanded.html + +@jd:body + +<div id="tb-wrapper"> +<div id="tb"> + +<!-- table of contents --> +<h2>This lesson teaches you to</h2> +<ol> + <li><a href="#FixedProgress">Display a Fixed-duration progress Indicator</a></li> + <li><a href="#ActivityIndicator">Display a Continuing Activity Indicator</a></li> +</ol> + +<!-- other docs (NOT javadocs) --> +<h2>You should also read</h2> + +<ul> + <li> + <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">Notifications</a> API Guide + </li> + <li> + <a href="{@docRoot}guide/components/intents-filters.html"> + Intents and Intent Filters + </a> + </li> + <li> + <a href="{@docRoot}design/patterns/notifications.html">Notifications</a> Design Guide + </li> +</ul> + + +</div> +</div> + + + +<p> + Notifications can include an animated progress indicator that shows users the status + of an ongoing operation. If you can estimate how long the operation takes and how much of it + is complete at any time, use the "determinate" form of the indicator + (a progress bar). If you can't estimate the length of the operation, use the + "indeterminate" form of the indicator (an activity indicator). +</p> +<p> + Progress indicators are displayed with the platform's implementation of the + {@link android.widget.ProgressBar} class. +</p> +<p> + To use a progress indicator, call + {@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress()}. The + determinate and indeterminate forms are described in the following sections. +</p> +<!-- ------------------------------------------------------------------------------------------ --> +<h2 id="FixedProgress">Display a Fixed-duration Progress Indicator</h2> +<p> + To display a determinate progress bar, add the bar to your notification by calling + {@link android.support.v4.app.NotificationCompat.Builder#setProgress + setProgress(max, progress, false)} and then issue the notification. + The third argument is a boolean that indicates whether the + progress bar is indeterminate (<strong>true</strong>) or determinate (<strong>false</strong>). + As your operation proceeds, + increment <code>progress</code>, and update the notification. At the end of the operation, + <code>progress</code> should equal <code>max</code>. A common way to call + {@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress()} + is to set <code>max</code> to 100 and then increment <code>progress</code> as a + "percent complete" value for the operation. +</p> +<p> + You can either leave the progress bar showing when the operation is done, or remove it. In + either case, remember to update the notification text to show that the operation is complete. + To remove the progress bar, call + {@link android.support.v4.app.NotificationCompat.Builder#setProgress + setProgress(0, 0, false)}. For example: +</p> +<pre> +... +mNotifyManager = + (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); +mBuilder = new NotificationCompat.Builder(this); +mBuilder.setContentTitle("Picture Download") + .setContentText("Download in progress") + .setSmallIcon(R.drawable.ic_notification); +// Start a lengthy operation in a background thread +new Thread( + new Runnable() { + @Override + public void run() { + int incr; + // Do the "lengthy" operation 20 times + for (incr = 0; incr <= 100; incr+=5) { + // Sets the progress indicator to a max value, the + // current completion percentage, and "determinate" + // state + mBuilder.setProgress(100, incr, false); + // Displays the progress bar for the first time. + mNotifyManager.notify(0, mBuilder.build()); + // Sleeps the thread, simulating an operation + // that takes time + try { + // Sleep for 5 seconds + Thread.sleep(5*1000); + } catch (InterruptedException e) { + Log.d(TAG, "sleep failure"); + } + } + // When the loop is finished, updates the notification + mBuilder.setContentText("Download complete") + // Removes the progress bar + .setProgress(0,0,false); + mNotifyManager.notify(ID, mBuilder.build()); + } + } +// Starts the thread by calling the run() method in its Runnable +).start(); +</pre> +<p> + The resulting notifications are shown in figure 1. On the left side is a snapshot of the + notification during the operation; on the right side is a snapshot of it after the operation + has finished. +</p> +<img + id="figure1" + src="{@docRoot}images/ui/notifications/progress_bar_summary.png" + height="84" + alt="" /> +<p class="img-caption"> +<strong>Figure 1.</strong> The progress bar during and after the operation.</p> +<!-- ------------------------------------------------------------------------------------------ --> +<h2 id="ActivityIndicator">Display a Continuing Activity Indicator</h2> +<p> + To display a continuing (indeterminate) activity indicator, add it to your notification with + {@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress(0, 0, true)} + and issue the notification. The first two arguments are ignored, and the third argument + declares that the indicator is indeterminate. The result is an indicator + that has the same style as a progress bar, except that its animation is ongoing. +</p> +<p> + Issue the notification at the beginning of the operation. The animation will run until you + modify your notification. When the operation is done, call + {@link android.support.v4.app.NotificationCompat.Builder#setProgress + setProgress(0, 0, false)} and then update the notification to remove the activity indicator. + Always do this; otherwise, the animation will run even when the operation is complete. Also + remember to change the notification text to indicate that the operation is complete. +</p> +<p> + To see how continuing activity indicators work, refer to the preceding snippet. Locate the following lines: +</p> +<pre> +// Sets the progress indicator to a max value, the current completion +// percentage, and "determinate" state +mBuilder.setProgress(100, incr, false); +// Issues the notification +mNotifyManager.notify(0, mBuilder.build()); +</pre> +<p> + Replace the lines you've found with the following lines. Notice that the third parameter + in the {@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress()} + call is set to {@code true} to indicate that the progress bar is + indeterminate: +</p> +<pre> + // Sets an activity indicator for an operation of indeterminate length +mBuilder.setProgress(0, 0, true); +// Issues the notification +mNotifyManager.notify(0, mBuilder.build()); +</pre> +<p> + The resulting indicator is shown in figure 2: +</p> +<img + id="figure2" + src="{@docRoot}images/ui/notifications/activity_indicator.png" + height="99" + alt="" /> +<p class="img-caption"><strong>Figure 2.</strong> An ongoing activity indicator.</p> diff --git a/docs/html/training/notify-user/expanded.jd b/docs/html/training/notify-user/expanded.jd new file mode 100644 index 0000000..a3cc6ad --- /dev/null +++ b/docs/html/training/notify-user/expanded.jd @@ -0,0 +1,167 @@ +page.title=Using Big View Styles +Styles parent.title=Notifying the User +parent.link=index.html + +trainingnavtop=true +next.title=Displaying Progress in a Notification +next.link=display-progress.html + +@jd:body + +<div id="tb-wrapper"> +<div id="tb"> + +<!-- table of contents --> +<h2>This lesson teaches you to</h2> +<ol> + <li><a href="#activity">Set Up the Notification to Launch a New Activity</a></li> + <li><a href="#big-view">Construct the Big View</a></li> +</ol> + +<!-- other docs (NOT javadocs) --> +<h2>You should also read</h2> + +<ul> + <li> + <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">Notifications</a> API Guide + </li> + <li> + <a href="{@docRoot}guide/components/intents-filters.html"> + Intents and Intent Filters + </a> + </li> + <li> + <a href="{@docRoot}design/patterns/notifications.html">Notifications</a> Design Guide + </li> +</ul> + + +</div> +</div> + +<p>Notifications in the notification drawer appear in two main visual styles, +normal view and big view. The big view of a notification only appears when the +notification is expanded. This happens when the notification is at the top of +the drawer, or the user clicks the notification. </p> + +<p>Big views were introduced in +Android 4.1, and they're not supported on older devices. This lesson describes +how to incorporate big view notifications into your app while still providing +full functionality via the normal view. See the <a +href="{@docRoot}guide/topics/ui/notifiers/notifications.html#BigNotify"> +Notifications API guide</a> for more discussion of big views.</p> + +<p>Here is an example of a normal view: </p> + +<img src="{@docRoot}images/training/notifications-normalview.png" width="300" height="58" alt="normal view" /> + +<p class="img-caption"> + <strong>Figure 1.</strong> Normal view notification. +</p> + + +<p>Here is an example of a big view:</p> + +<img src="{@docRoot}images/training/notifications-bigview.png" width="300" height="143" alt="big view" /> +<p class="img-caption"> + <strong>Figure 2.</strong> Big view notification. +</p> + + +<p> In the sample application shown in this lesson, both the normal view and the +big view give users access to same functionality:</p> + +<ul> + <li>The ability to snooze or dismiss the notification.</li> + <li>A way to view the reminder text the user set as part of the timer.</li> +</ul> + +<p>The normal view provides these features through a new activity that launches +when the user clicks the notification. Keep this in mind as you design your notifications—first +provide the functionality in the normal view, since +this is how many users will interact with the notification.</p> + +<h2 id="activity">Set Up the Notification to Launch a New Activity</h2> + +<p>The sample application uses an {@link android.app.IntentService} subclass ({@code PingService}) +to construct and issue the notification.</p> + + +<p>In this snippet, the +{@link android.app.IntentService} method +{@link android.app.IntentService#onHandleIntent onHandleIntent()} specifies the new activity +that will be launched if the user +clicks the notification itself. The method +{@link android.support.v4.app.NotificationCompat.Builder#setContentIntent setContentIntent()} +defines a pending intent that should be fired when the user +clicks the notification, thereby launching the activity.</p> + +<pre>Intent resultIntent = new Intent(this, ResultActivity.class); +resultIntent.putExtra(CommonConstants.EXTRA_MESSAGE, msg); +resultIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | + Intent.FLAG_ACTIVITY_CLEAR_TASK); + +// Because clicking the notification launches a new ("special") activity, +// there's no need to create an artificial back stack. +PendingIntent resultPendingIntent = + PendingIntent.getActivity( + this, + 0, + resultIntent, + PendingIntent.FLAG_UPDATE_CURRENT +); + +// This sets the pending intent that should be fired when the user clicks the +// notification. Clicking the notification launches a new activity. +builder.setContentIntent(resultPendingIntent); +</pre> + +<h2 id="big-view">Construct the Big View</h2> + +<p>This snippet shows how to set up the buttons that will appear in the big view:</p> + +<pre> +// Sets up the Snooze and Dismiss action buttons that will appear in the +// big view of the notification. +Intent dismissIntent = new Intent(this, PingService.class); +dismissIntent.setAction(CommonConstants.ACTION_DISMISS); +PendingIntent piDismiss = PendingIntent.getService(this, 0, dismissIntent, 0); + +Intent snoozeIntent = new Intent(this, PingService.class); +snoozeIntent.setAction(CommonConstants.ACTION_SNOOZE); +PendingIntent piSnooze = PendingIntent.getService(this, 0, snoozeIntent, 0); +</pre> + +<p>This snippet shows how to construct the +{@link android.support.v4.app.NotificationCompat.Builder Builder} object. +It sets the style for the big +view to be "big text," and sets its content to be the reminder message. It uses +{@link android.support.v4.app.NotificationCompat.Builder#addAction addAction()} +to add the <strong>Snooze</strong> and <strong>Dismiss</strong> buttons (and +their associated pending intents) that will appear in the notification's +big view:</p> + +<pre>// Constructs the Builder object. +NotificationCompat.Builder builder = + new NotificationCompat.Builder(this) + .setSmallIcon(R.drawable.ic_stat_notification) + .setContentTitle(getString(R.string.notification)) + .setContentText(getString(R.string.ping)) + .setDefaults(Notification.DEFAULT_ALL) // requires VIBRATE permission + /* + * Sets the big view "big text" style and supplies the + * text (the user's reminder message) that will be displayed + * in the detail area of the expanded notification. + * These calls are ignored by the support library for + * pre-4.1 devices. + */ + .setStyle(new NotificationCompat.BigTextStyle() + .bigText(msg)) + .addAction (R.drawable.ic_stat_dismiss, + getString(R.string.dismiss), piDismiss) + .addAction (R.drawable.ic_stat_snooze, + getString(R.string.snooze), piSnooze); +</pre> + + + diff --git a/docs/html/training/notify-user/index.jd b/docs/html/training/notify-user/index.jd new file mode 100644 index 0000000..510f2c4 --- /dev/null +++ b/docs/html/training/notify-user/index.jd @@ -0,0 +1,102 @@ +page.title=Notifying the User +trainingnavtop=true +startpage=true +next.title=Build a Notification +next.link=build-notification.html + + +@jd:body +<div id="tb-wrapper"> +<div id="tb"> + +<!-- Required platform, tools, add-ons, devices, knowledge, etc. --> +<h2>Dependencies and prerequisites</h2> + +<ul> + <li>Android 1.6 (API Level 4) or higher</li> +</ul> +<h2>You should also read</h2> +<ul> + <li> + <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">Notifications</a> API Guide + </li> + <li> + <a href="{@docRoot}guide/components/intents-filters.html"> + Intents and Intent Filters + </a> + </li> + <li> + <a href="{@docRoot}design/patterns/notifications.html">Notifications</a> Design Guide + </li> +</ul> + +<h2>Try it out</h2> + +<div class="download-box"> + <a href="{@docRoot}shareables/training/NotifyUser.zip" +class="button">Download the sample</a> + <p class="filename">NotifyUser.zip</p> +</div> + +</div> +</div> + +<p> + A notification is a user interface element that you display outside your app's normal UI to indicate + that an event has occurred. Users can choose to view the notification while using other apps and respond + to it when it's convenient for them. + +</p> + +<p> + The <a href="{@docRoot}design/patterns/notifications.html">Notifications design guide</a> shows + you how to design effective notifications and when to use them. This class shows you how to + implement the most common notification designs. +</p> +<h2>Lessons</h2> + +<dl> + <dt> + <strong><a href="build-notification.html">Building a Notification</a></strong> + </dt> + <dd> + Learn how to create a notification + {@link android.support.v4.app.NotificationCompat.Builder Builder}, set the + required features, and issue the notification. + </dd> + <dt> + <strong><a href="navigation.html">Preserving Navigation when Starting an Activity</a></strong> + </dt> + <dd> + Learn how to enforce the proper + navigation for an {@link android.app.Activity} started from a notification. + </dd> + <dt> + <strong> + <a href="managing.html">Updating Notifications</a> + </strong> + </dt> + <dd> + Learn how to update and remove notifications. + </dd> + <dt> + <strong> + <a href="expanded.html">Using Big View Styles</a> + </strong> + </dt> + <dd> + Learn how to create a big view within an expanded notification, while still maintaining + backward compatibility. + </dd> + + <dt> + <strong> + <a href="display-progress.html">Displaying Progress in a Notification</a> + </strong> + </dt> + <dd> + Learn how to display the progress of an operation in a notification, both for + operations where you can estimate how much has been completed (determinate progress) and + operations where you don't know how much has been completed (indefinite progress). + </dd> +</dl> diff --git a/docs/html/training/notify-user/managing.jd b/docs/html/training/notify-user/managing.jd new file mode 100644 index 0000000..4782734 --- /dev/null +++ b/docs/html/training/notify-user/managing.jd @@ -0,0 +1,107 @@ +page.title=Updating Notifications +parent.title=Notifying the User +parent.link=index.html + +trainingnavtop=true +next.title=Creating Expanded Notifications +next.link=expanded.html + +@jd:body + +<div id="tb-wrapper"> +<div id="tb"> + +<!-- table of contents --> +<h2>This lesson teaches you to</h2> +<ol> + <li><a href="#Updating">Modify a Notification</a></li> + <li><a href="#Removing">Remove Notifications</a></li> +</ol> + +<!-- other docs (NOT javadocs) --> +<h2>You should also read</h2> + +<ul> + <li> + <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">Notifications</a> API Guide + </li> + <li> + <a href="{@docRoot}guide/components/intents-filters.html"> + Intents and Intent Filters + </a> + </li> + <li> + <a href="{@docRoot}design/patterns/notifications.html">Notifications</a> Design Guide + </li> +</ul> + + +</div> +</div> +<p> + When you need to issue a notification multiple times for the same type of event, you + should avoid making a completely new notification. Instead, you should consider updating a + previous notification, either by changing some of its values or by adding to it, or both. +</p> + +<p> + The following section describes how to update notifications and also how to remove them. +</p> +<h2 id="Updating">Modify a Notification</h2> +<p> + To set up a notification so it can be updated, issue it with a notification ID by + calling {@link android.app.NotificationManager#notify(int, Notification) + NotificationManager.notify(ID, notification)}. To update this notification once you've issued + it, update or create a {@link android.support.v4.app.NotificationCompat.Builder} object, + build a {@link android.app.Notification} object from it, and issue the + {@link android.app.Notification} with the same ID you used previously. +</p> +<p> + The following snippet demonstrates a notification that is updated to reflect the + number of events that have occurred. It stacks the notification, showing a summary: +</p> +<pre> +mNotificationManager = + (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); +// Sets an ID for the notification, so it can be updated +int notifyID = 1; +mNotifyBuilder = new NotificationCompat.Builder(this) + .setContentTitle("New Message") + .setContentText("You've received new messages.") + .setSmallIcon(R.drawable.ic_notify_status) +numMessages = 0; +// Start of a loop that processes data and then notifies the user +... + mNotifyBuilder.setContentText(currentText) + .setNumber(++numMessages); + // Because the ID remains unchanged, the existing notification is + // updated. + mNotificationManager.notify( + notifyID, + mNotifyBuilder.build()); +... +</pre> + +<!-- ------------------------------------------------------------------------------------------ --> +<h2 id="Removing">Remove Notifications</h2> +<p> + Notifications remain visible until one of the following happens: +</p> +<ul> + <li> + The user dismisses the notification either individually or by using "Clear All" (if + the notification can be cleared). + </li> + <li> + The user touches the notification, and you called + {@link android.support.v4.app.NotificationCompat.Builder#setAutoCancel setAutoCancel()} when + you created the notification. + </li> + <li> + You call {@link android.app.NotificationManager#cancel(int) cancel()} for a specific + notification ID. This method also deletes ongoing notifications. + </li> + <li> + You call {@link android.app.NotificationManager#cancelAll() cancelAll()}, which removes + all of the notifications you previously issued. + </li> diff --git a/docs/html/training/notify-user/navigation.jd b/docs/html/training/notify-user/navigation.jd new file mode 100644 index 0000000..ac4689a --- /dev/null +++ b/docs/html/training/notify-user/navigation.jd @@ -0,0 +1,228 @@ +page.title=Preserving Navigation when Starting an Activity +parent.title=Notifying the User +parent.link=index.html + +trainingnavtop=true +next.title=Updating Notifications +next.link=managing.html + +@jd:body + +<div id="tb-wrapper"> +<div id="tb"> + +<!-- table of contents --> +<h2>This lesson teaches you to</h2> +<ol> + <li><a href="#DirectEntry">Set up a regular activity PendingIntent</a></li> + <li><a href="#ExtendedNotification">Set up a special activity PendingIntent</a></li> +</ol> + +<!-- other docs (NOT javadocs) --> +<h2>You should also read</h2> + +<ul> + <li> + <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">Notifications</a> API Guide + </li> + <li> + <a href="{@docRoot}guide/components/intents-filters.html"> + Intents and Intent Filters + </a> + </li> + <li> + <a href="{@docRoot}design/patterns/notifications.html">Notifications</a> Design Guide + </li> +</ul> + + +</div> +</div> +<p> + Part of designing a notification is preserving the user's expected navigation experience. + For a detailed discussion of this topic, see the + <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html#NotificationResponse">Notifications</a> + API guide. + There are two general situations: +</p> +<dl> + <dt> + Regular activity + </dt> + <dd> + You're starting an {@link android.app.Activity} that's part of the application's normal + workflow. + </dd> + <dt> + Special activity + </dt> + <dd> + The user only sees this {@link android.app.Activity} if it's started from a notification. + In a sense, the {@link android.app.Activity} extends the notification by providing + information that would be hard to display in the notification itself. + </dd> +</dl> +<!-- ------------------------------------------------------------------------------------------ --> +<h2 id="DirectEntry">Set Up a Regular Activity PendingIntent</h2> +<p> + To set up a {@link android.app.PendingIntent} that starts a direct entry + {@link android.app.Activity}, follow these steps: +</p> +<ol> + <li> + Define your application's {@link android.app.Activity} hierarchy in the manifest. The final XML should look like this: + </p> +<pre> +<activity + android:name=".MainActivity" + android:label="@string/app_name" > + <intent-filter> + <action android:name="android.intent.action.MAIN" /> + <category android:name="android.intent.category.LAUNCHER" /> + </intent-filter> +</activity> +<activity + android:name=".ResultActivity" + android:parentActivityName=".MainActivity"> + <meta-data + android:name="android.support.PARENT_ACTIVITY" + android:value=".MainActivity"/> +</activity> +</pre> + </li> + <li> + Create a back stack based on the {@link android.content.Intent} that starts the + {@link android.app.Activity}. For example: +</p> +<pre> +... +Intent resultIntent = new Intent(this, ResultActivity.class); +TaskStackBuilder stackBuilder = TaskStackBuilder.create(this); +// Adds the back stack +stackBuilder.addParentStack(ResultActivity.class); +// Adds the Intent to the top of the stack +stackBuilder.addNextIntent(resultIntent); +// Gets a PendingIntent containing the entire back stack +PendingIntent resultPendingIntent = + stackBuilder.getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT); +... +NotificationCompat.Builder builder = new NotificationCompat.Builder(this); +builder.setContentIntent(resultPendingIntent); +NotificationManager mNotificationManager = + (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); +mNotificationManager.notify(id, builder.build()); +</pre> +<!-- ------------------------------------------------------------------------------------------ --> +<h2 id="ExtendedNotification">Set Up a Special Activity PendingIntent</h2> + +<p> + A special {@link android.app.Activity} doesn't need a back stack, so you don't have to + define its {@link android.app.Activity} hierarchy in the manifest, and you don't have + to call + {@link android.support.v4.app.TaskStackBuilder#addParentStack addParentStack()} to build a + back stack. Instead, use the manifest to set up the {@link android.app.Activity} task options, + and create the {@link android.app.PendingIntent} by calling + {@link android.app.PendingIntent#getActivity getActivity()}: +</p> +<ol> + <li> + In your manifest, add the following attributes to the +<code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code> + element for the {@link android.app.Activity}: + <dl> + <dt> +<code><a href="{@docRoot}guide/topics/manifest/activity-element.html#nm">android:name</a>="<i>activityclass</i>"</code> + </dt> + <dd> + The activity's fully-qualified class name. + </dd> + <dt> +<code><a href="{@docRoot}guide/topics/manifest/activity-element.html#aff">android:taskAffinity</a>=""</code> + </dt> + <dd> + Combined with the + {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK FLAG_ACTIVITY_NEW_TASK} flag + that you set in code, this ensures that this {@link android.app.Activity} doesn't + go into the application's default task. Any existing tasks that have the + application's default affinity are not affected. + </dd> + <dt> +<code><a href="{@docRoot}guide/topics/manifest/activity-element.html#exclude">android:excludeFromRecents</a>="true"</code> + </dt> + <dd> + Excludes the new task from <i>Recents</i>, so that the user can't accidentally + navigate back to it. + </dd> + </dl> + <p> + This snippet shows the element: + </p> +<pre> +<activity + android:name=".ResultActivity" +... + android:launchMode="singleTask" + android:taskAffinity="" + android:excludeFromRecents="true"> +</activity> +... +</pre> + </li> + <li> + Build and issue the notification: + <ol style="list-style-type: lower-alpha;"> + <li> + Create an {@link android.content.Intent} that starts the + {@link android.app.Activity}. + </li> + <li> + Set the {@link android.app.Activity} to start in a new, empty task by calling + {@link android.content.Intent#setFlags setFlags()} with the flags + {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK FLAG_ACTIVITY_NEW_TASK} + and + {@link android.content.Intent#FLAG_ACTIVITY_CLEAR_TASK FLAG_ACTIVITY_CLEAR_TASK}. + </li> + <li> + Set any other options you need for the {@link android.content.Intent}. + </li> + <li> + Create a {@link android.app.PendingIntent} from the {@link android.content.Intent} + by calling {@link android.app.PendingIntent#getActivity getActivity()}. + You can then use this {@link android.app.PendingIntent} as the argument to + {@link android.support.v4.app.NotificationCompat.Builder#setContentIntent + setContentIntent()}. + </li> + </ol> + <p> + The following code snippet demonstrates the process: + </p> +<pre> +// Instantiate a Builder object. +NotificationCompat.Builder builder = new NotificationCompat.Builder(this); +// Creates an Intent for the Activity +Intent notifyIntent = + new Intent(new ComponentName(this, ResultActivity.class)); +// Sets the Activity to start in a new, empty task +notifyIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | + Intent.FLAG_ACTIVITY_CLEAR_TASK); +// Creates the PendingIntent +PendingIntent notifyIntent = + PendingIntent.getActivity( + this, + 0, + notifyIntent, + PendingIntent.FLAG_UPDATE_CURRENT +); + +// Puts the PendingIntent into the notification builder +builder.setContentIntent(notifyIntent); +// Notifications are issued by sending them to the +// NotificationManager system service. +NotificationManager mNotificationManager = + (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); +// Builds an anonymous Notification object from the builder, and +// passes it to the NotificationManager +mNotificationManager.notify(id, builder.build()); +</pre> + </li> +</ol> diff --git a/docs/html/training/training_toc.cs b/docs/html/training/training_toc.cs index abce37a..88ecaec 100644 --- a/docs/html/training/training_toc.cs +++ b/docs/html/training/training_toc.cs @@ -417,7 +417,6 @@ </li> </ul> </li> - <li class="nav-section"> <div class="nav-section-header"> <a href="<?cs var:toroot ?>training/efficient-downloads/index.html" @@ -601,6 +600,66 @@ </li> </ul> </li> + + <li class="nav-section"> + <div class="nav-section-header"> + <a href="<?cs var:toroot ?>training/notify-user/index.html" + description= + "How to display messages called notifications outside of + your application's UI." + >Notifying the User</a> + </div> + <ul> + <li> + <a href="<?cs var:toroot ?>training/notify-user/build-notification.html"> + Building a Notification + </a> + </li> + <li> + <a href="<?cs var:toroot ?>training/notify-user/navigation.html"> + Preserving Navigation when Starting an Activity + </a> + </li> + <li> + <a href="<?cs var:toroot ?>training/notify-user/managing.html"> + Updating Notifications + </a> + </li> + <li> + <a href="<?cs var:toroot ?>training/notify-user/expanded.html"> + Using Big View Styles + </a> + </li> + <li> + <a href="<?cs var:toroot ?>training/notify-user/display-progress.html"> + Displaying Progress in a Notification + </a> + </li> + </ul> + </li> + + <li class="nav-section"> + <div class="nav-section-header"> + <a href="<?cs var:toroot ?>training/search/index.html" + description= + "How to properly add a search interface to your app and create a searchable database." + >Adding Search Functionality</a> + </div> + <ul> + <li><a href="<?cs var:toroot ?>training/search/setup.html"> + Setting up the Search Interface + </a> + </li> + <li><a href="<?cs var:toroot ?>training/search/search.html"> + Storing and Searching for Data + </a> + </li> + <li><a href="<?cs var:toroot ?>training/search/backward-compat.html"> + Remaining Backward Compatible + </a> + </li> + </ul> + </li> <li class="nav-section"> @@ -660,29 +719,6 @@ </li> </ul> </li> - - <li class="nav-section"> - <div class="nav-section-header"> - <a href="<?cs var:toroot ?>training/search/index.html" - description= - "How to properly add a search interface to your app and create a searchable database." - >Adding Search Functionality</a> - </div> - <ul> - <li><a href="<?cs var:toroot ?>training/search/setup.html"> - Setting up the Search Interface - </a> - </li> - <li><a href="<?cs var:toroot ?>training/search/search.html"> - Storing and Searching for Data - </a> - </li> - <li><a href="<?cs var:toroot ?>training/search/backward-compat.html"> - Remaining Backward Compatible - </a> - </li> - </ul> - </li> <li class="nav-section"> <div class="nav-section-header"> diff --git a/graphics/jni/android_renderscript_RenderScript.cpp b/graphics/jni/android_renderscript_RenderScript.cpp index 3f642e8..eddd3c0 100644 --- a/graphics/jni/android_renderscript_RenderScript.cpp +++ b/graphics/jni/android_renderscript_RenderScript.cpp @@ -567,7 +567,7 @@ nAllocationCopyFromBitmap(JNIEnv *_env, jobject _this, RsContext con, jint alloc const void* ptr = bitmap.getPixels(); rsAllocation2DData(con, (RsAllocation)alloc, 0, 0, 0, RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X, - w, h, ptr, bitmap.getSize()); + w, h, ptr, bitmap.getSize(), 0); bitmap.unlockPixels(); } @@ -650,7 +650,7 @@ nAllocationData2D_s(JNIEnv *_env, jobject _this, RsContext con, jint alloc, jint jint len = _env->GetArrayLength(data); LOG_API("nAllocation2DData_s, con(%p), adapter(%p), xoff(%i), yoff(%i), w(%i), h(%i), len(%i)", con, (RsAllocation)alloc, xoff, yoff, w, h, len); jshort *ptr = _env->GetShortArrayElements(data, NULL); - rsAllocation2DData(con, (RsAllocation)alloc, xoff, yoff, lod, (RsAllocationCubemapFace)face, w, h, ptr, sizeBytes); + rsAllocation2DData(con, (RsAllocation)alloc, xoff, yoff, lod, (RsAllocationCubemapFace)face, w, h, ptr, sizeBytes, 0); _env->ReleaseShortArrayElements(data, ptr, JNI_ABORT); } @@ -661,7 +661,7 @@ nAllocationData2D_b(JNIEnv *_env, jobject _this, RsContext con, jint alloc, jint jint len = _env->GetArrayLength(data); LOG_API("nAllocation2DData_b, con(%p), adapter(%p), xoff(%i), yoff(%i), w(%i), h(%i), len(%i)", con, (RsAllocation)alloc, xoff, yoff, w, h, len); jbyte *ptr = _env->GetByteArrayElements(data, NULL); - rsAllocation2DData(con, (RsAllocation)alloc, xoff, yoff, lod, (RsAllocationCubemapFace)face, w, h, ptr, sizeBytes); + rsAllocation2DData(con, (RsAllocation)alloc, xoff, yoff, lod, (RsAllocationCubemapFace)face, w, h, ptr, sizeBytes, 0); _env->ReleaseByteArrayElements(data, ptr, JNI_ABORT); } @@ -672,7 +672,7 @@ nAllocationData2D_i(JNIEnv *_env, jobject _this, RsContext con, jint alloc, jint jint len = _env->GetArrayLength(data); LOG_API("nAllocation2DData_i, con(%p), adapter(%p), xoff(%i), yoff(%i), w(%i), h(%i), len(%i)", con, (RsAllocation)alloc, xoff, yoff, w, h, len); jint *ptr = _env->GetIntArrayElements(data, NULL); - rsAllocation2DData(con, (RsAllocation)alloc, xoff, yoff, lod, (RsAllocationCubemapFace)face, w, h, ptr, sizeBytes); + rsAllocation2DData(con, (RsAllocation)alloc, xoff, yoff, lod, (RsAllocationCubemapFace)face, w, h, ptr, sizeBytes, 0); _env->ReleaseIntArrayElements(data, ptr, JNI_ABORT); } @@ -683,7 +683,7 @@ nAllocationData2D_f(JNIEnv *_env, jobject _this, RsContext con, jint alloc, jint jint len = _env->GetArrayLength(data); LOG_API("nAllocation2DData_i, con(%p), adapter(%p), xoff(%i), yoff(%i), w(%i), h(%i), len(%i)", con, (RsAllocation)alloc, xoff, yoff, w, h, len); jfloat *ptr = _env->GetFloatArrayElements(data, NULL); - rsAllocation2DData(con, (RsAllocation)alloc, xoff, yoff, lod, (RsAllocationCubemapFace)face, w, h, ptr, sizeBytes); + rsAllocation2DData(con, (RsAllocation)alloc, xoff, yoff, lod, (RsAllocationCubemapFace)face, w, h, ptr, sizeBytes, 0); _env->ReleaseFloatArrayElements(data, ptr, JNI_ABORT); } diff --git a/packages/SystemUI/src/com/android/systemui/recent/RecentTasksLoader.java b/packages/SystemUI/src/com/android/systemui/recent/RecentTasksLoader.java index 4338fa0..9281c75 100644 --- a/packages/SystemUI/src/com/android/systemui/recent/RecentTasksLoader.java +++ b/packages/SystemUI/src/com/android/systemui/recent/RecentTasksLoader.java @@ -138,6 +138,10 @@ public class RecentTasksLoader implements View.OnTouchListener { return mLoadedTasks; } + public void remove(TaskDescription td) { + mLoadedTasks.remove(td); + } + public boolean isFirstScreenful() { return mFirstScreenful; } diff --git a/packages/SystemUI/src/com/android/systemui/recent/RecentsHorizontalScrollView.java b/packages/SystemUI/src/com/android/systemui/recent/RecentsHorizontalScrollView.java index 6cb7dec..3330301 100644 --- a/packages/SystemUI/src/com/android/systemui/recent/RecentsHorizontalScrollView.java +++ b/packages/SystemUI/src/com/android/systemui/recent/RecentsHorizontalScrollView.java @@ -336,19 +336,6 @@ public class RecentsHorizontalScrollView extends HorizontalScrollView }); } - @Override - protected void onVisibilityChanged(View changedView, int visibility) { - super.onVisibilityChanged(changedView, visibility); - // scroll to bottom after reloading - if (visibility == View.VISIBLE && changedView == this) { - post(new Runnable() { - public void run() { - update(); - } - }); - } - } - public void setAdapter(TaskDescriptionAdapter adapter) { mAdapter = adapter; mAdapter.registerDataSetObserver(new DataSetObserver() { diff --git a/packages/SystemUI/src/com/android/systemui/recent/RecentsPanelView.java b/packages/SystemUI/src/com/android/systemui/recent/RecentsPanelView.java index cd3bc42..9a1e38d 100644 --- a/packages/SystemUI/src/com/android/systemui/recent/RecentsPanelView.java +++ b/packages/SystemUI/src/com/android/systemui/recent/RecentsPanelView.java @@ -77,9 +77,10 @@ public class RecentsPanelView extends FrameLayout implements OnItemClickListener private boolean mShowing; private boolean mWaitingToShow; - private int mNumItemsWaitingForThumbnailsAndIcons; private ViewHolder mItemToAnimateInWhenWindowAnimationIsFinished; + private boolean mAnimateIconOfFirstTask; private boolean mWaitingForWindowAnimation; + private long mWindowAnimationStartTime; private RecentTasksLoader mRecentTasksLoader; private ArrayList<TaskDescription> mRecentTaskDescriptions; @@ -174,10 +175,9 @@ public class RecentsPanelView extends FrameLayout implements OnItemClickListener if (td.isLoaded()) { updateThumbnail(holder, td.getThumbnail(), true, false); updateIcon(holder, td.getIcon(), true, false); - mNumItemsWaitingForThumbnailsAndIcons--; } if (index == 0) { - if (mWaitingForWindowAnimation) { + if (mAnimateIconOfFirstTask) { if (mItemToAnimateInWhenWindowAnimationIsFinished != null) { holder.iconView.setAlpha(1f); holder.iconView.setTranslationX(0f); @@ -206,6 +206,9 @@ public class RecentsPanelView extends FrameLayout implements OnItemClickListener holder.iconView.setAlpha(0f); holder.iconView.setTranslationY(translation); } + if (!mWaitingForWindowAnimation) { + animateInIconOfFirstTask(); + } } } @@ -220,7 +223,9 @@ public class RecentsPanelView extends FrameLayout implements OnItemClickListener updateThumbnail(holder, mRecentTasksLoader.getDefaultThumbnail(), false, false); holder.iconView.setImageBitmap(mRecentTasksLoader.getDefaultIcon()); holder.iconView.setVisibility(INVISIBLE); + holder.iconView.animate().cancel(); holder.labelView.setText(null); + holder.labelView.animate().cancel(); holder.thumbnailView.setContentDescription(null); holder.thumbnailView.setTag(null); holder.thumbnailView.setOnLongClickListener(null); @@ -235,6 +240,7 @@ public class RecentsPanelView extends FrameLayout implements OnItemClickListener holder.calloutLine.setAlpha(1f); holder.calloutLine.setTranslationX(0f); holder.calloutLine.setTranslationY(0f); + holder.calloutLine.animate().cancel(); } holder.taskDescription = null; holder.loadedThumbnailAndIcon = false; @@ -291,8 +297,9 @@ public class RecentsPanelView extends FrameLayout implements OnItemClickListener } public void show(boolean show, ArrayList<TaskDescription> recentTaskDescriptions, - boolean firstScreenful, boolean waitingForWindowAnimation) { - mWaitingForWindowAnimation = waitingForWindowAnimation; + boolean firstScreenful, boolean animateIconOfFirstTask) { + mAnimateIconOfFirstTask = animateIconOfFirstTask; + mWaitingForWindowAnimation = animateIconOfFirstTask; if (show) { mWaitingToShow = true; refreshRecentTasksList(recentTaskDescriptions, firstScreenful); @@ -527,7 +534,6 @@ public class RecentsPanelView extends FrameLayout implements OnItemClickListener updateIcon(h, td.getIcon(), true, animateShow); updateThumbnail(h, td.getThumbnail(), true, animateShow); h.loadedThumbnailAndIcon = true; - mNumItemsWaitingForThumbnailsAndIcons--; } } } @@ -536,9 +542,14 @@ public class RecentsPanelView extends FrameLayout implements OnItemClickListener showIfReady(); } - public void onWindowAnimationStart() { - if (mItemToAnimateInWhenWindowAnimationIsFinished != null) { - final int startDelay = 150; + private void animateInIconOfFirstTask() { + if (mItemToAnimateInWhenWindowAnimationIsFinished != null && + !mRecentTasksLoader.isFirstScreenful()) { + int timeSinceWindowAnimation = + (int) (System.currentTimeMillis() - mWindowAnimationStartTime); + final int minStartDelay = 150; + final int startDelay = Math.max(0, Math.min( + minStartDelay - timeSinceWindowAnimation, minStartDelay)); final int duration = 250; final ViewHolder holder = mItemToAnimateInWhenWindowAnimationIsFinished; final TimeInterpolator cubic = new DecelerateInterpolator(1.5f); @@ -550,10 +561,16 @@ public class RecentsPanelView extends FrameLayout implements OnItemClickListener } } mItemToAnimateInWhenWindowAnimationIsFinished = null; - mWaitingForWindowAnimation = false; + mAnimateIconOfFirstTask = false; } } + public void onWindowAnimationStart() { + mWaitingForWindowAnimation = false; + mWindowAnimationStartTime = System.currentTimeMillis(); + animateInIconOfFirstTask(); + } + public void clearRecentTasksList() { // Clear memory used by screenshots if (mRecentTaskDescriptions != null) { @@ -590,9 +607,6 @@ public class RecentsPanelView extends FrameLayout implements OnItemClickListener } public void onTasksLoaded(ArrayList<TaskDescription> tasks, boolean firstScreenful) { - mNumItemsWaitingForThumbnailsAndIcons = firstScreenful - ? tasks.size() : mRecentTaskDescriptions == null - ? 0 : mRecentTaskDescriptions.size(); if (mRecentTaskDescriptions == null) { mRecentTaskDescriptions = new ArrayList<TaskDescription>(tasks); } else { @@ -689,6 +703,7 @@ public class RecentsPanelView extends FrameLayout implements OnItemClickListener } if (DEBUG) Log.v(TAG, "Jettison " + ad.getLabel()); mRecentTaskDescriptions.remove(ad); + mRecentTasksLoader.remove(ad); // Handled by widget containers to enable LayoutTransitions properly // mListAdapter.notifyDataSetChanged(); diff --git a/packages/SystemUI/src/com/android/systemui/recent/RecentsVerticalScrollView.java b/packages/SystemUI/src/com/android/systemui/recent/RecentsVerticalScrollView.java index 47b0113..b3adbaf 100644 --- a/packages/SystemUI/src/com/android/systemui/recent/RecentsVerticalScrollView.java +++ b/packages/SystemUI/src/com/android/systemui/recent/RecentsVerticalScrollView.java @@ -345,19 +345,6 @@ public class RecentsVerticalScrollView extends ScrollView }); } - @Override - protected void onVisibilityChanged(View changedView, int visibility) { - super.onVisibilityChanged(changedView, visibility); - // scroll to bottom after reloading - if (visibility == View.VISIBLE && changedView == this) { - post(new Runnable() { - public void run() { - update(); - } - }); - } - } - public void setAdapter(TaskDescriptionAdapter adapter) { mAdapter = adapter; mAdapter.registerDataSetObserver(new DataSetObserver() { diff --git a/packages/SystemUI/src/com/android/systemui/statusbar/phone/QuickSettings.java b/packages/SystemUI/src/com/android/systemui/statusbar/phone/QuickSettings.java index a616490..9b0a320 100644 --- a/packages/SystemUI/src/com/android/systemui/statusbar/phone/QuickSettings.java +++ b/packages/SystemUI/src/com/android/systemui/statusbar/phone/QuickSettings.java @@ -305,8 +305,7 @@ class QuickSettings { (UserManager) mContext.getSystemService(Context.USER_SERVICE); if (um.getUsers(true).size() > 1) { try { - WindowManagerGlobal.getWindowManagerService().lockNow( - LockPatternUtils.USER_SWITCH_LOCK_OPTIONS); + WindowManagerGlobal.getWindowManagerService().lockNow(null); } catch (RemoteException e) { Log.e(TAG, "Couldn't show user switcher", e); } diff --git a/packages/SystemUI/src/com/android/systemui/statusbar/policy/Clock.java b/packages/SystemUI/src/com/android/systemui/statusbar/policy/Clock.java index ffc18c7..8f2a4eb 100644 --- a/packages/SystemUI/src/com/android/systemui/statusbar/policy/Clock.java +++ b/packages/SystemUI/src/com/android/systemui/statusbar/policy/Clock.java @@ -45,8 +45,7 @@ import java.util.TimeZone; import com.android.internal.R; /** - * This widget display an analogic clock with two hands for hours and - * minutes. + * Digital clock for the status bar. */ public class Clock extends TextView { private boolean mAttached; @@ -84,6 +83,7 @@ public class Clock extends TextView { filter.addAction(Intent.ACTION_TIME_CHANGED); filter.addAction(Intent.ACTION_TIMEZONE_CHANGED); filter.addAction(Intent.ACTION_CONFIGURATION_CHANGED); + filter.addAction(Intent.ACTION_USER_SWITCHED); getContext().registerReceiver(mIntentReceiver, filter, null, getHandler()); } diff --git a/policy/src/com/android/internal/policy/impl/keyguard/KeyguardViewManager.java b/policy/src/com/android/internal/policy/impl/keyguard/KeyguardViewManager.java index 76ba811..1cf9413 100644 --- a/policy/src/com/android/internal/policy/impl/keyguard/KeyguardViewManager.java +++ b/policy/src/com/android/internal/policy/impl/keyguard/KeyguardViewManager.java @@ -236,12 +236,6 @@ public class KeyguardViewManager { } if (options != null) { - if (options.getBoolean(LockPatternUtils.KEYGUARD_SHOW_USER_SWITCHER)) { - mKeyguardView.goToUserSwitcher(); - } - if (options.getBoolean(LockPatternUtils.KEYGUARD_SHOW_SECURITY_CHALLENGE)) { - mKeyguardView.showNextSecurityScreenIfPresent(); - } int widgetToShow = options.getInt(LockPatternUtils.KEYGUARD_SHOW_APPWIDGET, AppWidgetManager.INVALID_APPWIDGET_ID); if (widgetToShow != AppWidgetManager.INVALID_APPWIDGET_ID) { diff --git a/policy/src/com/android/internal/policy/impl/keyguard/KeyguardViewMediator.java b/policy/src/com/android/internal/policy/impl/keyguard/KeyguardViewMediator.java index c227619..7d757ff 100644 --- a/policy/src/com/android/internal/policy/impl/keyguard/KeyguardViewMediator.java +++ b/policy/src/com/android/internal/policy/impl/keyguard/KeyguardViewMediator.java @@ -315,10 +315,7 @@ public class KeyguardViewMediator { // We need to force a reset of the views, since lockNow (called by // ActivityManagerService) will not reconstruct the keyguard if it is already showing. synchronized (KeyguardViewMediator.this) { - Bundle options = new Bundle(); - options.putBoolean(LockPatternUtils.KEYGUARD_SHOW_USER_SWITCHER, true); - options.putBoolean(LockPatternUtils.KEYGUARD_SHOW_SECURITY_CHALLENGE, true); - resetStateLocked(options); + resetStateLocked(null); adjustStatusBarLocked(); // Disable face unlock when the user switches. KeyguardUpdateMonitor.getInstance(mContext).setAlternateUnlockEnabled(false); diff --git a/services/java/com/android/server/AlarmManagerService.java b/services/java/com/android/server/AlarmManagerService.java index 440f8e1..cbd00f3 100644 --- a/services/java/com/android/server/AlarmManagerService.java +++ b/services/java/com/android/server/AlarmManagerService.java @@ -22,6 +22,7 @@ import android.app.AlarmManager; import android.app.IAlarmManager; import android.app.PendingIntent; import android.content.BroadcastReceiver; +import android.content.ComponentName; import android.content.Context; import android.content.Intent; import android.content.IntentFilter; @@ -38,6 +39,7 @@ import android.os.UserHandle; import android.os.WorkSource; import android.text.TextUtils; import android.text.format.Time; +import android.util.Pair; import android.util.Slog; import android.util.TimeUtils; @@ -45,16 +47,18 @@ import java.io.FileDescriptor; import java.io.PrintWriter; import java.text.SimpleDateFormat; import java.util.ArrayList; +import java.util.Arrays; import java.util.Calendar; import java.util.Collections; import java.util.Comparator; import java.util.Date; import java.util.HashMap; import java.util.Iterator; -import java.util.LinkedList; import java.util.Map; import java.util.TimeZone; +import com.android.internal.util.LocalLog; + class AlarmManagerService extends IAlarmManager.Stub { // The threshold for how long an alarm can be late before we print a // warning message. The time duration is in milliseconds. @@ -79,7 +83,9 @@ class AlarmManagerService extends IAlarmManager.Stub { = new Intent().addFlags(Intent.FLAG_FROM_BACKGROUND); private final Context mContext; - + + private final LocalLog mLog = new LocalLog(TAG); + private Object mLock = new Object(); private final ArrayList<Alarm> mRtcWakeupAlarms = new ArrayList<Alarm>(); @@ -91,7 +97,7 @@ class AlarmManagerService extends IAlarmManager.Stub { private int mDescriptor; private int mBroadcastRefCount = 0; private PowerManager.WakeLock mWakeLock; - private LinkedList<PendingIntent> mInFlight = new LinkedList<PendingIntent>(); + private ArrayList<InFlight> mInFlight = new ArrayList<InFlight>(); private final AlarmThread mWaitThread = new AlarmThread(); private final AlarmHandler mHandler = new AlarmHandler(); private ClockReceiver mClockReceiver; @@ -99,18 +105,59 @@ class AlarmManagerService extends IAlarmManager.Stub { private final ResultReceiver mResultReceiver = new ResultReceiver(); private final PendingIntent mTimeTickSender; private final PendingIntent mDateChangeSender; - + + private static final class InFlight extends Intent { + final PendingIntent mPendingIntent; + final Pair<String, ComponentName> mTarget; + final BroadcastStats mBroadcastStats; + final FilterStats mFilterStats; + + InFlight(AlarmManagerService service, PendingIntent pendingIntent) { + mPendingIntent = pendingIntent; + Intent intent = pendingIntent.getIntent(); + mTarget = intent != null + ? new Pair<String, ComponentName>(intent.getAction(), intent.getComponent()) + : null; + mBroadcastStats = service.getStatsLocked(pendingIntent); + FilterStats fs = mBroadcastStats.filterStats.get(mTarget); + if (fs == null) { + fs = new FilterStats(mBroadcastStats, mTarget); + mBroadcastStats.filterStats.put(mTarget, fs); + } + mFilterStats = fs; + } + } + private static final class FilterStats { + final BroadcastStats mBroadcastStats; + final Pair<String, ComponentName> mTarget; + + long aggregateTime; int count; + int numWakeup; + long startTime; + int nesting; + + FilterStats(BroadcastStats broadcastStats, Pair<String, ComponentName> target) { + mBroadcastStats = broadcastStats; + mTarget = target; + } } private static final class BroadcastStats { + final String mPackageName; + long aggregateTime; + int count; int numWakeup; long startTime; int nesting; - HashMap<Intent.FilterComparison, FilterStats> filterStats - = new HashMap<Intent.FilterComparison, FilterStats>(); + final HashMap<Pair<String, ComponentName>, FilterStats> filterStats + = new HashMap<Pair<String, ComponentName>, FilterStats>(); + + BroadcastStats(String packageName) { + mPackageName = packageName; + } } private final HashMap<String, BroadcastStats> mBroadcastStats @@ -496,24 +543,104 @@ class AlarmManagerService extends IAlarmManager.Stub { dumpAlarmList(pw, mElapsedRealtimeAlarms, " ", "ELAPSED", now); } } - - pw.println(" "); + + pw.println(); pw.print(" Broadcast ref count: "); pw.println(mBroadcastRefCount); - + pw.println(); + + if (mLog.dump(pw, " Recent problems", " ")) { + pw.println(); + } + + final FilterStats[] topFilters = new FilterStats[10]; + final Comparator<FilterStats> comparator = new Comparator<FilterStats>() { + @Override + public int compare(FilterStats lhs, FilterStats rhs) { + if (lhs.aggregateTime < rhs.aggregateTime) { + return 1; + } else if (lhs.aggregateTime > rhs.aggregateTime) { + return -1; + } + return 0; + } + }; + int len = 0; + for (Map.Entry<String, BroadcastStats> be : mBroadcastStats.entrySet()) { + BroadcastStats bs = be.getValue(); + for (Map.Entry<Pair<String, ComponentName>, FilterStats> fe + : bs.filterStats.entrySet()) { + FilterStats fs = fe.getValue(); + int pos = len > 0 + ? Arrays.binarySearch(topFilters, 0, len, fs, comparator) : 0; + if (pos < 0) { + pos = -pos - 1; + } + if (pos < topFilters.length) { + int copylen = topFilters.length - pos - 1; + if (copylen > 0) { + System.arraycopy(topFilters, pos, topFilters, pos+1, copylen); + } + topFilters[pos] = fs; + if (len < topFilters.length) { + len++; + } + } + } + } + if (len > 0) { + pw.println(" Top Alarms:"); + for (int i=0; i<len; i++) { + FilterStats fs = topFilters[i]; + pw.print(" "); + if (fs.nesting > 0) pw.print("*ACTIVE* "); + TimeUtils.formatDuration(fs.aggregateTime, pw); + pw.print(" running, "); pw.print(fs.numWakeup); + pw.print(" wakeups, "); pw.print(fs.count); + pw.print(" alarms: "); pw.print(fs.mBroadcastStats.mPackageName); + pw.println(); + pw.print(" "); + if (fs.mTarget.first != null) { + pw.print(" act="); pw.print(fs.mTarget.first); + } + if (fs.mTarget.second != null) { + pw.print(" cmp="); pw.print(fs.mTarget.second.toShortString()); + } + pw.println(); + } + } + pw.println(" "); pw.println(" Alarm Stats:"); + final ArrayList<FilterStats> tmpFilters = new ArrayList<FilterStats>(); for (Map.Entry<String, BroadcastStats> be : mBroadcastStats.entrySet()) { BroadcastStats bs = be.getValue(); - pw.print(" "); pw.println(be.getKey()); - pw.print(" "); pw.print(bs.aggregateTime); - pw.print("ms running, "); pw.print(bs.numWakeup); - pw.println(" wakeups"); - for (Map.Entry<Intent.FilterComparison, FilterStats> fe + pw.print(" "); + if (bs.nesting > 0) pw.print("*ACTIVE* "); + pw.print(be.getKey()); + pw.print(" "); TimeUtils.formatDuration(bs.aggregateTime, pw); + pw.print(" running, "); pw.print(bs.numWakeup); + pw.println(" wakeups:"); + tmpFilters.clear(); + for (Map.Entry<Pair<String, ComponentName>, FilterStats> fe : bs.filterStats.entrySet()) { - pw.print(" "); pw.print(fe.getValue().count); - pw.print(" alarms: "); - pw.println(fe.getKey().getIntent().toShortString( - false, true, false, true)); + tmpFilters.add(fe.getValue()); + } + Collections.sort(tmpFilters, comparator); + for (int i=0; i<tmpFilters.size(); i++) { + FilterStats fs = tmpFilters.get(i); + pw.print(" "); + if (fs.nesting > 0) pw.print("*ACTIVE* "); + TimeUtils.formatDuration(fs.aggregateTime, pw); + pw.print(" "); pw.print(fs.numWakeup); + pw.print(" wakes " ); pw.print(fs.count); + pw.print(" alarms:"); + if (fs.mTarget.first != null) { + pw.print(" act="); pw.print(fs.mTarget.first); + } + if (fs.mTarget.second != null) { + pw.print(" cmp="); pw.print(fs.mTarget.second.toShortString()); + } + pw.println(); } } } @@ -708,18 +835,31 @@ class AlarmManagerService extends IAlarmManager.Stub { setWakelockWorkSource(alarm.operation); mWakeLock.acquire(); } - mInFlight.add(alarm.operation); + final InFlight inflight = new InFlight(AlarmManagerService.this, + alarm.operation); + mInFlight.add(inflight); mBroadcastRefCount++; - - BroadcastStats bs = getStatsLocked(alarm.operation); + + final BroadcastStats bs = inflight.mBroadcastStats; + bs.count++; if (bs.nesting == 0) { + bs.nesting = 1; bs.startTime = nowELAPSED; } else { bs.nesting++; } + final FilterStats fs = inflight.mFilterStats; + fs.count++; + if (fs.nesting == 0) { + fs.nesting = 1; + fs.startTime = nowELAPSED; + } else { + fs.nesting++; + } if (alarm.type == AlarmManager.ELAPSED_REALTIME_WAKEUP || alarm.type == AlarmManager.RTC_WAKEUP) { bs.numWakeup++; + fs.numWakeup++; ActivityManagerNative.noteWakeupAlarm( alarm.operation); } @@ -908,44 +1048,58 @@ class AlarmManagerService extends IAlarmManager.Stub { String pkg = pi.getTargetPackage(); BroadcastStats bs = mBroadcastStats.get(pkg); if (bs == null) { - bs = new BroadcastStats(); + bs = new BroadcastStats(pkg); mBroadcastStats.put(pkg, bs); } return bs; } - + class ResultReceiver implements PendingIntent.OnFinished { public void onSendFinished(PendingIntent pi, Intent intent, int resultCode, String resultData, Bundle resultExtras) { synchronized (mLock) { - BroadcastStats bs = getStatsLocked(pi); - if (bs != null) { + InFlight inflight = null; + for (int i=0; i<mInFlight.size(); i++) { + if (mInFlight.get(i).mPendingIntent == pi) { + inflight = mInFlight.remove(i); + break; + } + } + if (inflight != null) { + final long nowELAPSED = SystemClock.elapsedRealtime(); + BroadcastStats bs = inflight.mBroadcastStats; bs.nesting--; if (bs.nesting <= 0) { bs.nesting = 0; - bs.aggregateTime += SystemClock.elapsedRealtime() - - bs.startTime; - Intent.FilterComparison fc = new Intent.FilterComparison(intent); - FilterStats fs = bs.filterStats.get(fc); - if (fs == null) { - fs = new FilterStats(); - bs.filterStats.put(fc, fs); - } - fs.count++; + bs.aggregateTime += nowELAPSED - bs.startTime; + } + FilterStats fs = inflight.mFilterStats; + fs.nesting--; + if (fs.nesting <= 0) { + fs.nesting = 0; + fs.aggregateTime += nowELAPSED - fs.startTime; } + } else { + mLog.w("No in-flight alarm for " + pi + " " + intent); } - mInFlight.removeFirst(); mBroadcastRefCount--; if (mBroadcastRefCount == 0) { mWakeLock.release(); + if (mInFlight.size() > 0) { + mLog.w("Finished all broadcasts with " + mInFlight.size() + + " remaining inflights"); + for (int i=0; i<mInFlight.size(); i++) { + mLog.w(" Remaining #" + i + ": " + mInFlight.get(i)); + } + mInFlight.clear(); + } } else { // the next of our alarms is now in flight. reattribute the wakelock. - final PendingIntent nowInFlight = mInFlight.peekFirst(); - if (nowInFlight != null) { - setWakelockWorkSource(nowInFlight); + if (mInFlight.size() > 0) { + setWakelockWorkSource(mInFlight.get(0).mPendingIntent); } else { // should never happen - Slog.e(TAG, "Alarm wakelock still held but sent queue empty"); + mLog.w("Alarm wakelock still held but sent queue empty"); mWakeLock.setWorkSource(null); } } diff --git a/services/java/com/android/server/AppWidgetServiceImpl.java b/services/java/com/android/server/AppWidgetServiceImpl.java index fe92b26..bba5192 100644 --- a/services/java/com/android/server/AppWidgetServiceImpl.java +++ b/services/java/com/android/server/AppWidgetServiceImpl.java @@ -336,6 +336,7 @@ class AppWidgetServiceImpl { pw.print(info.autoAdvanceViewId); pw.print(" initialLayout=#"); pw.print(Integer.toHexString(info.initialLayout)); + pw.print(" uid="); pw.print(p.uid); pw.print(" zombie="); pw.println(p.zombie); } @@ -699,6 +700,10 @@ class AppWidgetServiceImpl { } int userId = UserHandle.getUserId(id.provider.uid); + if (userId != mUserId) { + Slog.w(TAG, "AppWidgetServiceImpl of user " + mUserId + + " binding to provider on user " + userId); + } // Bind to the RemoteViewsService (which will trigger a callback to the // RemoteViewsAdapter.onServiceConnected()) final long token = Binder.clearCallingIdentity(); @@ -966,6 +971,13 @@ class AppWidgetServiceImpl { ensureStateLoadedLocked(); for (int i = 0; i < N; i++) { AppWidgetId id = lookupAppWidgetIdLocked(appWidgetIds[i]); + if (id == null) { + String message = "AppWidgetId NPE: mUserId=" + mUserId + + ", callingUid=" + Binder.getCallingUid() + + ", appWidgetIds[i]=" + appWidgetIds[i] + + "\n mAppWidgets:\n" + getUserWidgets(); + throw new NullPointerException(message); + } if (id.views != null) { // Only trigger a partial update for a widget if it has received a full update updateAppWidgetInstanceLocked(id, views, true); @@ -974,6 +986,18 @@ class AppWidgetServiceImpl { } } + private String getUserWidgets() { + StringBuffer sb = new StringBuffer(); + for (AppWidgetId widget: mAppWidgetIds) { + sb.append(" id="); sb.append(widget.appWidgetId); + sb.append(", hostUid="); sb.append(widget.host.uid); + sb.append(", provider="); sb.append(widget.provider.info.provider.toString()); + sb.append("\n"); + } + sb.append("\n"); + return sb.toString(); + } + public void notifyAppWidgetViewDataChanged(int[] appWidgetIds, int viewId) { if (appWidgetIds == null) { return; diff --git a/services/java/com/android/server/DevicePolicyManagerService.java b/services/java/com/android/server/DevicePolicyManagerService.java index a5e26a8..5ba71a4 100644 --- a/services/java/com/android/server/DevicePolicyManagerService.java +++ b/services/java/com/android/server/DevicePolicyManagerService.java @@ -1875,28 +1875,32 @@ public class DevicePolicyManagerService extends IDevicePolicyManager.Stub { DeviceAdminInfo.USES_POLICY_WIPE_DATA); long ident = Binder.clearCallingIdentity(); try { - if (userHandle == UserHandle.USER_OWNER) { - wipeDataLocked(flags); - } else { - lockNowUnchecked(); - mHandler.post(new Runnable() { - public void run() { - try { - ActivityManagerNative.getDefault().switchUser(0); - ((UserManager) mContext.getSystemService(Context.USER_SERVICE)) - .removeUser(userHandle); - } catch (RemoteException re) { - // Shouldn't happen - } - } - }); - } + wipeDeviceOrUserLocked(flags, userHandle); } finally { Binder.restoreCallingIdentity(ident); } } } + private void wipeDeviceOrUserLocked(int flags, final int userHandle) { + if (userHandle == UserHandle.USER_OWNER) { + wipeDataLocked(flags); + } else { + lockNowUnchecked(); + mHandler.post(new Runnable() { + public void run() { + try { + ActivityManagerNative.getDefault().switchUser(0); + ((UserManager) mContext.getSystemService(Context.USER_SERVICE)) + .removeUser(userHandle); + } catch (RemoteException re) { + // Shouldn't happen + } + } + }); + } + } + public void getRemoveWarning(ComponentName comp, final RemoteCallback result, int userHandle) { enforceCrossUserPermission(userHandle); mContext.enforceCallingOrSelfPermission( @@ -1996,7 +2000,7 @@ public class DevicePolicyManagerService extends IDevicePolicyManager.Stub { saveSettingsLocked(userHandle); int max = getMaximumFailedPasswordsForWipe(null, userHandle); if (max > 0 && policy.mFailedPasswordAttempts >= max) { - wipeDataLocked(0); + wipeDeviceOrUserLocked(0, userHandle); } sendAdminCommandLocked(DeviceAdminReceiver.ACTION_PASSWORD_FAILED, DeviceAdminInfo.USES_POLICY_WATCH_LOGIN, userHandle); diff --git a/services/java/com/android/server/InputMethodManagerService.java b/services/java/com/android/server/InputMethodManagerService.java index 85bc259..3b60526 100644 --- a/services/java/com/android/server/InputMethodManagerService.java +++ b/services/java/com/android/server/InputMethodManagerService.java @@ -1824,9 +1824,9 @@ public class InputMethodManagerService extends IInputMethodManager.Stub public InputBindResult windowGainedFocus(IInputMethodClient client, IBinder windowToken, int controlFlags, int softInputMode, int windowFlags, EditorInfo attribute, IInputContext inputContext) { - if (!calledFromValidUser()) { - return null; - } + // Needs to check the validity before clearing calling identity + final boolean calledFromValidUser = calledFromValidUser(); + InputBindResult res = null; long ident = Binder.clearCallingIdentity(); try { @@ -1856,6 +1856,14 @@ public class InputMethodManagerService extends IInputMethodManager.Stub } catch (RemoteException e) { } + if (!calledFromValidUser) { + Slog.w(TAG, "A background user is requesting window. Hiding IME."); + Slog.w(TAG, "If you want to interect with IME, you need " + + "android.permission.INTERACT_ACROSS_USERS_FULL"); + hideCurrentInputLocked(0, null); + return null; + } + if (mCurFocusedWindow == windowToken) { Slog.w(TAG, "Window already focused, ignoring focus gain of: " + client + " attribute=" + attribute + ", token = " + windowToken); diff --git a/services/java/com/android/server/am/ActivityManagerService.java b/services/java/com/android/server/am/ActivityManagerService.java index f527cc2..271ebb5 100644 --- a/services/java/com/android/server/am/ActivityManagerService.java +++ b/services/java/com/android/server/am/ActivityManagerService.java @@ -4766,6 +4766,18 @@ public final class ActivityManagerService extends ActivityManagerNative return false; } + public Intent getIntentForIntentSender(IIntentSender pendingResult) { + if (!(pendingResult instanceof PendingIntentRecord)) { + return null; + } + try { + PendingIntentRecord res = (PendingIntentRecord)pendingResult; + return res.key.requestIntent != null ? new Intent(res.key.requestIntent) : null; + } catch (ClassCastException e) { + } + return null; + } + public void setProcessLimit(int max) { enforceCallingPermission(android.Manifest.permission.SET_PROCESS_LIMIT, "setProcessLimit()"); @@ -14170,7 +14182,7 @@ public final class ActivityManagerService extends ActivityManagerNative // Once the internal notion of the active user has switched, we lock the device // with the option to show the user switcher on the keyguard. - mWindowManager.lockNow(LockPatternUtils.USER_SWITCH_LOCK_OPTIONS); + mWindowManager.lockNow(null); final UserStartedState uss = mStartedUsers.get(userId); diff --git a/services/java/com/android/server/net/NetworkStatsService.java b/services/java/com/android/server/net/NetworkStatsService.java index 7101520..67eaad3 100644 --- a/services/java/com/android/server/net/NetworkStatsService.java +++ b/services/java/com/android/server/net/NetworkStatsService.java @@ -940,14 +940,14 @@ public class NetworkStatsService extends INetworkStatsService.Stub { } private void performPoll(int flags) { + // try refreshing time source when stale + if (mTime.getCacheAge() > mSettings.getTimeCacheMaxAge()) { + mTime.forceRefresh(); + } + synchronized (mStatsLock) { mWakeLock.acquire(); - // try refreshing time source when stale - if (mTime.getCacheAge() > mSettings.getTimeCacheMaxAge()) { - mTime.forceRefresh(); - } - try { performPollLocked(flags); } finally { diff --git a/services/java/com/android/server/wm/WindowManagerService.java b/services/java/com/android/server/wm/WindowManagerService.java index f8a2b0c..a838fa8 100644 --- a/services/java/com/android/server/wm/WindowManagerService.java +++ b/services/java/com/android/server/wm/WindowManagerService.java @@ -2848,7 +2848,7 @@ public class WindowManagerService extends IWindowManager.Stub } if (win.isConfigChanged()) { if (DEBUG_CONFIGURATION) Slog.i(TAG, "Window " + win - + " visible with new config: " + win.mConfiguration); + + " visible with new config: " + mCurConfiguration); outConfig.setTo(mCurConfiguration); } } @@ -3808,22 +3808,23 @@ public class WindowManagerService extends IWindowManager.Stub final WindowList windows = getDefaultWindowListLocked(); int pos = windows.size() - 1; while (pos >= 0) { - WindowState wtoken = windows.get(pos); + WindowState win = windows.get(pos); pos--; - if (wtoken.mAppToken != null) { + if (win.mAppToken != null) { // We hit an application window. so the orientation will be determined by the // app window. No point in continuing further. return (mLastWindowForcedOrientation=ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED); } - if (!wtoken.isVisibleLw() || !wtoken.mPolicyVisibilityAfterAnim) { + if (!win.isVisibleLw() || !win.mPolicyVisibilityAfterAnim) { continue; } - int req = wtoken.mAttrs.screenOrientation; + int req = win.mAttrs.screenOrientation; if((req == ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED) || (req == ActivityInfo.SCREEN_ORIENTATION_BEHIND)){ continue; } + if (DEBUG_ORIENTATION) Slog.v(TAG, win + " forcing orientation to " + req); return (mLastWindowForcedOrientation=req); } return (mLastWindowForcedOrientation=ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED); @@ -9420,7 +9421,7 @@ public class WindowManagerService extends IWindowManager.Stub + " / " + mCurConfiguration + " / 0x" + Integer.toHexString(diff)); } - win.mConfiguration = mCurConfiguration; + win.setConfiguration(mCurConfiguration); if (DEBUG_ORIENTATION && winAnimator.mDrawState == WindowStateAnimator.DRAW_PENDING) Slog.i( TAG, "Resizing " + win + " WITH DRAW PENDING"); diff --git a/services/java/com/android/server/wm/WindowState.java b/services/java/com/android/server/wm/WindowState.java index 35bebbe..3dce939 100644 --- a/services/java/com/android/server/wm/WindowState.java +++ b/services/java/com/android/server/wm/WindowState.java @@ -21,6 +21,7 @@ import static android.view.WindowManager.LayoutParams.FLAG_COMPATIBLE_WINDOW; import static android.view.WindowManager.LayoutParams.LAST_SUB_WINDOW; import static android.view.WindowManager.LayoutParams.TYPE_INPUT_METHOD; import static android.view.WindowManager.LayoutParams.TYPE_INPUT_METHOD_DIALOG; +import static android.view.WindowManager.LayoutParams.TYPE_KEYGUARD; import static android.view.WindowManager.LayoutParams.TYPE_WALLPAPER; import com.android.server.input.InputWindowHandle; @@ -112,6 +113,9 @@ final class WindowState implements WindowManagerPolicy.WindowState { int mLayoutSeq = -1; Configuration mConfiguration = null; + // Sticky answer to isConfigChanged(), remains true until new Configuration is assigned. + // Used only on {@link #TYPE_KEYGUARD}. + private boolean mConfigHasChanged; /** * Actual frame shown on-screen (may be modified by animation). These @@ -627,6 +631,7 @@ final class WindowState implements WindowManagerPolicy.WindowState { : WindowManagerService.DEFAULT_INPUT_DISPATCHING_TIMEOUT_NANOS; } + @Override public boolean hasAppShownWindows() { return mAppToken != null && (mAppToken.firstWindowDrawn || mAppToken.startingDisplayed); } @@ -857,9 +862,17 @@ final class WindowState implements WindowManagerPolicy.WindowState { } boolean isConfigChanged() { - return mConfiguration != mService.mCurConfiguration + boolean configChanged = mConfiguration != mService.mCurConfiguration && (mConfiguration == null || (mConfiguration.diff(mService.mCurConfiguration) != 0)); + + if (mAttrs.type == TYPE_KEYGUARD) { + // Retain configuration changed status until resetConfiguration called. + mConfigHasChanged |= configChanged; + configChanged = mConfigHasChanged; + } + + return configChanged; } boolean isConfigDiff(int mask) { @@ -886,6 +899,11 @@ final class WindowState implements WindowManagerPolicy.WindowState { } } + void setConfiguration(final Configuration newConfig) { + mConfiguration = newConfig; + mConfigHasChanged = false; + } + void setInputChannel(InputChannel inputChannel) { if (mInputChannel != null) { throw new IllegalStateException("Window already has an input channel."); @@ -907,6 +925,7 @@ final class WindowState implements WindowManagerPolicy.WindowState { } private class DeathRecipient implements IBinder.DeathRecipient { + @Override public void binderDied() { try { synchronized(mService.mWindowMap) { diff --git a/services/java/com/android/server/wm/WindowStateAnimator.java b/services/java/com/android/server/wm/WindowStateAnimator.java index 4ecc191..c2178e4 100644 --- a/services/java/com/android/server/wm/WindowStateAnimator.java +++ b/services/java/com/android/server/wm/WindowStateAnimator.java @@ -810,7 +810,7 @@ class WindowStateAnimator { mSurfaceShown = false; mSurface = null; - mWin.mHasSurface =false; + mWin.mHasSurface = false; mDrawState = NO_SURFACE; } } diff --git a/tests/StatusBar/res/layout/notification_builder_test.xml b/tests/StatusBar/res/layout/notification_builder_test.xml index 94fc089..5987c84 100644 --- a/tests/StatusBar/res/layout/notification_builder_test.xml +++ b/tests/StatusBar/res/layout/notification_builder_test.xml @@ -222,307 +222,320 @@ > <!-- setWhen --> - <RadioGroup - android:id="@+id/group_when" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setWhen" /> - <RadioButton - android:id="@+id/when_midnight" - style="@style/FieldContents" - android:text="midnight" - /> - <RadioButton - android:id="@+id/when_now" - style="@style/FieldContents" - android:text="now" - /> - <RadioButton - android:id="@+id/when_now_plus_1h" - style="@style/FieldContents.Disabled" - android:text="now + 1h" - /> - <RadioButton - android:id="@+id/when_tomorrow" - style="@style/FieldContents.Disabled" - android:text="tomorrow" - /> - </RadioGroup> + <RadioGroup + android:id="@+id/group_when" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/when_midnight" + style="@style/FieldContents" + android:text="midnight" + /> + <RadioButton + android:id="@+id/when_now" + style="@style/FieldContents" + android:text="now" + /> + <RadioButton + android:id="@+id/when_now_plus_1h" + style="@style/FieldContents.Disabled" + android:text="now + 1h" + /> + <RadioButton + android:id="@+id/when_tomorrow" + style="@style/FieldContents.Disabled" + android:text="tomorrow" + /> + </RadioGroup> + </LinearLayout> <!-- icon --> - <RadioGroup - android:id="@+id/group_icon" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setSmallIcon" /> - <RadioButton - android:id="@+id/icon_im" - style="@style/FieldContents" - android:text="IM" - /> - <RadioButton - android:id="@+id/icon_alert" - style="@style/FieldContents" - android:text="alert" - /> - <RadioButton - android:id="@+id/icon_surprise" - style="@style/FieldContents" - android:text="surprise" - /> - <RadioButton - android:id="@+id/icon_level0" - style="@style/FieldContents.Disabled" - android:text="level 0" - /> - <RadioButton - android:id="@+id/icon_level50" - style="@style/FieldContents.Disabled" - android:text="level 50" - /> - <RadioButton - android:id="@+id/icon_level100" - style="@style/FieldContents.Disabled" - android:text="level 100" - /> - <!-- todo setSmallIcon(int icon, int level) --> - </RadioGroup> - + <RadioGroup + android:id="@+id/group_icon" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/icon_im" + style="@style/FieldContents" + android:text="IM" + /> + <RadioButton + android:id="@+id/icon_alert" + style="@style/FieldContents" + android:text="alert" + /> + <RadioButton + android:id="@+id/icon_surprise" + style="@style/FieldContents" + android:text="surprise" + /> + <RadioButton + android:id="@+id/icon_level0" + style="@style/FieldContents.Disabled" + android:text="level 0" + /> + <RadioButton + android:id="@+id/icon_level50" + style="@style/FieldContents.Disabled" + android:text="level 50" + /> + <RadioButton + android:id="@+id/icon_level100" + style="@style/FieldContents.Disabled" + android:text="level 100" + /> + <!-- todo setSmallIcon(int icon, int level) --> + </RadioGroup> + </LinearLayout> + <!-- setContentTitle --> - <RadioGroup - android:id="@+id/group_title" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setContentTitle" /> - <RadioButton - android:id="@+id/title_short" - style="@style/FieldContents" - android:text="none" - android:tag="" - /> - <RadioButton - android:id="@+id/title_short" - style="@style/FieldContents" - android:text="short" - android:tag="Title" - /> - <RadioButton - android:id="@+id/title_medium" - style="@style/FieldContents" - android:text="medium" - android:tag="Notification Test" - /> - <RadioButton - android:id="@+id/title_long" - style="@style/FieldContents" - android:text="long" - android:tag="This is one heckuva long title for a notification" - /> - </RadioGroup> - + <RadioGroup + android:id="@+id/group_title" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/title_short" + style="@style/FieldContents" + android:text="none" + android:tag="" + /> + <RadioButton + android:id="@+id/title_short" + style="@style/FieldContents" + android:text="short" + android:tag="Title" + /> + <RadioButton + android:id="@+id/title_medium" + style="@style/FieldContents" + android:text="medium" + android:tag="Notification Test" + /> + <RadioButton + android:id="@+id/title_long" + style="@style/FieldContents" + android:text="long" + android:tag="This is one heckuva long title for a notification" + /> + </RadioGroup> + </LinearLayout> + <!-- setContentText --> - <RadioGroup - android:id="@+id/group_text" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setContentText" /> - <RadioButton - android:id="@+id/text_none" - style="@style/FieldContents" - android:text="none" - android:tag="" - /> - <RadioButton - android:id="@+id/text_short" - style="@style/FieldContents" - android:tag="short" - android:text="text" - /> - <RadioButton - android:id="@+id/text_medium" - style="@style/FieldContents" - android:text="medium" - android:tag="Something happened" - /> - <RadioButton - android:id="@+id/text_long" - style="@style/FieldContents" - android:text="long" - android:tag="Oh my goodness. SOMETHING HAPPENED!!!!" - /> - <RadioButton - android:id="@+id/text_emoji" - style="@style/FieldContents" - android:text="emoji" - android:tag="_ Cactus _ Cactus _" - /> - <RadioButton - android:id="@+id/text_haiku" - style="@style/FieldContents" - android:text="haiku" - android:tag="sholes final approach\nlanding gear punted to flan\nrunway foam glistens" - /> - </RadioGroup> + <RadioGroup + android:id="@+id/group_text" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/text_none" + style="@style/FieldContents" + android:text="none" + android:tag="" + /> + <RadioButton + android:id="@+id/text_short" + style="@style/FieldContents" + android:tag="short" + android:text="text" + /> + <RadioButton + android:id="@+id/text_medium" + style="@style/FieldContents" + android:text="medium" + android:tag="Something happened" + /> + <RadioButton + android:id="@+id/text_long" + style="@style/FieldContents" + android:text="long" + android:tag="Oh my goodness. SOMETHING HAPPENED!!!!" + /> + <RadioButton + android:id="@+id/text_emoji" + style="@style/FieldContents" + android:text="emoji" + android:tag="_ Cactus _ Cactus _" + /> + <RadioButton + android:id="@+id/text_haiku" + style="@style/FieldContents" + android:text="haiku" + android:tag="sholes final approach\nlanding gear punted to flan\nrunway foam glistens" + /> + </RadioGroup> + </LinearLayout> <!-- setContentInfo --> - <RadioGroup - android:id="@+id/group_info" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setContentInfo" /> - <RadioButton - android:id="@+id/info_none" - style="@style/FieldContents" - android:text="none" - android:tag="" - /> - <RadioButton - android:id="@+id/info_number" - style="@style/FieldContents" - android:text="snoozed" - android:tag="snoozed" - /> - <RadioButton - android:id="@+id/info_long" - style="@style/FieldContents" - android:text="longer" - android:tag="this content info is way too long" - /> - </RadioGroup> + <RadioGroup + android:id="@+id/group_info" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/info_none" + style="@style/FieldContents" + android:text="none" + android:tag="" + /> + <RadioButton + android:id="@+id/info_number" + style="@style/FieldContents" + android:text="snoozed" + android:tag="snoozed" + /> + <RadioButton + android:id="@+id/info_long" + style="@style/FieldContents" + android:text="longer" + android:tag="this content info is way too long" + /> + </RadioGroup> + </LinearLayout> <!-- setNumber --> - <RadioGroup - android:id="@+id/group_number" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setNumber" /> - <RadioButton - android:id="@+id/number_0" - style="@style/FieldContents" - android:text="0" - android:tag="0" - /> - <RadioButton - android:id="@+id/number_1" - style="@style/FieldContents" - android:text="1" - android:tag="1" - /> - <RadioButton - android:id="@+id/number_42" - style="@style/FieldContents" - android:text="42" - android:tag="42" - /> - <RadioButton - android:id="@+id/number_334" - style="@style/FieldContents" - android:text="334" - android:tag="334" - /> - <RadioButton - android:id="@+id/number_999" - style="@style/FieldContents" - android:text="999" - android:tag="999" - /> - <RadioButton - android:id="@+id/number_9876" - style="@style/FieldContents" - android:text="9,876" - android:tag="9876" - /> - <RadioButton - android:id="@+id/number_12345" - style="@style/FieldContents" - android:text="12,345" - android:tag="12345" - /> - </RadioGroup> - + <RadioGroup + android:id="@+id/group_number" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/number_0" + style="@style/FieldContents" + android:text="0" + android:tag="0" + /> + <RadioButton + android:id="@+id/number_1" + style="@style/FieldContents" + android:text="1" + android:tag="1" + /> + <RadioButton + android:id="@+id/number_42" + style="@style/FieldContents" + android:text="42" + android:tag="42" + /> + <RadioButton + android:id="@+id/number_334" + style="@style/FieldContents" + android:text="334" + android:tag="334" + /> + <RadioButton + android:id="@+id/number_999" + style="@style/FieldContents" + android:text="999" + android:tag="999" + /> + <RadioButton + android:id="@+id/number_9876" + style="@style/FieldContents" + android:text="9,876" + android:tag="9876" + /> + <RadioButton + android:id="@+id/number_12345" + style="@style/FieldContents" + android:text="12,345" + android:tag="12345" + /> + </RadioGroup> + </LinearLayout> + <!-- setContentIntent --> - <RadioGroup - android:id="@+id/group_intent" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setContentIntent" /> - <RadioButton - android:id="@+id/intent_none" - style="@style/FieldContents" - android:text="none" - /> - <RadioButton - android:id="@+id/intent_alert" - style="@style/FieldContents" - android:text="alert" - /> - </RadioGroup> - + <RadioGroup + android:id="@+id/group_intent" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/intent_none" + style="@style/FieldContents" + android:text="none" + /> + <RadioButton + android:id="@+id/intent_alert" + style="@style/FieldContents" + android:text="alert" + /> + </RadioGroup> + </LinearLayout> + <!-- setDeleteIntent --> - <RadioGroup - android:id="@+id/group_delete" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setDeleteIntent" /> - <RadioButton - android:id="@+id/delete_none" - style="@style/FieldContents" - android:text="none" - /> - <RadioButton - android:id="@+id/delete_alert" - style="@style/FieldContents" - android:text="alert" - /> - </RadioGroup> - + <RadioGroup + android:id="@+id/group_delete" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/delete_none" + style="@style/FieldContents" + android:text="none" + /> + <RadioButton + android:id="@+id/delete_alert" + style="@style/FieldContents" + android:text="alert" + /> + </RadioGroup> + </LinearLayout> <!-- setFullScreenIntent --> <RadioGroup android:id="@+id/group_full_screen" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" + style="@style/FieldChoices" android:visibility="gone" > <TextView @@ -543,94 +556,94 @@ <!-- setTicker --> - <RadioGroup - android:id="@+id/group_ticker" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setTicker" /> - <RadioButton - android:id="@+id/ticker_none" - style="@style/FieldContents" - android:text="none" - android:tag="" - /> - <RadioButton - android:id="@+id/ticker_short" - style="@style/FieldContents" - android:text="short" - android:tag="tick" - /> - <RadioButton - android:id="@+id/ticker_wrap" - style="@style/FieldContents" - android:text="wrap" - android:tag="tick tick tick tock tock tock something fun has happened but i don't know what it is just yet" - /> - <RadioButton - android:id="@+id/ticker_haiku" - style="@style/FieldContents" - android:text="haiku" - android:tag="sholes final approach\nlanding gear punted to flan\nrunway foam glistens" - /> - <RadioButton - android:id="@+id/ticker_emoji" - style="@style/FieldContents" - android:text="emoji" - android:tag="_ Cactus _ Cactus _" - /> - <RadioButton - android:id="@+id/ticker_custom" - style="@style/FieldContents.Disabled" - android:text="custom view" - /> - </RadioGroup> - + <RadioGroup + android:id="@+id/group_ticker" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/ticker_none" + style="@style/FieldContents" + android:text="none" + android:tag="" + /> + <RadioButton + android:id="@+id/ticker_short" + style="@style/FieldContents" + android:text="short" + android:tag="tick" + /> + <RadioButton + android:id="@+id/ticker_wrap" + style="@style/FieldContents" + android:text="wrap" + android:tag="tick tick tick tock tock tock something fun has happened but i don't know what it is just yet" + /> + <RadioButton + android:id="@+id/ticker_haiku" + style="@style/FieldContents" + android:text="haiku" + android:tag="sholes final approach\nlanding gear punted to flan\nrunway foam glistens" + /> + <RadioButton + android:id="@+id/ticker_emoji" + style="@style/FieldContents" + android:text="emoji" + android:tag="_ Cactus _ Cactus _" + /> + <RadioButton + android:id="@+id/ticker_custom" + style="@style/FieldContents.Disabled" + android:text="custom view" + /> + </RadioGroup> + </LinearLayout> <!-- setLargeIcon --> - <RadioGroup - android:id="@+id/group_large_icon" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setLargeIcon" /> - <RadioButton - android:id="@+id/large_icon_none" - style="@style/FieldContents" - android:text="none" - /> - <RadioButton - android:id="@+id/large_icon_pineapple" - style="@style/FieldContents" - android:text="pineapple" - /> - <RadioButton - android:id="@+id/large_icon_pineapple2" - style="@style/FieldContents" - android:text="pineapple2" - /> - <RadioButton - android:id="@+id/large_icon_small" - style="@style/FieldContents" - android:text="small" - /> - </RadioGroup> - + <RadioGroup + android:id="@+id/group_large_icon" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/large_icon_none" + style="@style/FieldContents" + android:text="none" + /> + <RadioButton + android:id="@+id/large_icon_pineapple" + style="@style/FieldContents" + android:text="pineapple" + /> + <RadioButton + android:id="@+id/large_icon_pineapple2" + style="@style/FieldContents" + android:text="pineapple2" + /> + <RadioButton + android:id="@+id/large_icon_small" + style="@style/FieldContents" + android:text="small" + /> + </RadioGroup> + </LinearLayout> <!-- setSound --> <RadioGroup android:id="@+id/group_sound" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" + style="@style/FieldChoices" android:visibility="gone" > <TextView @@ -646,190 +659,260 @@ <!-- setVibrate --> - <RadioGroup - android:id="@+id/group_vibrate" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setVibrate" /> - <RadioButton - android:id="@+id/vibrate_none" - style="@style/FieldContents" - android:text="none" - /> - <RadioButton - android:id="@+id/vibrate_short" - style="@style/FieldContents" - android:text="short" - /> - <RadioButton - android:id="@+id/vibrate_medium" - style="@style/FieldContents" - android:text="long" - /> - <RadioButton - android:id="@+id/vibrate_long" - style="@style/FieldContents" - android:text="long" - /> - <RadioButton - android:id="@+id/vibrate_pattern" - style="@style/FieldContents" - android:text="longer" - /> - </RadioGroup> - + <RadioGroup + android:id="@+id/group_vibrate" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/vibrate_none" + style="@style/FieldContents" + android:text="none" + /> + <RadioButton + android:id="@+id/vibrate_zero" + style="@style/FieldContents" + android:text="0" + /> + <RadioButton + android:id="@+id/vibrate_short" + style="@style/FieldContents" + android:text="100" + /> + <RadioButton + android:id="@+id/vibrate_long" + style="@style/FieldContents" + android:text="1000" + /> + <RadioButton + android:id="@+id/vibrate_pattern" + style="@style/FieldContents" + android:text="...---..." + /> + </RadioGroup> + </LinearLayout> <!-- setLights --> - <RadioGroup - android:id="@+id/group_lights_color" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setLights (color)" /> - <RadioButton - android:id="@+id/lights_red" - style="@style/FieldContents" - android:text="red" - android:tag="0xff0000" - /> - <RadioButton - android:id="@+id/lights_green" - style="@style/FieldContents" - android:text="green" - android:tag="0x00ff00" - /> - <RadioButton - android:id="@+id/lights_blue" - style="@style/FieldContents" - android:text="blue" - android:tag="0x0000ff" - /> - <RadioButton - android:id="@+id/lights_cyan" - style="@style/FieldContents" - android:text="cyan" - android:tag="0x00ffff" - /> - <RadioButton - android:id="@+id/lights_magenta" - style="@style/FieldContents" - android:text="magenta" - android:tag="0xff00ff" - /> - <RadioButton - android:id="@+id/lights_yellow" - style="@style/FieldContents" - android:text="yellow" - android:tag="0xffff00" - /> - <RadioButton - android:id="@+id/lights_white" - style="@style/FieldContents" - android:text="white" - android:tag="0xffffff" - /> - </RadioGroup> + <RadioGroup + android:id="@+id/group_lights_color" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/lights_red" + style="@style/FieldContents" + android:text="red" + android:tag="0xff0000" + /> + <RadioButton + android:id="@+id/lights_green" + style="@style/FieldContents" + android:text="green" + android:tag="0x00ff00" + /> + <RadioButton + android:id="@+id/lights_blue" + style="@style/FieldContents" + android:text="blue" + android:tag="0x0000ff" + /> + <RadioButton + android:id="@+id/lights_cyan" + style="@style/FieldContents" + android:text="cyan" + android:tag="0x00ffff" + /> + <RadioButton + android:id="@+id/lights_magenta" + style="@style/FieldContents" + android:text="magenta" + android:tag="0xff00ff" + /> + <RadioButton + android:id="@+id/lights_yellow" + style="@style/FieldContents" + android:text="yellow" + android:tag="0xffff00" + /> + <RadioButton + android:id="@+id/lights_white" + style="@style/FieldContents" + android:text="white" + android:tag="0xffffff" + /> + </RadioGroup> + </LinearLayout> + + <!-- setPriority --> + <LinearLayout + style="@style/FieldGroup" + > + <TextView + style="@style/FieldTitle" + android:text="setPriority" + /> + <RadioGroup + android:id="@+id/group_priority" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/pri_max" + style="@style/FieldContents" + android:text="MAX" + /> + <RadioButton + android:id="@+id/pri_high" + style="@style/FieldContents" + android:text="HIGH" + /> + <RadioButton + android:id="@+id/pri_default" + style="@style/FieldContents" + android:text="DEFAULT" + /> + <RadioButton + android:id="@+id/pri_low" + style="@style/FieldContents" + android:text="LOW" + /> + <RadioButton + android:id="@+id/pri_min" + style="@style/FieldContents" + android:text="MIN" + /> + </RadioGroup> + </LinearLayout> <!-- setLights --> - <RadioGroup - android:id="@+id/group_lights_blink" - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + <LinearLayout + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="setLights (blink)" /> - <RadioButton - android:id="@+id/lights_off" - style="@style/FieldContents" - android:text="off" - /> - <RadioButton - android:id="@+id/lights_slow" - style="@style/FieldContents" - android:text="slow" - /> - <RadioButton - android:id="@+id/lights_fast" - style="@style/FieldContents" - android:text="fast" - /> - <RadioButton - android:id="@+id/lights_on" - style="@style/FieldContents" - android:text="on" - /> - </RadioGroup> - + <RadioGroup + android:id="@+id/group_lights_blink" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/lights_off" + style="@style/FieldContents" + android:text="off" + /> + <RadioButton + android:id="@+id/lights_slow" + style="@style/FieldContents" + android:text="slow" + /> + <RadioButton + android:id="@+id/lights_fast" + style="@style/FieldContents" + android:text="fast" + /> + <RadioButton + android:id="@+id/lights_on" + style="@style/FieldContents" + android:text="on" + /> + </RadioGroup> + </LinearLayout> + <!-- flags --> <LinearLayout - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - android:layout_marginTop="12dp" - > + style="@style/FieldGroup" + android:layout_marginTop="30dp" + > <TextView style="@style/FieldTitle" android:text="flags" /> - <CheckBox - android:id="@+id/flag_ongoing" - style="@style/FieldContents" - android:text="setOngoing" - /> - <CheckBox - android:id="@+id/flag_once" - style="@style/FieldContents" - android:text="setOnlyAlertOnce" - /> - <CheckBox - android:id="@+id/flag_auto_cancel" - style="@style/FieldContents" - android:text="setAutoCancel" - /> + <LinearLayout + style="@style/FieldChoices" + > + <CheckBox + android:id="@+id/flag_ongoing" + style="@style/FieldContents" + android:text="ongoing" + /> + <CheckBox + android:id="@+id/flag_once" + style="@style/FieldContents" + android:text="onlyAlertOnce" + /> + <CheckBox + android:id="@+id/flag_auto_cancel" + style="@style/FieldContents" + android:text="autoCancel" + /> + </LinearLayout> </LinearLayout> - + <!-- defaults --> <LinearLayout - android:layout_width="wrap_content" - android:layout_height="wrap_content" - android:orientation="horizontal" - > + style="@style/FieldGroup" + > <TextView style="@style/FieldTitle" android:text="defaults" /> - <CheckBox - android:id="@+id/default_sound" - style="@style/FieldContents" - android:text="sound" - /> - <CheckBox - android:id="@+id/default_vibrate" - style="@style/FieldContents" - android:text="vibrate" - /> - <CheckBox - android:id="@+id/default_lights" - style="@style/FieldContents" - android:text="lights" - /> + <LinearLayout + style="@style/FieldChoices" + > + <CheckBox + android:id="@+id/default_sound" + style="@style/FieldContents" + android:text="sound" + /> + <CheckBox + android:id="@+id/default_vibrate" + style="@style/FieldContents" + android:text="vibrate" + /> + <CheckBox + android:id="@+id/default_lights" + style="@style/FieldContents" + android:text="lights" + /> + </LinearLayout> </LinearLayout> - - - + <!-- delay --> + <LinearLayout + style="@style/FieldGroup" + > + <TextView + style="@style/FieldTitle" + android:text="notify" + /> + <RadioGroup + android:id="@+id/group_delay" + style="@style/FieldChoices" + > + <RadioButton + android:id="@+id/delay_none" + style="@style/FieldContents" + android:text="immediately" + /> + <RadioButton + android:id="@+id/delay_5" + style="@style/FieldContents" + android:text="in 5 sec" + /> + </RadioGroup> + </LinearLayout> </LinearLayout> </LinearLayout> diff --git a/tests/StatusBar/res/values/styles.xml b/tests/StatusBar/res/values/styles.xml index 103a25a..f2c9f0d 100644 --- a/tests/StatusBar/res/values/styles.xml +++ b/tests/StatusBar/res/values/styles.xml @@ -45,8 +45,10 @@ <style name="FieldTitle"> <item name="android:textAppearance">?android:attr/textAppearanceSmall</item> - <item name="android:layout_width">wrap_content</item> + <item name="android:layout_width">120dp</item> <item name="android:layout_height">wrap_content</item> + <item name="android:gravity">right</item> + <item name="android:textStyle">bold</item> </style> <style name="FieldContents"> @@ -61,5 +63,18 @@ <item name="android:visibility">gone</item> </style> + <style name="FieldGroup"> + <item name="android:layout_width">wrap_content</item> + <item name="android:layout_height">wrap_content</item> + <item name="android:orientation">horizontal</item> + <item name="android:layout_marginTop">18dp</item> + </style> + + <style name="FieldChoices"> + <item name="android:layout_width">wrap_content</item> + <item name="android:layout_height">wrap_content</item> + <item name="android:orientation">vertical</item> + <item name="android:baselineAlignedChildIndex">0</item> + </style> </resources> diff --git a/tests/StatusBar/src/com/android/statusbartest/NotificationBuilderTest.java b/tests/StatusBar/src/com/android/statusbartest/NotificationBuilderTest.java index 2f0c173..5d0b155 100644 --- a/tests/StatusBar/src/com/android/statusbartest/NotificationBuilderTest.java +++ b/tests/StatusBar/src/com/android/statusbartest/NotificationBuilderTest.java @@ -30,6 +30,7 @@ import android.graphics.drawable.BitmapDrawable; import android.net.Uri; import android.os.Bundle; import android.os.Environment; +import android.os.Handler; import android.os.Vibrator; import android.os.Handler; import android.text.SpannableStringBuilder; @@ -49,11 +50,14 @@ public class NotificationBuilderTest extends Activity private final static String TAG = "NotificationTestList"; NotificationManager mNM; + Handler mHandler; + int mStartDelay; @Override public void onCreate(Bundle icicle) { super.onCreate(icicle); mNM = (NotificationManager)getSystemService(NOTIFICATION_SERVICE); + mHandler = new Handler(); setContentView(R.layout.notification_builder_test); if (icicle == null) { setDefaults(); @@ -100,8 +104,13 @@ public class NotificationBuilderTest extends Activity setChecked(R.id.large_icon_none); setChecked(R.id.sound_none); setChecked(R.id.vibrate_none); + setChecked(R.id.pri_default); setChecked(R.id.lights_red); setChecked(R.id.lights_off); + setChecked(R.id.delay_none); +// setChecked(R.id.default_vibrate); +// setChecked(R.id.default_sound); +// setChecked(R.id.default_lights); } private View.OnClickListener mClickListener = new View.OnClickListener() { @@ -183,9 +192,13 @@ public class NotificationBuilderTest extends Activity } }; - private void sendNotification(int id) { + private void sendNotification(final int id) { final Notification n = buildNotification(id); - mNM.notify(id, n); + mHandler.postDelayed(new Runnable() { + public void run() { + mNM.notify(id, n); + } + }, mStartDelay); } private static CharSequence subst(CharSequence in, char ch, CharSequence sub) { @@ -323,23 +336,26 @@ public class NotificationBuilderTest extends Activity // vibrate switch (getRadioChecked(R.id.group_vibrate)) { case R.id.vibrate_none: + b.setVibrate(null); break; - case R.id.vibrate_short: - b.setVibrate(new long[] { 0, 200 }); + case R.id.vibrate_zero: + b.setVibrate(new long[] { 0 }); break; - case R.id.vibrate_medium: - b.setVibrate(new long[] { 0, 500 }); + case R.id.vibrate_short: + b.setVibrate(new long[] { 0, 100 }); break; case R.id.vibrate_long: b.setVibrate(new long[] { 0, 1000 }); break; case R.id.vibrate_pattern: - b.setVibrate(new long[] { 0, 250, 250, 250, 250, 250, 250, 250 }); + b.setVibrate(new long[] { 0, 50, 200, 50, 200, 50, 500, + 500, 200, 500, 200, 500, 500, + 50, 200, 50, 200, 50 }); break; } // lights - final int color = getRadioInt(R.id.group_lights_color, 0xff0000); + final int color = getRadioHex(R.id.group_lights_color, 0xff0000); int onMs; int offMs; switch (getRadioChecked(R.id.group_lights_blink)) { @@ -365,6 +381,35 @@ public class NotificationBuilderTest extends Activity b.setLights(color, onMs, offMs); } + // priority + switch (getRadioChecked(R.id.group_priority)) { + case R.id.pri_min: + b.setPriority(Notification.PRIORITY_MIN); + break; + case R.id.pri_low: + b.setPriority(Notification.PRIORITY_LOW); + break; + case R.id.pri_default: + b.setPriority(Notification.PRIORITY_DEFAULT); + break; + case R.id.pri_high: + b.setPriority(Notification.PRIORITY_HIGH); + break; + case R.id.pri_max: + b.setPriority(Notification.PRIORITY_MAX); + break; + } + + // start delay + switch (getRadioChecked(R.id.group_delay)) { + case R.id.delay_none: + mStartDelay = 0; + break; + case R.id.delay_5: + mStartDelay = 5000; + break; + } + // flags b.setOngoing(getChecked(R.id.flag_ongoing)); b.setOnlyAlertOnce(getChecked(R.id.flag_once)); @@ -383,7 +428,7 @@ public class NotificationBuilderTest extends Activity } b.setDefaults(defaults); - return b.getNotification(); + return b.build(); } private void setChecked(int id) { @@ -396,14 +441,14 @@ public class NotificationBuilderTest extends Activity return g.getCheckedRadioButtonId(); } - private CharSequence getRadioTag(int id) { + private String getRadioTag(int id) { final RadioGroup g = (RadioGroup)findViewById(id); final View v = findViewById(g.getCheckedRadioButtonId()); - return (CharSequence) v.getTag(); + return (String) v.getTag(); } private int getRadioInt(int id, int def) { - CharSequence str = getRadioTag(id); + String str = getRadioTag(id); if (TextUtils.isEmpty(str)) { return def; } else { @@ -415,6 +460,22 @@ public class NotificationBuilderTest extends Activity } } + private int getRadioHex(int id, int def) { + String str = getRadioTag(id); + if (TextUtils.isEmpty(str)) { + return def; + } else { + if (str.startsWith("0x")) { + str = str.substring(2); + } + try { + return Integer.parseInt(str.toString(), 16); + } catch (NumberFormatException ex) { + return def; + } + } + } + private boolean getChecked(int id) { final CompoundButton b = (CompoundButton)findViewById(id); return b.isChecked(); diff --git a/tools/aapt/Android.mk b/tools/aapt/Android.mk index d9b0681..5b88669 100644 --- a/tools/aapt/Android.mk +++ b/tools/aapt/Android.mk @@ -20,6 +20,7 @@ LOCAL_SRC_FILES := \ StringPool.cpp \ XMLNode.cpp \ ResourceFilter.cpp \ + ResourceIdCache.cpp \ ResourceTable.cpp \ Images.cpp \ Resource.cpp \ diff --git a/tools/aapt/ResourceIdCache.cpp b/tools/aapt/ResourceIdCache.cpp new file mode 100644 index 0000000..e03f4f6 --- /dev/null +++ b/tools/aapt/ResourceIdCache.cpp @@ -0,0 +1,107 @@ +// +// Copyright 2012 The Android Open Source Project +// +// Manage a resource ID cache. + +#define LOG_TAG "ResourceIdCache" + +#include <utils/String16.h> +#include <utils/Log.h> +#include "ResourceIdCache.h" +#include <map> +using namespace std; + + +static size_t mHits = 0; +static size_t mMisses = 0; +static size_t mCollisions = 0; + +static const size_t MAX_CACHE_ENTRIES = 2048; +static const android::String16 TRUE16("1"); +static const android::String16 FALSE16("0"); + +struct CacheEntry { + // concatenation of the relevant strings into a single instance + android::String16 hashedName; + uint32_t id; + + CacheEntry() {} + CacheEntry(const android::String16& name, uint32_t resId) : hashedName(name), id(resId) { } +}; + +static map< uint32_t, CacheEntry > mIdMap; + + +// djb2; reasonable choice for strings when collisions aren't particularly important +static inline uint32_t hashround(uint32_t hash, int c) { + return ((hash << 5) + hash) + c; /* hash * 33 + c */ +} + +static uint32_t hash(const android::String16& hashableString) { + uint32_t hash = 5381; + const char16_t* str = hashableString.string(); + while (int c = *str++) hash = hashround(hash, c); + return hash; +} + +namespace android { + +static inline String16 makeHashableName(const android::String16& package, + const android::String16& type, + const android::String16& name, + bool onlyPublic) { + String16 hashable = String16(name); + hashable += type; + hashable += package; + hashable += (onlyPublic ? TRUE16 : FALSE16); + return hashable; +} + +uint32_t ResourceIdCache::lookup(const android::String16& package, + const android::String16& type, + const android::String16& name, + bool onlyPublic) { + const String16 hashedName = makeHashableName(package, type, name, onlyPublic); + const uint32_t hashcode = hash(hashedName); + map<uint32_t, CacheEntry>::iterator item = mIdMap.find(hashcode); + if (item == mIdMap.end()) { + // cache miss + mMisses++; + return 0; + } + + // legit match? + if (hashedName == (*item).second.hashedName) { + mHits++; + return (*item).second.id; + } + + // collision + mCollisions++; + mIdMap.erase(hashcode); + return 0; +} + +// returns the resource ID being stored, for callsite convenience +uint32_t ResourceIdCache::store(const android::String16& package, + const android::String16& type, + const android::String16& name, + bool onlyPublic, + uint32_t resId) { + if (mIdMap.size() < MAX_CACHE_ENTRIES) { + const String16 hashedName = makeHashableName(package, type, name, onlyPublic); + const uint32_t hashcode = hash(hashedName); + mIdMap[hashcode] = CacheEntry(hashedName, resId); + } + return resId; +} + +void ResourceIdCache::dump() { + printf("ResourceIdCache dump:\n"); + printf("Size: %ld\n", mIdMap.size()); + printf("Hits: %ld\n", mHits); + printf("Misses: %ld\n", mMisses); + printf("(Collisions: %ld)\n", mCollisions); +} + +} diff --git a/tools/aapt/ResourceIdCache.h b/tools/aapt/ResourceIdCache.h new file mode 100644 index 0000000..65f7781 --- /dev/null +++ b/tools/aapt/ResourceIdCache.h @@ -0,0 +1,30 @@ +// +// Copyright 2012 The Android Open Source Project +// +// Manage a resource ID cache. + +#ifndef RESOURCE_ID_CACHE_H +#define RESOURCE_ID_CACHE_H + +namespace android { +class android::String16; + +class ResourceIdCache { +public: + static uint32_t lookup(const android::String16& package, + const android::String16& type, + const android::String16& name, + bool onlyPublic); + + static uint32_t store(const android::String16& package, + const android::String16& type, + const android::String16& name, + bool onlyPublic, + uint32_t resId); + + static void dump(void); +}; + +} + +#endif diff --git a/tools/aapt/ResourceTable.cpp b/tools/aapt/ResourceTable.cpp index 3d7b088..52ebaf0 100644 --- a/tools/aapt/ResourceTable.cpp +++ b/tools/aapt/ResourceTable.cpp @@ -8,6 +8,7 @@ #include "XMLNode.h" #include "ResourceFilter.h" +#include "ResourceIdCache.h" #include <androidfw/ResourceTypes.h> #include <utils/ByteOrder.h> @@ -1998,6 +1999,9 @@ uint32_t ResourceTable::getResId(const String16& package, const String16& name, bool onlyPublic) const { + uint32_t id = ResourceIdCache::lookup(package, type, name, onlyPublic); + if (id != 0) return id; // cache hit + sp<Package> p = mPackages.valueFor(package); if (p == NULL) return 0; @@ -2016,11 +2020,10 @@ uint32_t ResourceTable::getResId(const String16& package, } if (Res_INTERNALID(rid)) { - return rid; + return ResourceIdCache::store(package, type, name, onlyPublic, rid); } - return Res_MAKEID(p->getAssignedId()-1, - Res_GETTYPE(rid), - Res_GETENTRY(rid)); + return ResourceIdCache::store(package, type, name, onlyPublic, + Res_MAKEID(p->getAssignedId()-1, Res_GETTYPE(rid), Res_GETENTRY(rid))); } sp<Type> t = p->getTypes().valueFor(type); @@ -2029,7 +2032,9 @@ uint32_t ResourceTable::getResId(const String16& package, if (c == NULL) return 0; int32_t ei = c->getEntryIndex(); if (ei < 0) return 0; - return getResId(p, t, ei); + + return ResourceIdCache::store(package, type, name, onlyPublic, + getResId(p, t, ei)); } uint32_t ResourceTable::getResId(const String16& ref, |
