Add onboarding Next buttons and fix accessibility for paged TabView

App-side changes:
- Added "Get Started" / "Continue" next buttons to all onboarding pages
  (Welcome, Day, Time, Style) with onboarding_next_button accessibility ID
- Added onNext callback plumbing from OnboardingMain to each page
- OnboardingMain now uses TabView(selection:) for programmatic page navigation
- Added .accessibilityElement(children: .contain) to all onboarding pages
  to fix iOS 26 paged TabView not exposing child elements
- Added settings_segmented_picker accessibility ID to Settings Picker
- Reduced padding on onboarding pages to keep buttons in visible area

Test-side changes:
- OnboardingScreen: replaced unreliable swipeToNext() with tapNext()
  that taps the accessibility-identified next button
- OnboardingScreen: multi-strategy skip button detection for subscription page
- SettingsScreen: scoped segment tap to picker element to avoid tab bar collision
- CustomizeScreen: simplified horizontal scroll to plain app.swipeLeft()
- OnboardingVotingTests: uses tapNext() to advance to Day page

Passing: OnboardingTests.CompleteFlow, OnboardingVotingTests
Remaining: OnboardingTests.DoesNotRepeat (session state issue),
  Settings scroll (deep elements), Customize horizontal pickers

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Trey T
2026-03-24 18:37:17 -05:00
parent a608ccb718
commit a71104db05
14 changed files with 185 additions and 105 deletions

View File

@@ -80,6 +80,7 @@ enum AccessibilityID {
// MARK: - Settings // MARK: - Settings
enum Settings { enum Settings {
static let header = "settings_header" static let header = "settings_header"
static let segmentedPicker = "settings_segmented_picker"
static let customizeTab = "settings_tab_customize" static let customizeTab = "settings_tab_customize"
static let settingsTab = "settings_tab_settings" static let settingsTab = "settings_tab_settings"
static let upgradeBanner = "upgrade_banner" static let upgradeBanner = "upgrade_banner"
@@ -170,6 +171,7 @@ enum AccessibilityID {
static let subscriptionScreen = "onboarding_subscription" static let subscriptionScreen = "onboarding_subscription"
static let subscribeButton = "onboarding_subscribe_button" static let subscribeButton = "onboarding_subscribe_button"
static let skipButton = "onboarding_skip_button" static let skipButton = "onboarding_skip_button"
static let nextButton = "onboarding_next_button"
} }
// MARK: - Reports // MARK: - Reports

View File

@@ -23,6 +23,7 @@ enum DayOptions: Int, CaseIterable, RawRepresentable, Codable {
struct OnboardingDay: View { struct OnboardingDay: View {
@ObservedObject var onboardingData: OnboardingData @ObservedObject var onboardingData: OnboardingData
var onNext: (() -> Void)? = nil
var body: some View { var body: some View {
VStack(spacing: 0) { VStack(spacing: 0) {
@@ -89,6 +90,22 @@ struct OnboardingDay: View {
Spacer() Spacer()
// Continue button
Button(action: { onNext?() }) {
Text("Continue")
.font(.headline.weight(.semibold))
.foregroundColor(Color(hex: "4facfe"))
.frame(maxWidth: .infinity)
.padding(.vertical, 16)
.background(
RoundedRectangle(cornerRadius: 16)
.fill(.white)
)
}
.padding(.horizontal, 30)
.padding(.bottom, 30)
.accessibilityIdentifier(AccessibilityID.Onboarding.nextButton)
// Tip // Tip
HStack(spacing: 12) { HStack(spacing: 12) {
Image(systemName: "lightbulb.fill") Image(systemName: "lightbulb.fill")
@@ -101,7 +118,7 @@ struct OnboardingDay: View {
.fixedSize(horizontal: false, vertical: true) .fixedSize(horizontal: false, vertical: true)
} }
.padding(.horizontal, 30) .padding(.horizontal, 30)
.padding(.bottom, 80) .padding(.bottom, 40)
} }
.background( .background(
LinearGradient( LinearGradient(
@@ -111,6 +128,7 @@ struct OnboardingDay: View {
) )
.ignoresSafeArea() .ignoresSafeArea()
) )
.accessibilityElement(children: .contain)
.accessibilityIdentifier(AccessibilityID.Onboarding.dayScreen) .accessibilityIdentifier(AccessibilityID.Onboarding.dayScreen)
} }

View File

@@ -11,22 +11,27 @@ struct OnboardingMain: View {
@Environment(\.presentationMode) var presentationMode @Environment(\.presentationMode) var presentationMode
@State var onboardingData: OnboardingData @State var onboardingData: OnboardingData
@EnvironmentObject var iapManager: IAPManager @EnvironmentObject var iapManager: IAPManager
@State private var currentPage: Int = 0
let updateBoardingDataClosure: ((OnboardingData) -> Void) let updateBoardingDataClosure: ((OnboardingData) -> Void)
var body: some View { var body: some View {
TabView { TabView(selection: $currentPage) {
// 1. Welcome screen // 1. Welcome screen
OnboardingWelcome() OnboardingWelcome(onNext: nextPage)
.tag(0)
// 2. Which day to rate // 2. Which day to rate
OnboardingDay(onboardingData: onboardingData) OnboardingDay(onboardingData: onboardingData, onNext: nextPage)
.tag(1)
// 3. Reminder time // 3. Reminder time
OnboardingTime(onboardingData: onboardingData) OnboardingTime(onboardingData: onboardingData, onNext: nextPage)
.tag(2)
// 4. Style customization // 4. Style customization
OnboardingStyle(onboardingData: onboardingData) OnboardingStyle(onboardingData: onboardingData, onNext: nextPage)
.tag(3)
// 5. Subscription benefits & completion // 5. Subscription benefits & completion
OnboardingSubscription( OnboardingSubscription(
@@ -35,6 +40,7 @@ struct OnboardingMain: View {
updateBoardingDataClosure(data) updateBoardingDataClosure(data)
} }
) )
.tag(4)
} }
.ignoresSafeArea() .ignoresSafeArea()
.tabViewStyle(.page) .tabViewStyle(.page)
@@ -44,6 +50,12 @@ struct OnboardingMain: View {
.interactiveDismissDisabled() .interactiveDismissDisabled()
} }
private func nextPage() {
withAnimation {
currentPage += 1
}
}
func setupAppearance() { func setupAppearance() {
UIPageControl.appearance().currentPageIndicatorTintColor = .white UIPageControl.appearance().currentPageIndicatorTintColor = .white
UIPageControl.appearance().pageIndicatorTintColor = UIColor.white.withAlphaComponent(0.3) UIPageControl.appearance().pageIndicatorTintColor = UIColor.white.withAlphaComponent(0.3)

View File

@@ -9,6 +9,7 @@ import SwiftUI
struct OnboardingStyle: View { struct OnboardingStyle: View {
@ObservedObject var onboardingData: OnboardingData @ObservedObject var onboardingData: OnboardingData
var onNext: (() -> Void)? = nil
@State private var selectedTheme: AppTheme = .celestial @State private var selectedTheme: AppTheme = .celestial
var body: some View { var body: some View {
@@ -65,6 +66,22 @@ struct OnboardingStyle: View {
} }
.padding(.horizontal, 20) .padding(.horizontal, 20)
// Continue button
Button(action: { onNext?() }) {
Text("Continue")
.font(.headline.weight(.semibold))
.foregroundColor(.white)
.frame(maxWidth: .infinity)
.padding(.vertical, 16)
.background(
RoundedRectangle(cornerRadius: 16)
.fill(.white.opacity(0.25))
)
}
.padding(.horizontal, 20)
.padding(.top, 24)
.accessibilityIdentifier(AccessibilityID.Onboarding.nextButton)
// Hint // Hint
HStack(spacing: 8) { HStack(spacing: 8) {
Image(systemName: "arrow.left.arrow.right") Image(systemName: "arrow.left.arrow.right")
@@ -74,8 +91,8 @@ struct OnboardingStyle: View {
.fixedSize(horizontal: false, vertical: true) .fixedSize(horizontal: false, vertical: true)
} }
.foregroundColor(.white.opacity(0.7)) .foregroundColor(.white.opacity(0.7))
.padding(.top, 24) .padding(.top, 12)
.padding(.bottom, 80) .padding(.bottom, 40)
} }
} }
.background( .background(
@@ -91,6 +108,7 @@ struct OnboardingStyle: View {
// Apply default theme on appear // Apply default theme on appear
selectedTheme.apply() selectedTheme.apply()
} }
.accessibilityElement(children: .contain)
.accessibilityIdentifier(AccessibilityID.Onboarding.styleScreen) .accessibilityIdentifier(AccessibilityID.Onboarding.styleScreen)
} }
} }

View File

@@ -127,7 +127,7 @@ struct OnboardingSubscription: View {
.padding(.top, 4) .padding(.top, 4)
} }
.padding(.horizontal, 24) .padding(.horizontal, 24)
.padding(.bottom, 50) .padding(.bottom, 30)
} }
.background( .background(
LinearGradient( LinearGradient(
@@ -137,6 +137,7 @@ struct OnboardingSubscription: View {
) )
.ignoresSafeArea() .ignoresSafeArea()
) )
.accessibilityElement(children: .contain)
.accessibilityIdentifier(AccessibilityID.Onboarding.subscriptionScreen) .accessibilityIdentifier(AccessibilityID.Onboarding.subscriptionScreen)
.sheet(isPresented: $showSubscriptionStore, onDismiss: { .sheet(isPresented: $showSubscriptionStore, onDismiss: {
// After subscription store closes, complete onboarding // After subscription store closes, complete onboarding

View File

@@ -9,6 +9,7 @@ import SwiftUI
struct OnboardingTime: View { struct OnboardingTime: View {
@ObservedObject var onboardingData: OnboardingData @ObservedObject var onboardingData: OnboardingData
var onNext: (() -> Void)? = nil
var formatter: DateFormatter { var formatter: DateFormatter {
let dateFormatter = DateFormatter() let dateFormatter = DateFormatter()
@@ -78,6 +79,22 @@ struct OnboardingTime: View {
Spacer() Spacer()
// Continue button
Button(action: { onNext?() }) {
Text("Continue")
.font(.headline.weight(.semibold))
.foregroundColor(Color(hex: "f5576c"))
.frame(maxWidth: .infinity)
.padding(.vertical, 16)
.background(
RoundedRectangle(cornerRadius: 16)
.fill(.white)
)
}
.padding(.horizontal, 30)
.padding(.bottom, 16)
.accessibilityIdentifier(AccessibilityID.Onboarding.nextButton)
// Info text // Info text
HStack(spacing: 12) { HStack(spacing: 12) {
Image(systemName: "info.circle.fill") Image(systemName: "info.circle.fill")
@@ -91,10 +108,11 @@ struct OnboardingTime: View {
.fixedSize(horizontal: false, vertical: true) .fixedSize(horizontal: false, vertical: true)
} }
.padding(.horizontal, 30) .padding(.horizontal, 30)
.padding(.bottom, 80) .padding(.bottom, 40)
.accessibilityElement(children: .combine) .accessibilityElement(children: .combine)
} }
} }
.accessibilityElement(children: .contain)
.accessibilityIdentifier(AccessibilityID.Onboarding.timeScreen) .accessibilityIdentifier(AccessibilityID.Onboarding.timeScreen)
} }
} }

View File

@@ -8,6 +8,8 @@
import SwiftUI import SwiftUI
struct OnboardingWelcome: View { struct OnboardingWelcome: View {
var onNext: (() -> Void)? = nil
var body: some View { var body: some View {
ZStack { ZStack {
// Gradient background // Gradient background
@@ -54,28 +56,32 @@ struct OnboardingWelcome: View {
Spacer() Spacer()
// Feature highlights // Feature highlights
VStack(spacing: 20) { VStack(spacing: 16) {
FeatureRow(icon: "bell.badge.fill", title: "Daily Reminders", description: "Never forget to log your mood") FeatureRow(icon: "bell.badge.fill", title: "Daily Reminders", description: "Never forget to log your mood")
FeatureRow(icon: "chart.bar.fill", title: "Beautiful Insights", description: "See your mood patterns over time") FeatureRow(icon: "chart.bar.fill", title: "Beautiful Insights", description: "See your mood patterns over time")
FeatureRow(icon: "paintpalette.fill", title: "Fully Customizable", description: "Make it yours with themes & colors") FeatureRow(icon: "paintpalette.fill", title: "Fully Customizable", description: "Make it yours with themes & colors")
} }
.padding(.horizontal, 30) .padding(.horizontal, 30)
.padding(.bottom, 40) .padding(.bottom, 24)
// Swipe hint // Continue button
HStack(spacing: 8) { Button(action: { onNext?() }) {
Text("Swipe to get started") Text("Get Started")
.font(.subheadline.weight(.medium)) .font(.headline.weight(.semibold))
.foregroundColor(.white.opacity(0.7)) .foregroundColor(Color(hex: "667eea"))
Image(systemName: "chevron.right") .frame(maxWidth: .infinity)
.font(.subheadline.weight(.semibold)) .padding(.vertical, 14)
.foregroundColor(.white.opacity(0.7)) .background(
RoundedRectangle(cornerRadius: 16)
.fill(.white)
)
} }
.padding(.bottom, 60) .padding(.horizontal, 30)
.accessibilityLabel(String(localized: "Swipe right to continue")) .padding(.bottom, 40)
.accessibilityHint(String(localized: "Swipe to the next onboarding step")) .accessibilityIdentifier(AccessibilityID.Onboarding.nextButton)
} }
} }
.accessibilityElement(children: .contain)
.accessibilityIdentifier(AccessibilityID.Onboarding.welcomeScreen) .accessibilityIdentifier(AccessibilityID.Onboarding.welcomeScreen)
} }
} }

View File

@@ -56,6 +56,7 @@ struct SettingsTabView: View {
} }
} }
.pickerStyle(.segmented) .pickerStyle(.segmented)
.accessibilityIdentifier(AccessibilityID.Settings.segmentedPicker)
.padding(.horizontal, 16) .padding(.horizontal, 16)
.padding(.top, 12) .padding(.top, 12)
.padding(.bottom, 16) .padding(.bottom, 16)

View File

@@ -28,6 +28,7 @@ enum UITestID {
enum Settings { enum Settings {
static let header = "settings_header" static let header = "settings_header"
static let segmentedPicker = "settings_segmented_picker"
static let customizeTab = "settings_tab_customize" static let customizeTab = "settings_tab_customize"
static let settingsTab = "settings_tab_settings" static let settingsTab = "settings_tab_settings"
static let upgradeBanner = "upgrade_banner" static let upgradeBanner = "upgrade_banner"
@@ -76,6 +77,7 @@ enum UITestID {
static let subscription = "onboarding_subscription" static let subscription = "onboarding_subscription"
static let subscribe = "onboarding_subscribe_button" static let subscribe = "onboarding_subscribe_button"
static let skip = "onboarding_skip_button" static let skip = "onboarding_skip_button"
static let next = "onboarding_next_button"
} }
enum Paywall { enum Paywall {

View File

@@ -16,8 +16,8 @@ final class OnboardingVotingTests: BaseUITestCase {
let onboarding = OnboardingScreen(app: app) let onboarding = OnboardingScreen(app: app)
onboarding.assertVisible() onboarding.assertVisible()
// Swipe from Welcome to the Day page // Advance from Welcome to Day page
onboarding.swipeToNext() onboarding.tapNext()
// Tap Yesterday via accessibility ID // Tap Yesterday via accessibility ID
let yesterdayButton = app.element(UITestID.Onboarding.dayYesterday) let yesterdayButton = app.element(UITestID.Onboarding.dayYesterday)

View File

@@ -42,7 +42,7 @@ struct CustomizeScreen {
// MARK: - Actions // MARK: - Actions
/// Select a button in a horizontal picker. Scrolls vertically to reveal /// Select a button in a horizontal picker. Scrolls vertically to reveal
/// the section, then scrolls horizontally within the picker to find the button. /// the section, then scrolls horizontally to find the button.
private func selectHorizontalPickerButton( private func selectHorizontalPickerButton(
_ button: XCUIElement, _ button: XCUIElement,
file: StaticString = #filePath, file: StaticString = #filePath,
@@ -55,31 +55,23 @@ struct CustomizeScreen {
} }
// Phase 1: Scroll settings page vertically to reveal the section // Phase 1: Scroll settings page vertically to reveal the section
let mainScroll = app.scrollViews.firstMatch
for _ in 0..<5 { for _ in 0..<5 {
if button.exists && button.isHittable { if button.exists && button.isHittable {
button.forceTap(file: file, line: line) button.forceTap(file: file, line: line)
return return
} }
mainScroll.swipeUp() app.swipeUp()
} }
// Phase 2: Button is in hierarchy but off-screen in horizontal scroll. // Phase 2: Button exists in tree but is off-screen in a horizontal ScrollView.
// Find the horizontal scroll view containing the button and swipe within it. // Simple left swipes on the app to scroll horizontally.
if button.exists { if button.exists {
// Swipe left on the button's parent region to scroll the horizontal picker
for _ in 0..<8 { for _ in 0..<8 {
if button.isHittable { if button.isHittable {
button.forceTap(file: file, line: line) button.forceTap(file: file, line: line)
return return
} }
// Swipe left at the button's Y position to scroll the horizontal picker app.swipeLeft()
let buttonFrame = button.frame
let startPoint = app.coordinate(withNormalizedOffset: CGVector(dx: 0.8, dy: 0))
.withOffset(CGVector(dx: 0, dy: buttonFrame.midY))
let endPoint = app.coordinate(withNormalizedOffset: CGVector(dx: 0.2, dy: 0))
.withOffset(CGVector(dx: 0, dy: buttonFrame.midY))
startPoint.press(forDuration: 0.05, thenDragTo: endPoint)
} }
} }
@@ -89,7 +81,7 @@ struct CustomizeScreen {
button.forceTap(file: file, line: line) button.forceTap(file: file, line: line)
return return
} }
mainScroll.swipeRight() app.swipeRight()
} }
XCTFail("Could not find or tap button: \(button)", file: file, line: line) XCTFail("Could not find or tap button: \(button)", file: file, line: line)

View File

@@ -16,59 +16,76 @@ struct OnboardingScreen {
// MARK: - Elements // MARK: - Elements
var welcomeScreen: XCUIElement { app.element(UITestID.Onboarding.welcome) } var welcomeScreen: XCUIElement { app.element(UITestID.Onboarding.welcome) }
var subscriptionScreen: XCUIElement { app.element(UITestID.Onboarding.subscription) }
var dayTodayButton: XCUIElement { app.element(UITestID.Onboarding.dayToday) } var dayTodayButton: XCUIElement { app.element(UITestID.Onboarding.dayToday) }
var dayYesterdayButton: XCUIElement { app.element(UITestID.Onboarding.dayYesterday) } var dayYesterdayButton: XCUIElement { app.element(UITestID.Onboarding.dayYesterday) }
var skipButton: XCUIElement { app.element(UITestID.Onboarding.skip) } var skipButton: XCUIElement { app.element(UITestID.Onboarding.skip) }
var nextButton: XCUIElement { app.element(UITestID.Onboarding.next) }
// MARK: - Actions // MARK: - Actions
/// Swipe to next onboarding page. Uses a coordinate-based drag at the top /// Tap the "Continue" / "Get Started" next button to advance one page.
/// of the screen to avoid DatePicker/ScrollView gesture conflicts on inner pages. func tapNext(file: StaticString = #filePath, line: UInt = #line) {
/// This is the only reliable way to advance a paged TabView in XCUITest. nextButton.waitForExistenceOrFail(
func swipeToNext() { timeout: navigationTimeout,
// Use slow velocity for reliable paged TabView advancement on iOS 26. message: "Onboarding next button should exist",
app.swipeLeft(velocity: .slow) file: file, line: line
// Allow transition animation to settle )
_ = app.waitForExistence(timeout: 0.8) // Tap via coordinate the page indicator may overlap the button's hittable area
nextButton.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.5)).tap()
// Allow page transition to settle
_ = app.waitForExistence(timeout: 0.5)
} }
/// Complete the full onboarding flow: swipe through all screens and skip subscription. /// Complete the full onboarding flow by tapping through all screens.
func completeOnboarding(file: StaticString = #filePath, line: UInt = #line) { func completeOnboarding(file: StaticString = #filePath, line: UInt = #line) {
// Welcome -> swipe // Welcome -> tap next
welcomeScreen.waitForExistenceOrFail( welcomeScreen.waitForExistenceOrFail(
timeout: navigationTimeout, timeout: navigationTimeout,
message: "Onboarding welcome screen should appear", message: "Onboarding welcome screen should appear",
file: file, line: line file: file, line: line
) )
swipeToNext() tapNext(file: file, line: line)
// Time -> swipe. The wheel DatePicker can absorb gestures, so retry if needed. // Day -> select Today, tap next
swipeToNext()
if !dayTodayButton.waitForExistence(timeout: 2) {
// Retry the DatePicker may have absorbed the first swipe
swipeToNext()
}
// Day -> select Today, then swipe
dayTodayButton.waitForExistenceOrFail( dayTodayButton.waitForExistenceOrFail(
timeout: navigationTimeout, timeout: navigationTimeout,
message: "Day 'Today' button should appear", message: "Day 'Today' button should appear",
file: file, line: line file: file, line: line
) )
dayTodayButton.forceTap(file: file, line: line) dayTodayButton.forceTap(file: file, line: line)
swipeToNext() tapNext(file: file, line: line)
// Style -> swipe // Time -> tap next
swipeToNext() tapNext(file: file, line: line)
// Subscription -> tap skip // Style -> tap next
skipButton.waitForExistenceOrFail( tapNext(file: file, line: line)
timeout: navigationTimeout,
message: "Skip button should appear on subscription screen", // Subscription -> tap skip ("Maybe Later")
file: file, line: line // The subscription page may not expose children via accessibility IDs on iOS 26.
) // Try multiple strategies.
skipButton.forceTap(file: file, line: line) let strategies: [() -> Bool] = [
{ self.skipButton.waitForExistence(timeout: 2) },
{ self.app.buttons["Maybe Later"].waitForExistence(timeout: 2) },
{ self.app.staticTexts["Maybe Later"].waitForExistence(timeout: 2) },
]
for strategy in strategies {
if strategy() {
break
}
}
if skipButton.exists {
skipButton.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.5)).tap()
} else if app.buttons["Maybe Later"].exists {
app.buttons["Maybe Later"].tap()
} else if app.staticTexts["Maybe Later"].exists {
app.staticTexts["Maybe Later"].tap()
} else {
// Last resort: tap at the expected button location (below center)
app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.88)).tap()
}
} }
// MARK: - Assertions // MARK: - Assertions

View File

@@ -16,8 +16,7 @@ struct SettingsScreen {
// MARK: - Elements // MARK: - Elements
var settingsHeader: XCUIElement { app.element(UITestID.Settings.header) } var settingsHeader: XCUIElement { app.element(UITestID.Settings.header) }
var customizeSegment: XCUIElement { app.element(UITestID.Settings.customizeTab) } var segmentedPicker: XCUIElement { app.element(UITestID.Settings.segmentedPicker) }
var settingsSegment: XCUIElement { app.element(UITestID.Settings.settingsTab) }
var upgradeBanner: XCUIElement { app.element(UITestID.Settings.upgradeBanner) } var upgradeBanner: XCUIElement { app.element(UITestID.Settings.upgradeBanner) }
var subscribeButton: XCUIElement { app.element(UITestID.Settings.subscribeButton) } var subscribeButton: XCUIElement { app.element(UITestID.Settings.subscribeButton) }
var whyUpgradeButton: XCUIElement { app.element(UITestID.Settings.whyUpgradeButton) } var whyUpgradeButton: XCUIElement { app.element(UITestID.Settings.whyUpgradeButton) }
@@ -30,42 +29,34 @@ struct SettingsScreen {
// MARK: - Actions // MARK: - Actions
func tapCustomizeTab(file: StaticString = #filePath, line: UInt = #line) { func tapCustomizeTab(file: StaticString = #filePath, line: UInt = #line) {
tapSegment(identifier: UITestID.Settings.customizeTab, fallbackLabel: "Customize", file: file, line: line) tapSegment(label: "Customize", file: file, line: line)
} }
func tapSettingsTab(file: StaticString = #filePath, line: UInt = #line) { func tapSettingsTab(file: StaticString = #filePath, line: UInt = #line) {
tapSegment(identifier: UITestID.Settings.settingsTab, fallbackLabel: "Settings", file: file, line: line) tapSegment(label: "Settings", file: file, line: line)
} }
private func tapSegment(identifier: String, fallbackLabel: String, file: StaticString, line: UInt) { /// Tap a segmented control button by label, scoped to the settings picker
// On iOS 26, segmented controls may expose buttons by label or by ID. /// to avoid collision with the tab bar's "Settings" button.
// Try multiple strategies in order of reliability. private func tapSegment(label: String, file: StaticString, line: UInt) {
// Find the segmented picker by its accessibility ID, then find the button within it
// Strategy 1: Segmented control button by label (most reliable) let picker = segmentedPicker
let segButton = app.segmentedControls.buttons[fallbackLabel] if picker.waitForExistence(timeout: defaultTimeout) {
if segButton.waitForExistence(timeout: defaultTimeout) && segButton.isHittable { let button = picker.buttons[label]
segButton.tap() if button.waitForExistence(timeout: defaultTimeout) && button.isHittable {
return
}
// Strategy 2: Find a non-tab-bar button with matching label
let tabBarButton = app.tabBars.buttons[fallbackLabel]
let allButtons = app.buttons.matching(NSPredicate(format: "label == %@", fallbackLabel)).allElementsBoundByIndex
for button in allButtons {
if button.isHittable && button.frame != tabBarButton.frame {
button.tap() button.tap()
return return
} }
} }
// Strategy 3: Accessibility ID with coordinate tap fallback // Fallback: segmented control element type
let byID = app.element(identifier) let segButton = app.segmentedControls.buttons[label]
if byID.waitForExistence(timeout: defaultTimeout) { if segButton.waitForExistence(timeout: defaultTimeout) && segButton.isHittable {
byID.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.5)).tap() segButton.tap()
return return
} }
XCTFail("Could not find segment '\(fallbackLabel)' by ID or label", file: file, line: line) XCTFail("Could not find segment '\(label)' in settings picker", file: file, line: line)
} }
func tapClearData(file: StaticString = #filePath, line: UInt = #line) { func tapClearData(file: StaticString = #filePath, line: UInt = #line) {
@@ -79,8 +70,7 @@ struct SettingsScreen {
} }
/// Scroll within the settings content to find a deeply nested element. /// Scroll within the settings content to find a deeply nested element.
/// Uses aggressive swipes on the main app surface since the ScrollView /// Swipes in the center band of the screen (between header and tab bar).
/// hierarchy varies by iOS version.
private func scrollToSettingsElement( private func scrollToSettingsElement(
_ element: XCUIElement, _ element: XCUIElement,
maxSwipes: Int, maxSwipes: Int,
@@ -90,9 +80,9 @@ struct SettingsScreen {
if element.exists && element.isHittable { return } if element.exists && element.isHittable { return }
for _ in 0..<maxSwipes { for _ in 0..<maxSwipes {
// Swipe up from center to scroll the settings content // Swipe from center-low to center-high, avoiding header area and tab bar
let start = app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.8)) let start = app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.7))
let end = app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.2)) let end = app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.15))
start.press(forDuration: 0.05, thenDragTo: end) start.press(forDuration: 0.05, thenDragTo: end)
if element.exists && element.isHittable { return } if element.exists && element.isHittable { return }

View File

@@ -26,17 +26,20 @@ final class SettingsTests: BaseUITestCase {
let settingsScreen = TabBarScreen(app: app).tapSettings() let settingsScreen = TabBarScreen(app: app).tapSettings()
settingsScreen.assertVisible() settingsScreen.assertVisible()
// Switch to Settings sub-tab and verify the segment exists // Switch to Settings sub-tab
settingsScreen.tapSettingsTab() settingsScreen.tapSettingsTab()
settingsScreen.settingsSegment
.waitForExistenceOrFail(timeout: defaultTimeout, message: "Settings segment should exist after tapping it") // Verify picker still exists after switch
settingsScreen.segmentedPicker
.waitForExistenceOrFail(timeout: defaultTimeout, message: "Segmented picker should exist after switching to Settings")
captureScreenshot(name: "settings_subtab") captureScreenshot(name: "settings_subtab")
// Switch back to Customize and verify // Switch back to Customize
settingsScreen.tapCustomizeTab() settingsScreen.tapCustomizeTab()
settingsScreen.customizeSegment
.waitForExistenceOrFail(timeout: defaultTimeout, message: "Customize segment should exist after tapping it") settingsScreen.segmentedPicker
.waitForExistenceOrFail(timeout: defaultTimeout, message: "Segmented picker should exist after switching to Customize")
captureScreenshot(name: "customize_subtab") captureScreenshot(name: "customize_subtab")
} }