diff --git a/core/api/current.txt b/core/api/current.txt index 7ed8b6c17574e..da572dbfd0e6a 100644 --- a/core/api/current.txt +++ b/core/api/current.txt @@ -46801,6 +46801,11 @@ package android.view { method public void onActionProviderVisibilityChanged(boolean); } + @UiThread public interface AttachedSurfaceControl { + method public boolean applyTransactionOnDraw(@NonNull android.view.SurfaceControl.Transaction); + method @Nullable public android.view.SurfaceControl.Transaction buildReparentTransaction(@NonNull android.view.SurfaceControl); + } + public final class Choreographer { method public static android.view.Choreographer getInstance(); method public void postFrameCallback(android.view.Choreographer.FrameCallback); @@ -48701,6 +48706,7 @@ package android.view { method public final int getRight(); method protected float getRightFadingEdgeStrength(); method protected int getRightPaddingOffset(); + method @Nullable public android.view.AttachedSurfaceControl getRootSurfaceControl(); method public android.view.View getRootView(); method public android.view.WindowInsets getRootWindowInsets(); method public float getRotation(); @@ -48745,7 +48751,6 @@ package android.view { method @Nullable public android.graphics.drawable.Drawable getVerticalScrollbarThumbDrawable(); method @Nullable public android.graphics.drawable.Drawable getVerticalScrollbarTrackDrawable(); method public int getVerticalScrollbarWidth(); - method @Nullable public android.view.ViewRoot getViewRoot(); method @Nullable public android.view.translation.ViewTranslationResponse getViewTranslationResponse(); method public android.view.ViewTreeObserver getViewTreeObserver(); method public int getVisibility(); @@ -49821,11 +49826,6 @@ package android.view { method public android.view.ViewPropertyAnimator zBy(float); } - @UiThread public interface ViewRoot { - method public boolean applyTransactionOnDraw(@NonNull android.view.SurfaceControl.Transaction); - method @Nullable public android.view.SurfaceControl.Transaction buildReparentTransaction(@NonNull android.view.SurfaceControl); - } - public abstract class ViewStructure { ctor public ViewStructure(); method public abstract int addChildCount(int); @@ -50012,6 +50012,7 @@ package android.view { method @ColorInt public int getNavigationBarDividerColor(); method public android.transition.Transition getReenterTransition(); method public android.transition.Transition getReturnTransition(); + method @Nullable public android.view.AttachedSurfaceControl getRootSurfaceControl(); method public android.transition.Transition getSharedElementEnterTransition(); method public android.transition.Transition getSharedElementExitTransition(); method public android.transition.Transition getSharedElementReenterTransition(); @@ -50021,7 +50022,6 @@ package android.view { method @NonNull public java.util.List getSystemGestureExclusionRects(); method public long getTransitionBackgroundFadeDuration(); method public android.transition.TransitionManager getTransitionManager(); - method @Nullable public android.view.ViewRoot getViewRoot(); method public abstract int getVolumeControlStream(); method public android.view.WindowManager getWindowManager(); method public final android.content.res.TypedArray getWindowStyle(); diff --git a/core/java/android/view/ViewRoot.java b/core/java/android/view/AttachedSurfaceControl.java similarity index 70% rename from core/java/android/view/ViewRoot.java rename to core/java/android/view/AttachedSurfaceControl.java index 3c755981a4400..bcc5b56459bbd 100644 --- a/core/java/android/view/ViewRoot.java +++ b/core/java/android/view/AttachedSurfaceControl.java @@ -22,16 +22,19 @@ import android.annotation.UiThread; /** * Provides an interface to the root-Surface of a View Hierarchy or Window. This * is used in combination with the {@link android.view.SurfaceControl} API to enable - * attaching app created SurfaceControl to the ViewRoot's surface hierarchy, and enable - * SurfaceTransactions to be performed in sync with the ViewRoot drawing. This object - * is obtained from {@link android.view.View#getViewRoot} and - * {@link android.view.Window#getViewRoot}. It must be used from the UI thread of + * attaching app created SurfaceControl to the SurfaceControl hierarchy used + * by the app, and enable SurfaceTransactions to be performed in sync with the + * View hierarchy drawing. + * + * This object is obtained from {@link android.view.View#getRootSurfaceControl} and + * {@link android.view.Window#getRootSurfaceControl}. It must be used from the UI thread of * the object it was obtained from. */ @UiThread -public interface ViewRoot { +public interface AttachedSurfaceControl { /** - * Create a transaction which will reparent {@param child} to the ViewRoot. See + * Create a transaction which will reparent {@param child} to the View hierarchy + * root SurfaceControl. See * {@link SurfaceControl.Transaction#reparent}. This transacton must be applied * or merged in to another transaction by the caller, otherwise it will have * no effect. @@ -42,9 +45,9 @@ public interface ViewRoot { @Nullable SurfaceControl.Transaction buildReparentTransaction(@NonNull SurfaceControl child); /** - * Consume the passed in transaction, and request the ViewRoot to apply it with the - * next draw. This transaction will be merged with the buffer transaction from the ViewRoot - * and they will show up on-screen atomically synced. + * Consume the passed in transaction, and request the View hierarchy to apply it atomically + * with the next draw. This transaction will be merged with the buffer transaction from the + * ViewRoot and they will show up on-screen atomically synced. * * This will not cause a draw to be scheduled, and if there are no other changes * to the View hierarchy you may need to call {@link android.view.View#invalidate} diff --git a/core/java/android/view/View.java b/core/java/android/view/View.java index 11fac05619078..72103dccff2e4 100644 --- a/core/java/android/view/View.java +++ b/core/java/android/view/View.java @@ -29594,7 +29594,7 @@ public class View implements Drawable.Callback, KeyEvent.Callback, return mScrollCaptureInternal; } - ViewRoot getViewRoot() { + AttachedSurfaceControl getRootSurfaceControl() { return mViewRootImpl; } @@ -31038,17 +31038,17 @@ public class View implements Drawable.Callback, KeyEvent.Callback, } /** - * @return The {@link android.view.ViewRoot} interface for this View. This will only - * return a non-null value when called between {@link #onAttachedToWindow} and - * {@link #onDetachedFromWindow}. - * - * The ViewRoot itself is not a View, it is just the interface to the windowing-system - * object that contains the entire view hierarchy. For the root View of a given hierarchy - * see {@link #getRootView}. + * The AttachedSurfaceControl itself is not a View, it is just the interface to the + * windowing-system object that contains the entire view hierarchy. + * For the root View of a given hierarchy see {@link #getRootView}. + + * @return The {@link android.view.AttachedSurfaceControl} interface for this View. + * This will only return a non-null value when called between {@link #onAttachedToWindow} + * and {@link #onDetachedFromWindow}. */ - public @Nullable ViewRoot getViewRoot() { + public @Nullable AttachedSurfaceControl getRootSurfaceControl() { if (mAttachInfo != null) { - return mAttachInfo.getViewRoot(); + return mAttachInfo.getRootSurfaceControl(); } return null; } diff --git a/core/java/android/view/ViewRootImpl.java b/core/java/android/view/ViewRootImpl.java index 0958f3fbd771b..78d4e42916df0 100644 --- a/core/java/android/view/ViewRootImpl.java +++ b/core/java/android/view/ViewRootImpl.java @@ -224,7 +224,8 @@ import java.util.concurrent.CountDownLatch; */ @SuppressWarnings({"EmptyCatchBlock", "PointlessBooleanExpression"}) public final class ViewRootImpl implements ViewParent, - View.AttachInfo.Callbacks, ThreadedRenderer.DrawCallbacks, ViewRoot { + View.AttachInfo.Callbacks, ThreadedRenderer.DrawCallbacks, + AttachedSurfaceControl { private static final String TAG = "ViewRootImpl"; private static final boolean DBG = false; private static final boolean LOCAL_LOGV = false; diff --git a/core/java/android/view/Window.java b/core/java/android/view/Window.java index 52a09701803d9..5fb4e705c8313 100644 --- a/core/java/android/view/Window.java +++ b/core/java/android/view/Window.java @@ -2722,11 +2722,12 @@ public abstract class Window { /** * This will be null before a content view is added, e.g. via - * {@link #setContentView} or {@link #addContentView}. + * {@link #setContentView} or {@link #addContentView}. See + * {@link android.view.View#getRootSurfaceControl}. * - * @return The {@link android.view.ViewRoot} interface for this Window + * @return The {@link android.view.AttachedSurfaceControl} interface for this Window */ - public @Nullable ViewRoot getViewRoot() { + public @Nullable AttachedSurfaceControl getRootSurfaceControl() { return null; } } diff --git a/core/java/com/android/internal/policy/PhoneWindow.java b/core/java/com/android/internal/policy/PhoneWindow.java index a6dc4e04bf365..0ea299ddef010 100644 --- a/core/java/com/android/internal/policy/PhoneWindow.java +++ b/core/java/com/android/internal/policy/PhoneWindow.java @@ -70,12 +70,12 @@ import android.transition.TransitionInflater; import android.transition.TransitionManager; import android.transition.TransitionSet; import android.util.AndroidRuntimeException; +import android.view.AttachedSurfaceControl; import android.util.EventLog; import android.util.Log; import android.util.Pair; import android.util.SparseArray; import android.util.TypedValue; -import android.view.ViewRoot; import android.view.ContextThemeWrapper; import android.view.CrossWindowBlurListeners; import android.view.Gravity; @@ -3984,7 +3984,7 @@ public class PhoneWindow extends Window implements MenuBuilder.Callback { } @Override - public ViewRoot getViewRoot() { + public AttachedSurfaceControl getRootSurfaceControl() { return getViewRootImplOrNull(); } }