Initial checkin of AOSP Messaging app.

b/23110861

Change-Id: I11db999bd10656801e618f78ab2b2ef74136fff1

src/com/android/messaging/widget/BaseWidgetProvider.java

@@ -0,0 +1,184 @@
+/*
+ * Copyright (C) 2015 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.messaging.widget;
+
+import android.appwidget.AppWidgetManager;
+import android.appwidget.AppWidgetProvider;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Bundle;
+
+import com.android.messaging.util.LogUtil;
+
+public abstract class BaseWidgetProvider extends AppWidgetProvider {
+    protected static final String TAG = LogUtil.BUGLE_WIDGET_TAG;
+
+    public static final int WIDGET_CONVERSATION_REQUEST_CODE = 987;
+
+    static final String WIDGET_SIZE_KEY = "widgetSizeKey";
+
+    public static final int SIZE_LARGE  = 0;    // undefined == 0, which is the default, large
+    public static final int SIZE_SMALL  = 1;
+    public static final int SIZE_MEDIUM = 2;
+    public static final int SIZE_PRE_JB = 3;
+
+    /**
+     * Update all widgets in the list
+     */
+    @Override
+    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        super.onUpdate(context, appWidgetManager, appWidgetIds);
+
+        for (int i = 0; i < appWidgetIds.length; ++i) {
+            updateWidget(context, appWidgetIds[i]);
+        }
+    }
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        if (LogUtil.isLoggable(TAG, LogUtil.VERBOSE)) {
+            LogUtil.v(TAG, "onReceive intent: " + intent + " for " + this.getClass());
+        }
+        final String action = intent.getAction();
+
+        // The base class AppWidgetProvider's onReceive handles the normal widget intents. Here
+        // we're looking for an intent sent by our app when it knows a message has
+        // been sent or received (or a conversation has been read) and is telling the widget it
+        // needs to update.
+        if (getAction().equals(action)) {
+            final AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
+            final int[] appWidgetIds = appWidgetManager.getAppWidgetIds(new ComponentName(context,
+                    this.getClass()));
+
+            if (appWidgetIds.length > 0) {
+                // We need to update all Bugle app widgets on the home screen.
+                if (LogUtil.isLoggable(TAG, LogUtil.VERBOSE)) {
+                    LogUtil.v(TAG, "onReceive notifyAppWidgetViewDataChanged listId: " +
+                            getListId() + " first widgetId: " + appWidgetIds[0]);
+                }
+                appWidgetManager.notifyAppWidgetViewDataChanged(appWidgetIds, getListId());
+            }
+        } else {
+            super.onReceive(context, intent);
+        }
+    }
+
+    protected abstract String getAction();
+
+    protected abstract int getListId();
+
+    /**
+     * Update the widget appWidgetId
+     */
+    protected abstract void updateWidget(Context context, int appWidgetId);
+
+    private int getWidgetSize(AppWidgetManager appWidgetManager,
+        int appWidgetId) {
+      if (LogUtil.isLoggable(TAG, LogUtil.VERBOSE)) {
+        LogUtil.v(TAG, "BaseWidgetProvider.getWidgetSize");
+      }
+
+      // Get the dimensions
+      final Bundle options = appWidgetManager.getAppWidgetOptions(appWidgetId);
+
+      // Get min width and height.
+      final int minWidth = options.getInt(AppWidgetManager.OPTION_APPWIDGET_MIN_WIDTH);
+      final int minHeight = options.getInt(AppWidgetManager.OPTION_APPWIDGET_MIN_HEIGHT);
+
+      // First find out rows and columns based on width provided.
+      final int rows = getCellsForSize(minHeight);
+      final int columns = getCellsForSize(minWidth);
+
+      if (LogUtil.isLoggable(TAG, LogUtil.VERBOSE)) {
+        LogUtil.v(TAG, "BaseWidgetProvider.getWidgetSize row: " + rows +
+            " columns: " + columns);
+      }
+
+      int size = SIZE_MEDIUM;
+      if (rows == 1) {
+        size = SIZE_SMALL;      // Our widget doesn't let itself get this small. Perhaps in the
+                                // future will add a super-mini widget.
+      } else if (columns > 3) {
+        size = SIZE_LARGE;
+      }
+
+      // put the size in the bundle so our service know what size it's dealing with.
+      final int savedSize = options.getInt(WIDGET_SIZE_KEY);
+      if (savedSize != size) {
+        options.putInt(WIDGET_SIZE_KEY, size);
+        appWidgetManager.updateAppWidgetOptions(appWidgetId, options);
+
+        // The size changed. We have to force the widget to rebuild the list.
+        appWidgetManager.notifyAppWidgetViewDataChanged(appWidgetId, getListId());
+
+        if (LogUtil.isLoggable(TAG, LogUtil.VERBOSE)) {
+          LogUtil.v(TAG, "BaseWidgetProvider.getWidgetSize old size: " + savedSize +
+              " new size saved: " + size);
+        }
+      }
+
+      return size;
+    }
+
+    /**
+     * Returns number of cells needed for given size of the widget.
+     *
+     * @param size Widget size in dp.
+     * @return Size in number of cells.
+     */
+    private static int getCellsForSize(int size) {
+      // The hardwired sizes in this function come from the hardwired formula found in
+      // Android's UI guidelines for widget design:
+      // http://developer.android.com/guide/practices/ui_guidelines/widget_design.html
+      return (size + 30) / 70;
+    }
+
+    @Override
+    public void onAppWidgetOptionsChanged(Context context, AppWidgetManager appWidgetManager,
+            int appWidgetId, Bundle newOptions) {
+
+        final int widgetSize = getWidgetSize(appWidgetManager, appWidgetId);
+
+        if (LogUtil.isLoggable(TAG, LogUtil.VERBOSE)) {
+            LogUtil.v(TAG, "BaseWidgetProvider.onAppWidgetOptionsChanged new size: " +
+                    widgetSize);
+        }
+
+        super.onAppWidgetOptionsChanged(context, appWidgetManager, appWidgetId, newOptions);
+    }
+
+    protected void deletePreferences(final int widgetId) {
+    }
+
+    /**
+     * Remove preferences when deleting widget
+     */
+    @Override
+    public void onDeleted(Context context, int[] appWidgetIds) {
+        super.onDeleted(context, appWidgetIds);
+
+        if (LogUtil.isLoggable(TAG, LogUtil.VERBOSE)) {
+            LogUtil.v(TAG, "BaseWidgetProvider.onDeleted");
+        }
+
+        for (final int widgetId : appWidgetIds) {
+            deletePreferences(widgetId);
+        }
+    }
+
+}