Files
buzz/mobile/ios/NativeControlTests/IosMediaCarouselTests.swift
klopez4212 d61fe2071d Use native UIKit scrolling for iOS photo carousels (#8361)
Builds on the mobile polish merged in #8359; this PR now targets `main`.
On iOS, inline photo galleries now use a UIKit collection view for
dragging, deceleration, and snapping. Photo taps retain the existing
full-screen viewer and reply/more actions; gallery scrolling continues
to fade the message avatar. The final photo stops at the full message
gutter rather than the smaller gap between photos. Android keeps the
current Flutter carousel.

Visible cells subscribe to continuing frames from Flutter's existing
authenticated image providers, preserving animated GIF/APNG/WebP media.
Request IDs fence late frames and cancel subscriptions on
reuse/disappearance/disposal. A four-slot bound includes retired
unresolved loads until their transport terminates. Shared media fetches
now use abortable HTTP requests with a 30-second deadline through
response-body completion, so stalled requests release their slots
without leaving live transports behind; native eager precaching is
disabled so it cannot bypass that bound. Frame conversion coalesces to
the newest pending frame. Native cells expose photo labels and positions
to VoiceOver, support RTL, and preserve the selected photo during
resizing.

Validation:
- Mobile formatting and analysis passed.
- Native simulator regression checks passed for geometry, RTL, snapping,
taps, frame replacement, cancellation, and resizing. The native CI lane
now runs the carousel executable.
- Full mobile suite and pre-push gates passed, including two-frame GIF
delivery, delayed-provider bounds/cancellation, real HTTP
stalled-header/body recovery with four requests maximum, disposal, and
unconfigured-push tests.
- Signed iPhone Release build of the frame/subscription implementation
passed. Physical iPhone testing covered the earlier carousel/gutter
revision; the new animation/cancellation changes have local Flutter and
native simulator coverage, not a new physical-device journey.
Preview-only signing overrides preserve its bundle/Keychain group;
production entitlements are unchanged. Local provisioning excludes
production push/App Attest capabilities.
- Full `just ci` was started but stopped after unrelated Rust/desktop
compilation consumed about 5 GB; broad CI is incomplete.

Device build required local Xcode 27 workarounds: iOS 16 deployment
target and a generated swift-secp256k1 cache compatibility edit. Neither
changes repository source.

---------

Signed-off-by: kenny lopez <klopez4212@gmail.com>
Co-authored-by: Terp <5856f6900e8e0a4e0ea1f4f8d2ee33e4753d2119bc122f94ecafc660b46c0511@buzz.block.builderlab.xyz>
2026-10-15 13:22:12 -04:00

126 lines
6.4 KiB
Swift

import Flutter
import UIKit
@main
struct IosMediaCarouselTests {
@MainActor static func main() {
let messenger = CarouselTestMessenger()
var args: [String: Any] = [
"labels": ["Photo A", "Photo B", "Photo C"],
"width": 300.0, "gutter": 20.0, "gap": 4.0, "trailingPadding": 20.0, "radius": 16.0,
]
let platform = IosMediaCarousel(
frame: CGRect(x: 0, y: 0, width: 340, height: 240), id: 42,
arguments: args, messenger: messenger
)
guard let strip = platform.view() as? UICollectionView else {
preconditionFailure("Carousel must use native collection scrolling")
}
messenger.configure(args)
strip.layoutIfNeeded()
precondition(strip.numberOfItems(inSection: 0) == 3)
precondition(strip.contentOffset.x == -20, "Initial photo starts at gutter")
precondition(strip.decelerationRate == .fast)
let first = IndexPath(item: 0, section: 0)
guard let cell = strip.cellForItem(at: first) else {
preconditionFailure("Missing photo cell")
}
precondition(cell.accessibilityLabel == "Open Photo A")
precondition(cell.accessibilityTraits.contains(.button))
precondition(messenger.calls.contains { $0.method == "subscribeImage" }, "Images requested after ready")
guard let subscription = messenger.calls.first(where: {
$0.method == "subscribeImage" && ($0.arguments as? [String: Any])?["index"] as? Int == 0
}), let id = (subscription.arguments as? [String: Any])?["id"] as? String,
let photo = cell.contentView.subviews.compactMap({ $0 as? UIImageView }).first else {
preconditionFailure("Missing visible photo subscription")
}
func frame(_ color: UIColor) -> Data {
UIGraphicsImageRenderer(size: CGSize(width: 2, height: 2)).pngData { context in
color.setFill()
context.fill(CGRect(x: 0, y: 0, width: 2, height: 2))
}
}
messenger.frame(id, frame(.red))
let firstFrame = photo.image?.pngData()
messenger.frame(id, frame(.blue))
precondition(firstFrame != nil && photo.image?.pngData() != firstFrame,
"Native photo must display continuing animation frames")
precondition(subscription.arguments is [String: Any], "Subscriptions carry request IDs")
platform.collectionView(strip, didEndDisplaying: cell, forItemAt: first)
precondition(messenger.calls.last?.method == "cancelImage", "Disappearing cells cancel subscriptions")
let stoppedFrame = photo.image?.pngData()
messenger.frame(id, frame(.green))
precondition(photo.image?.pngData() == stoppedFrame, "Late cancelled frames must not paint")
platform.collectionView(strip, willDisplay: cell, forItemAt: first)
let resubscription = messenger.calls.last
cell.prepareForReuse()
precondition(messenger.calls.last?.method == "cancelImage", "Reuse cancels its previous subscription")
precondition((resubscription?.arguments as? [String: Any])?["id"] as? String == messenger.calls.last?.arguments as? String)
platform.collectionView(strip, didSelectItemAt: IndexPath(item: 1, section: 0))
precondition(messenger.calls.last?.method == "open")
precondition(messenger.calls.last?.arguments as? Int == 1)
var target = CGPoint(x: 235, y: 0)
platform.scrollViewWillEndDragging(strip, withVelocity: CGPoint(x: 1, y: 0), targetContentOffset: &target)
precondition(target.x == 250, "Drag snaps to native item stride")
target.x = 10000
platform.scrollViewWillEndDragging(strip, withVelocity: .zero, targetContentOffset: &target)
precondition(target.x <= strip.contentSize.width - strip.bounds.width + 20, "No trailing blank page")
let last = IndexPath(item: 2, section: 0)
guard let lastFrame = strip.layoutAttributesForItem(at: last)?.frame else {
preconditionFailure("Missing final photo layout")
}
let trailingEdge = lastFrame.maxX - target.x
precondition(abs((strip.bounds.width - 20) - trailingEdge - 20) < 0.01,
"Final photo must stop at the full 20pt message gutter, not the 4pt photo gap")
precondition(lastFrame.minX == 540, "Trailing padding must not change page stride")
strip.contentOffset.x = 250
platform.scrollViewDidScroll(strip)
precondition(messenger.calls.contains { $0.method == "page" && $0.arguments as? Int == 1 })
args["rtl"] = true
messenger.configure(args)
precondition(strip.transform.a == -1, "Native strip follows RTL reading order")
strip.layoutIfNeeded()
let rtlCell = strip.visibleCells.first
precondition(rtlCell?.transform.a == -1, "Photo itself is not mirrored")
target.x = 10000
platform.scrollViewWillEndDragging(strip, withVelocity: .zero, targetContentOffset: &target)
guard let rtlLast = strip.layoutAttributesForItem(at: last)?.frame else {
preconditionFailure("Missing RTL final photo layout")
}
precondition(abs((strip.bounds.width - 20) - (rtlLast.maxX - target.x) - 20) < 0.01,
"RTL final photo must retain the same message gutter")
args["width"] = 200.0
messenger.configure(args)
precondition(strip.contentOffset.x == 160, "Resize retains the selected logical photo")
print("Native carousel scrolling, bounds, RTL, image requests, and taps passed")
}
}
private final class CarouselTestMessenger: NSObject, FlutterBinaryMessenger {
var calls: [FlutterMethodCall] = []
var handler: FlutterBinaryMessageHandler?
func frame(_ id: String, _ data: Data) {
let codec = FlutterStandardMethodCodec.sharedInstance()
handler?(codec.encode(FlutterMethodCall(methodName: "imageFrame", arguments: [
"id": id, "bytes": FlutterStandardTypedData(bytes: data)
])), { _ in })
}
func configure(_ args: [String: Any]) {
let codec = FlutterStandardMethodCodec.sharedInstance()
handler?(codec.encode(FlutterMethodCall(methodName: "configure", arguments: args)), { _ in })
}
func send(onChannel channel: String, message: Data?) {
guard let message else { return }
calls.append(FlutterStandardMethodCodec.sharedInstance().decodeMethodCall(message))
}
func send(onChannel channel: String, message: Data?, binaryReply callback: FlutterBinaryReply?) {
send(onChannel: channel, message: message)
callback?(FlutterStandardMethodCodec.sharedInstance().encodeSuccessEnvelope(nil))
}
func setMessageHandlerOnChannel(_ channel: String, binaryMessageHandler handler: FlutterBinaryMessageHandler?) -> FlutterBinaryMessengerConnection {
self.handler = handler
return 1
}
func cleanUpConnection(_ connection: FlutterBinaryMessengerConnection) {}
}