33 lines
1.1 KiB
Markdown
33 lines
1.1 KiB
Markdown
# tools
|
|
|
|
## 목적 / 책임
|
|
|
|
Proto 생성·동기화 스크립트를 담당한다. 모든 언어 구현체가 공통으로 사용하는 빌드 도구를 관리한다.
|
|
|
|
## 포함 경로
|
|
|
|
- `tools/` — proto 생성/검증 스크립트
|
|
- `PORTING_GUIDE.md` — 새 언어 구현 절차 가이드
|
|
|
|
## 제외 경로
|
|
|
|
- `*/crosstest/` — 각 언어 구현체 도메인에 속함 (dart/go/kotlin)
|
|
- `dart/lib/`, `go/*.go`, `kotlin/src/` — 각 언어 구현체 도메인
|
|
|
|
## 주요 구성 요소
|
|
|
|
- `tools/generate_proto.sh` — 모든 언어용 proto 바인딩 생성
|
|
- `tools/check_proto_sync.sh` — 언어 간 proto 스키마 동기화 검증
|
|
|
|
## 유지할 패턴
|
|
|
|
- proto 변경 후 항상 generate → check_sync 순서로 실행
|
|
|
|
## 다른 도메인과의 경계
|
|
|
|
- **protocol**: 스크립트가 proto 파일을 읽지만, proto 파일 자체는 protocol 도메인
|
|
- **dart/go/kotlin**: crosstest 코드는 각 언어 도메인에 속함. tools 도메인은 `tools/` 스크립트만 담당
|
|
|
|
## 금지 사항
|
|
|
|
- `check_proto_sync.sh` 실패를 무시하고 다음 단계로 진행하지 않는다
|