1 /* 2 Copyright 2016 The Android Open Source Project 3 4 Licensed under the Apache License, Version 2.0 (the "License"); 5 you may not use this file except in compliance with the License. 6 You may obtain a copy of the License at 7 8 http://www.apache.org/licenses/LICENSE-2.0 9 10 Unless required by applicable law or agreed to in writing, software 11 distributed under the License is distributed on an "AS IS" BASIS, 12 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 See the License for the specific language governing permissions and 14 limitations under the License. 15 */ 16 package com.example.android.wearable.wear.wearnotifications; 17 18 import android.support.v7.app.NotificationCompat; 19 20 /** 21 * We use a Singleton for a global copy of the NotificationCompat.Builder to update active 22 * Notifications from other Services/Activities. 23 * 24 * You have two options for updating your notifications: 25 * 26 * 1. Use a new NotificationCompatBuilder to create the Notification. This approach requires you 27 * to get *ALL* the information and pass it to the builder. We get all the information from a Mock 28 * Database and this is the approach used in the MainActivity. 29 * 30 * 2. Use an existing NotificationCompatBuilder to create a Notification. This approach requires 31 * you to store a reference to the original builder. The benefit is you only need the new/updated 32 * information for an existing notification. We use this approach in the IntentService handlers to 33 * update existing notifications. 34 * 35 * IMPORTANT NOTE 1: You shouldn't save/modify the resulting Notification object using 36 * its member variables and/or legacy APIs. If you want to retain anything from update 37 * to update, retain the Builder as option 2 outlines. 38 * 39 * IMPORTANT NOTE 2: If the global Notification Builder is lost because the process is killed, you 40 * should have a way to recreate the Notification Builder from a persistent state. (We do this as 41 * well in the sample, check the IntentServices.) 42 */ 43 public final class GlobalNotificationBuilder { 44 45 private static NotificationCompat.Builder sGlobalNotificationCompatBuilder = null; 46 47 /* 48 * Empty constructor - We don't initialize builder because we rely on a null state to let us 49 * know the Application's process was killed. 50 */ 51 private GlobalNotificationBuilder () { } 52 53 public static void setNotificationCompatBuilderInstance (NotificationCompat.Builder builder) { 54 sGlobalNotificationCompatBuilder = builder; 55 } 56 57 public static NotificationCompat.Builder getNotificationCompatBuilderInstance(){ 58 return sGlobalNotificationCompatBuilder; 59 } 60 }
