Skip to content
This repository was archived by the owner on Feb 25, 2025. It is now read-only.
Merged
2 changes: 2 additions & 0 deletions ci/licenses_golden/licenses_flutter
Original file line number Diff line number Diff line change
Expand Up @@ -43358,6 +43358,7 @@ ORIGIN: ../../../flutter/shell/platform/android/io/flutter/embedding/android/Flu
ORIGIN: ../../../flutter/shell/platform/android/io/flutter/embedding/android/FlutterSurfaceView.java + ../../../flutter/LICENSE
ORIGIN: ../../../flutter/shell/platform/android/io/flutter/embedding/android/FlutterTextureView.java + ../../../flutter/LICENSE
ORIGIN: ../../../flutter/shell/platform/android/io/flutter/embedding/android/FlutterView.java + ../../../flutter/LICENSE
ORIGIN: ../../../flutter/shell/platform/android/io/flutter/embedding/android/FlutterViewDelegate.java + ../../../flutter/LICENSE
ORIGIN: ../../../flutter/shell/platform/android/io/flutter/embedding/android/KeyChannelResponder.java + ../../../flutter/LICENSE
ORIGIN: ../../../flutter/shell/platform/android/io/flutter/embedding/android/KeyData.java + ../../../flutter/LICENSE
ORIGIN: ../../../flutter/shell/platform/android/io/flutter/embedding/android/KeyEmbedderResponder.java + ../../../flutter/LICENSE
Expand Down Expand Up @@ -46250,6 +46251,7 @@ FILE: ../../../flutter/shell/platform/android/io/flutter/embedding/android/Flutt
FILE: ../../../flutter/shell/platform/android/io/flutter/embedding/android/FlutterSurfaceView.java
FILE: ../../../flutter/shell/platform/android/io/flutter/embedding/android/FlutterTextureView.java
FILE: ../../../flutter/shell/platform/android/io/flutter/embedding/android/FlutterView.java
FILE: ../../../flutter/shell/platform/android/io/flutter/embedding/android/FlutterViewDelegate.java
FILE: ../../../flutter/shell/platform/android/io/flutter/embedding/android/KeyChannelResponder.java
FILE: ../../../flutter/shell/platform/android/io/flutter/embedding/android/KeyData.java
FILE: ../../../flutter/shell/platform/android/io/flutter/embedding/android/KeyEmbedderResponder.java
Expand Down
1 change: 1 addition & 0 deletions shell/platform/android/BUILD.gn
Original file line number Diff line number Diff line change
Expand Up @@ -228,6 +228,7 @@ android_java_sources = [
"io/flutter/embedding/android/FlutterSurfaceView.java",
"io/flutter/embedding/android/FlutterTextureView.java",
"io/flutter/embedding/android/FlutterView.java",
"io/flutter/embedding/android/FlutterViewDelegate.java",
"io/flutter/embedding/android/KeyChannelResponder.java",
"io/flutter/embedding/android/KeyData.java",
"io/flutter/embedding/android/KeyEmbedderResponder.java",
Expand Down
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Digging into go/customizable-window-headers I found APPEARANCE_TRANSPARENT_CAPTION_BAR_BACKGROUND Can you test an app with that flag set vs the default and come up with a recommendation on if we should apply transparent caption bar by default or not?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This comment should not be considered blocking.

Original file line number Diff line number Diff line change
Expand Up @@ -1449,6 +1449,13 @@ public void removeFlutterEngineAttachmentListener(
.send();
}

private FlutterViewDelegate delegate = new FlutterViewDelegate();

@VisibleForTesting
public void setDelegate(@NonNull FlutterViewDelegate delegate) {
this.delegate = delegate;
}

private void sendViewportMetricsToFlutter() {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking at the design of this class I am seeing a pattern of the flutterView having methods that trigger on different android lifecycle events, Then ViewportMetrics being updated then at the end of that triggering method calling sendViewportMetricsToFlutter.

Looking at this code we do the calculation every send. When I was searching internally I did not find documentation of a lifecycle method to trigger on so maybe this is moot. If this code moved to onApplyWindowInsets would it still work?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I just tested this, and it looks good. I've moved it to onApplyWindowInsets after the existing calculations.

if (!isAttachedToFlutterEngine()) {
Log.w(
Expand All @@ -1460,6 +1467,13 @@ private void sendViewportMetricsToFlutter() {

viewportMetrics.devicePixelRatio = getResources().getDisplayMetrics().density;
viewportMetrics.physicalTouchSlop = ViewConfiguration.get(getContext()).getScaledTouchSlop();

if (Build.VERSION.SDK_INT >= API_LEVELS.API_35) {
delegate.growViewportMetricsToCaptionBar(getContext(), viewportMetrics);
} else {
Log.w(TAG, "API level " + Build.VERSION.SDK_INT + " is too low to query bounding rects.");
}

flutterEngine.getRenderer().setViewportMetrics(viewportMetrics);
}

Expand All @@ -1485,6 +1499,15 @@ public void setVisibility(int visibility) {
}
}

/**
* Allow access to the viewport metrics so that tests can set them to be valid with nonzero
* dimensions.
*/
@VisibleForTesting
public FlutterRenderer.ViewportMetrics getViewportMetrics() {
return viewportMetrics;
}

/**
* Listener that is notified when a {@link io.flutter.embedding.engine.FlutterEngine} is attached
* to/detached from a given {@code FlutterView}.
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
// Copyright 2013 The Flutter 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 io.flutter.embedding.android;

import android.app.Activity;
import android.content.Context;
import android.graphics.Rect;
import android.view.Window;
import android.view.WindowInsets;
import androidx.annotation.RequiresApi;
import androidx.annotation.VisibleForTesting;
import io.flutter.Build;
import io.flutter.embedding.engine.renderer.FlutterRenderer;
import io.flutter.util.ViewUtils;
import java.util.Collections;
import java.util.List;

/**
* A delegate class that performs the task of retrieving the bounding rect values. Logic that is
* independent of the engine, or that tests must access in the absence of an engine, shall reside
* within this class.
*/
public class FlutterViewDelegate {
/**
* Return the WindowInsets object for the provided Context. Returns null if there is no associated
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you document when 2 different context objects might have different windowInsets?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you explain why this detail is relevant documentation to this method? I'm not sure I see the throughline.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The dart docs is a hint for callers and for maintainers to help understand the behavior of the code documented. The existing dart doc, as written, helps a little bit by describing the null behavior but it could be more helpful if it describe when context might change. That is because the caller can know for their use case of FlutterViewDelegate if it matters which context to pass.

For example if the android documentation indicates that window insets will always be the same for an app regardless of which of the apps context is used it indicated to the caller that it might be safe in situations when launching another activity to use the application context. However if insets might change across activities maybe because of their window flags then it is important to use one FlutterViewDelate per activity.

* activity, the window of the associated activity is null, or the root window insets of the
* activity's window is null.
*/
@RequiresApi(api = Build.API_LEVELS.API_23)
@VisibleForTesting
public WindowInsets getWindowInsets(Context context) {
Activity activity = ViewUtils.getActivity(context);
if (activity == null) {
return null;
}
Window window = activity.getWindow();
if (window == null) {
return null;
}
return window.getDecorView().getRootWindowInsets();
}

@RequiresApi(api = Build.API_LEVELS.API_35)
public List<Rect> getCaptionBarInsets(Context context) {
WindowInsets insets = getWindowInsets(context);
if (insets == null) {
return Collections.emptyList();
}
return insets.getBoundingRects(WindowInsets.Type.captionBar());
}

@RequiresApi(api = Build.API_LEVELS.API_35)
public void growViewportMetricsToCaptionBar(
Context context, FlutterRenderer.ViewportMetrics viewportMetrics) {
List<Rect> boundingRects = getCaptionBarInsets(context);
if (boundingRects.size() != 1) {
return;
}
// The value getCaptionBarInset returns is only the bounding rects of the caption bar.
// When assigning the new value of viewPaddingTop, the maximum is taken with its old value
// to ensure that any previous top padding that is greater than that from the caption bar
// is not destroyed by this operation.
viewportMetrics.viewPaddingTop =
Math.max(viewportMetrics.viewPaddingTop, boundingRects.get(0).bottom);
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -1271,6 +1271,9 @@ public static final class ViewportMetrics {
public float devicePixelRatio = 1.0f;
public int width = 0;
public int height = 0;
// The fields prefixed with viewPadding and viewInset are used to calculate the padding,
// viewPadding, and viewInsets of ViewConfiguration in Dart. This calculation is performed at
// https://github.com/flutter/engine/blob/main/lib/ui/hooks.dart#L139-L155.
public int viewPaddingTop = 0;
public int viewPaddingRight = 0;
public int viewPaddingBottom = 0;
Expand Down