test: 增强 UI 测试基础设施与阅读器自动化测试

- 新增 BookmarkTests/PageNavigationTests/TableOfContentsTests 等阅读器功能测试 - 扩展 AccessibilityIdentifiers 支持更多 UI 元素定位 - XCUIApplication+Launch: 增加启动参数支持（reset state、自定义书籍） - ReaderAnnotationTests: 完善标注测试覆盖 - ViewController: 支持 --demo-reset-state 参数清理持久化状态 - 新增凡人修仙传测试样本 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-02 21:17:04 +08:00
parent c76beed03c
commit 9801af05d3
11 changed files with 907 additions and 14 deletions
@@ -0,0 +1,67 @@
+import XCTest
+
+final class ReaderAnnotationExtendedTests: XCTestCase {
+    private let app = XCUIApplication()
+
+    override func setUpWithError() throws {
+        continueAfterFailure = false
+    }
+
+    func testBottomToolbarHasAddHighlightButton() {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+        app.showReaderChromeIfNeeded()
+
+        let addHighlightButton = app.buttons[IDs.readerAddHighlight]
+        XCTAssertTrue(addHighlightButton.waitForExistence(timeout: 5), "底部工具栏标注按钮未出现")
+    }
+
+    func testBottomToolbarHasHighlightsButton() {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+        app.showReaderChromeIfNeeded()
+
+        let highlightsButton = app.buttons[IDs.readerHighlights]
+        XCTAssertTrue(highlightsButton.waitForExistence(timeout: 5), "底部工具栏高亮列表按钮未出现")
+    }
+
+    func testBottomToolbarButtonsLayout() {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+        app.showReaderChromeIfNeeded()
+
+        XCTAssertTrue(app.buttons[IDs.readerToc].waitForExistence(timeout: 5), "目录按钮未出现")
+        XCTAssertTrue(app.buttons[IDs.readerBookmarks].exists, "书签按钮未出现")
+        XCTAssertTrue(app.buttons[IDs.readerHighlights].exists, "高亮按钮未出现")
+        XCTAssertTrue(app.buttons[IDs.readerAddHighlight].exists, "标注按钮未出现")
+        XCTAssertTrue(app.buttons[IDs.readerSettings].exists, "设置按钮未出现")
+    }
+
+    func testSelectionTextElementExists() {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+
+        let selectionText = app.otherElements[IDs.readerSelectionText].firstMatch
+        XCTAssertTrue(selectionText.waitForExistence(timeout: 5), "文本选区元素未出现")
+    }
+
+    func testReaderStateReportsPageInfo() {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+
+        let state = app.staticTexts[IDs.demoReaderState]
+        XCTAssertTrue(state.waitForExistence(timeout: 5))
+        XCTAssertTrue(state.label.contains("reader=opened"), "状态未包含 reader=opened")
+        XCTAssertTrue(state.label.contains("page="), "状态未包含 page 信息")
+        XCTAssertTrue(state.label.contains("display="), "状态未包含 display 信息")
+    }
+
+    func testReaderStateReportsHighlightCount() {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+
+        let state = app.staticTexts[IDs.demoReaderState]
+        XCTAssertTrue(state.waitForExistence(timeout: 5))
+        XCTAssertTrue(state.label.contains("highlights=0"), "初始高亮数应为 0")
+    }
+}