Skip to content

[Bug report] Document Scanner UI unusable on 8.7-inch Tablets (Split-pane layout issue) #991

@Narubate

Description

@Narubate

Describe the bug
On small Android tablets (specifically 8.7-inch screens), the Document Scanner UI forces a "Split-Pane" layout which is likely intended for larger tablets (10"+). In Portrait mode, the black control area occupies approximately 60% of the screen, leaving a very small and unusable viewfinder at the top. This makes it extremely difficult for users to scan documents effectively.

This layout also negatively impacts scan quality.
To verify that the entire document is within the tiny viewable area, users are forced to move the tablet physically further away from the paper. This results in lower resolution captures.

Conversely, if users hold the device at an optimal distance for better clarity, the document borders (especially the bottom edge) are completely obscured by the large control panel. Users cannot tell if the document is fully in frame or if the edges are cut off.

To Reproduce

  1. Launch GmsDocumentScanner (using GmsDocumentScannerOptions) on an 8.7-inch tablet.
  2. Hold the device in Portrait orientation.
  3. Observe the UI layout.
  4. The viewfinder is too small because the control panel takes up the majority of the screen space.

Expected behavior
On compact tablets (under 10 inches), the UI should utilize a full-screen viewfinder or an overlay layout (similar to the mobile phone UI) to maximize the camera preview area. The split-pane layout should only be triggered on larger screens where space permits.

SDK Info:

  • com.google.android.gms:play-services-mlkit-document-scanner:16.0.0

Smartphone:

  • Device: Samsung Galaxy Tab A9 (SM-X115) and Samsung Galaxy Tab A7 Lite (SM-T225)
  • Device OS: Android 11 - Android 15

Development Environment:

  • IDE Eversion: Android Studio Narwhal 3 Feature Drop | 2025.1.3
  • Laptop/Desktop: Macbook Pro M3 2023
  • Laptop/Desktop OS/version: Tahoe 26.0.1

Screenshots:

Image Image

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions