[Android] Add public API for Browser Action in support library

customtabs/src/android/support/customtabs/browseraction/BrowserActionItem.java

+/*
+ * Copyright (C) 2017 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 android.support.customtabs.browseraction;
+
+import android.app.PendingIntent;
+import android.graphics.Bitmap;
+
+/**
+ * A wrapper class holding custom item for browser action menu.
+ * The Bitmap is optional for a BrowserActionItem.
+ */
+public class BrowserActionItem {
+    private String mTitle;

[Yusuf, 2017/04/03 18:00:49]

final for title and action

[ltian, 2017/04/05 01:44:28]

Done.

+    private PendingIntent mAction;
+    private Bitmap mIcon;
+
+    /**
+     * Constructor for BrowserActionItem with icon, string and action provided.
+     * @param icon The icon shown for a custom item.
+     * @param title The string shown for a custom item.
+     * @param action The PendingIntent executed when a custom item is selected
+     */
+    public BrowserActionItem(String title, PendingIntent action, Bitmap icon) {

[Yusuf, 2017/04/03 18:00:49]

@Nonnull for the two that cant be null

[ltian, 2017/04/05 01:44:29]

Done.

+        mTitle = title;
+        mAction = action;
+        mIcon = icon;
+    }
+
+    /**
+     * Constructor for BrowserActionItem with only string and action provided.
+     * @param title The icon shown for a custom item.
+     * @param action The string shown for a custom item.
+     */
+    public BrowserActionItem(String title, PendingIntent action) {

[Yusuf, 2017/04/03 18:00:49]

@NonNull for both

[ltian, 2017/04/05 01:44:29]

Done.

+        mTitle = title;

[Yusuf, 2017/04/03 18:00:49]

call the above constructor with params set from here.

[ltian, 2017/04/05 01:44:28]

Done.

+        mAction = action;
+    }
+
+    public void setIcon(Bitmap icon) {

[Yusuf, 2017/04/03 18:00:48]

javadocs here and on other getters.

[ltian, 2017/04/05 01:44:29]

Done.

+        mIcon = icon;
+    }
+
+    public Bitmap getIcon() {
+        return mIcon;
+    }
+
+    public String getTitle() {
+        return mTitle;
+    }
+
+    public PendingIntent getAction() {
+        return mAction;
+    }
+}