1 /* 2 * Copyright (C) 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 }
