72 lines
2.4 KiB
Markdown
72 lines
2.4 KiB
Markdown
# 测试说明
|
||
|
||
**分析日期：** 2026-05-21
|
||
|
||
## 测试框架与现状
|
||
|
||
**Runner：**
|
||
- XCTest（iOS/Xcode 默认测试框架）
|
||
- **当前仓库状态**：未检测到任何 XCTest 测试文件或测试 Target（未发现 `import XCTest`/`XCTestCase`，且示例工程 `ReadViewDemo` 的 `project.pbxproj` 仅声明应用 Target）。
|
||
|
||
**断言库：**
|
||
- XCTest 内建断言（当前仓库未见使用案例）
|
||
|
||
## 测试文件组织
|
||
|
||
**位置：**
|
||
- 未检测到 `*Tests*` 目录或 `*.test.*` / `*.spec.*` 文件（排除 `ReadViewDemo/Pods/**` 第三方依赖源码）。
|
||
|
||
**命名：**
|
||
- 未检测到（无测试用例）
|
||
|
||
## 如何运行（在当前仓库结构下）
|
||
|
||
### CocoaPods 依赖准备
|
||
|
||
> 仓库包含示例工程 `ReadViewDemo`，并已提交 `Pods/` 与 `Podfile.lock`。如本地环境未同步，可在仓库根或示例工程目录运行：
|
||
|
||
```bash
|
||
pod install
|
||
```
|
||
|
||
（依赖入口：`Podfile`、`ReadViewDemo/Podfile`）
|
||
|
||
### 运行/构建示例工程
|
||
|
||
- Xcode 打开：`ReadViewDemo/ReadViewDemo.xcworkspace`
|
||
- Scheme/Target 名称从工程文件可见为 `ReadViewDemo`（见 `ReadViewDemo/ReadViewDemo.xcodeproj/project.pbxproj`）
|
||
|
||
### 运行测试
|
||
|
||
**当前无测试可运行。** 若未来添加 `ReadViewDemoTests`（或为 SDK 增加独立测试工程/SwiftPM 包），可用 Xcode 或 `xcodebuild test` 运行。
|
||
|
||
示例（需要存在测试 Scheme/Target 后才有效）：
|
||
|
||
```bash
|
||
xcodebuild test \
|
||
-workspace ReadViewDemo/ReadViewDemo.xcworkspace \
|
||
-scheme ReadViewDemo \
|
||
-destination 'platform=iOS Simulator,name=iPhone 15'
|
||
```
|
||
|
||
> 注：本环境中执行 `xcodebuild -list` 发生过 CoreSimulator/日志权限相关错误，属于运行环境限制；测试命令以项目结构为依据给出，实际执行以本机 Xcode/Simulator 可用性为准。
|
||
|
||
## 覆盖率（Coverage）
|
||
|
||
- 未检测到覆盖率配置或现有覆盖率报告产物（例如 `.xcresult` 固化路径或 CI 输出）。
|
||
- 若新增 XCTest Target，可在 Xcode Scheme 的 Test 设置中启用 Coverage，或通过 `xcodebuild test` 生成 `.xcresult` 后用 Xcode 查看。
|
||
|
||
## Mocking / Fixtures
|
||
|
||
- 未检测到统一 mocking 框架或 fixtures 目录（无测试用例）。
|
||
|
||
## Evidence（关键证据文件）
|
||
|
||
- `ReadViewDemo/ReadViewDemo.xcodeproj/project.pbxproj`
|
||
- `Podfile`
|
||
- `ReadViewDemo/Podfile`
|
||
- `ReadViewDemo/Podfile.lock`
|
||
- `RDReaderView.podspec`
|
||
- `ReadViewDemo/ReadViewDemo/ViewController.swift`
|
||
- `Sources/RDReaderView/EPUBCore/RDEPUBParser.swift`
|