mirror of
https://github.com/Yuyi-Oak/BlueArchiveToolkit.git
synced 2026-07-22 04:15:14 +08:00
docs: align project status with official sync pipeline
Update the authoritative docs, guides, architecture notes, gap list, deployment guidance, handoff notes, and changelog to reflect the current Rust official resource sync boundary.
This commit is contained in:
+32
-16
@@ -104,26 +104,45 @@ git push origin feature/your-feature-name
|
||||
|
||||
## 测试
|
||||
|
||||
### 单元测试
|
||||
### 当前必跑测试
|
||||
|
||||
```bash
|
||||
# Go
|
||||
go test ./...
|
||||
|
||||
# Rust
|
||||
cargo test
|
||||
cargo test -p bat-adapters -- --nocapture
|
||||
cargo test -p bat-ffi -- --nocapture
|
||||
cargo test -p bat-infrastructure -- --nocapture
|
||||
cargo test -p bat-infrastructure --bin bat-official-sync -- --nocapture
|
||||
```
|
||||
|
||||
Go CLI 尚未实现时,`go test ./...` 可能没有产品级 package 可运行;Makefile 会在空 Go 阶段清晰跳过。
|
||||
|
||||
### 集成测试
|
||||
|
||||
```bash
|
||||
# 需要先启动数据库
|
||||
make dev
|
||||
|
||||
# 运行集成测试
|
||||
go test -tags=integration ./...
|
||||
cargo test --workspace
|
||||
```
|
||||
|
||||
带真实本地资源的测试默认不应启用。只有在明确需要时,才通过对应 `BAT_REAL_*` 环境变量读取隔离样本路径。不要默认读取 `/home/wanye/D/BlueArchive` 或任何已有客户端目录。
|
||||
|
||||
### 官方资源同步手动检查
|
||||
|
||||
查看参数:
|
||||
|
||||
```bash
|
||||
cargo run -p bat-infrastructure --bin bat-official-sync -- --help
|
||||
```
|
||||
|
||||
dry-run:
|
||||
|
||||
```bash
|
||||
cargo run -p bat-infrastructure --bin bat-official-sync -- \
|
||||
--auto-discover \
|
||||
--platforms Windows,Android \
|
||||
--output /tmp/ba-official-dev \
|
||||
--dry-run
|
||||
```
|
||||
|
||||
开发环境真实下载必须使用 `/tmp` 或其他隔离目录,不要写入现有资源目录。
|
||||
|
||||
### 基准测试
|
||||
|
||||
```bash
|
||||
@@ -161,10 +180,7 @@ cargo fetch
|
||||
|
||||
### 2. 测试失败
|
||||
|
||||
确保数据库已启动:
|
||||
```bash
|
||||
make dev
|
||||
```
|
||||
先确认失败是否来自真实网络或本地资源路径。默认测试应使用 fixture/mock,不应依赖官方线上资源或开发机已有资源目录。
|
||||
|
||||
### 3. FFI 绑定问题
|
||||
|
||||
@@ -176,4 +192,4 @@ cargo build
|
||||
|
||||
---
|
||||
|
||||
更多问题请查看 [FAQ](./faq.md)(待创建)或提交 Issue。
|
||||
更多当前状态请查看 [当前状态](../../CURRENT_STATUS.md) 和 [当前缺口清单](../reports/CURRENT_GAPS.md)。
|
||||
|
||||
Reference in New Issue
Block a user