[Custom Tabs] Allow clients to display RemoteViews on the bottom bar

chrome/android/java/src/android/support/customtabs/CustomTabsIntent.java

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 package android.support.customtabs;
 
 import android.app.Activity;
 import android.app.ActivityOptions;
 import android.app.PendingIntent;
 import android.content.Intent;
 import android.graphics.Bitmap;
 import android.graphics.Color;
 import android.net.Uri;
 import android.os.Build;
 import android.os.Bundle;
 import android.os.IBinder;
+import android.widget.RemoteViews;
 
 import java.lang.reflect.InvocationTargetException;
 import java.lang.reflect.Method;
 import java.util.ArrayList;
 
 /**
  * Constants and utilities that will be used for low level control on customizing the UI and
  * functionality of a tab.
  */
 public class CustomTabsIntent {
@@ skipping 128 matching lines @@
     public static final int TOOLBAR_ACTION_BUTTON_ID = 0;
 
     /**
      * Extra that changes the background color for the secondary toolbar. The value should be an
      * int that specifies a {@link Color}, not a resource id.
      */
     public static final String EXTRA_SECONDARY_TOOLBAR_COLOR =
             "android.support.customtabs.extra.SECONDARY_TOOLBAR_COLOR";
 
     /**
+     * Extra that specifies the {@link RemoteViews} showing on the secondary toolbar. If this extra
+     * is set, the other secondary toolbar configurations will be overriden. The height of the
+     * {@link RemoteViews} should not exceed 56dp.
+     */
+    public static final String EXTRA_SECONDARY_TOOLBAR_REMOTEVIEWS =
+            "android.support.customtabs.extra.EXTRA_SECONDARY_TOOLBAR_REMOTEVIEWS";
+
+    /**
      * Convenience method to create a VIEW intent without a session for the given package.
      * @param packageName The package name to set in the intent.
      * @param data        The data {@link Uri} to be used in the intent.
      * @return            The intent with the given package, data and the right session extra.
      */
     public static Intent getViewIntentWithNoSession(String packageName, Uri data) {
         Intent intent = new Intent(Intent.ACTION_VIEW, data);
         intent.setPackage(packageName);
         Bundle extras = new Bundle();
         if (!safePutBinder(extras, EXTRA_SESSION, null)) return null;
@@ skipping 18 matching lines @@
                         Bundle.class.getMethod("putIBinder", String.class, IBinder.class);
                 putBinderMethod.invoke(bundle, key, binder);
             }
         } catch (InvocationTargetException | IllegalAccessException | IllegalArgumentException
                 | NoSuchMethodException e) {
             return false;
         }
         return true;
     }
 }