감시 모드: 파일 변경 시 자동 재번역
Lingo.dev CLI는 이제 run 명령어에 대한 강력한 감시 모드를 지원하여 소스 파일이 변경될 때마다 자동으로 재번역을 수행합니다.
작동 방식
--watch 플래그와 함께 CLI를 실행하면 구성된 소스 파일(i18n.json 버킷에 정의된 대로)의 변경 사항을 지속적으로 모니터링합니다. 파일이 추가, 수정 또는 삭제되면 CLI가 자동으로 번역 워크플로를 트리거하여 대상 로케일 파일과 i18n.lock를 필요에 따라 업데이트합니다.
이는 신속한 개발, 라이브 미리보기 환경 또는 번역이 소스 콘텐츠와 실시간으로 동기화되어야 하는 모든 워크플로에 이상적입니다.
사용법
npx lingo.dev@latest run --watch
- CLI가 감시 모드로 시작되어 감지된 변경 사항과 번역 진행 상황에 대한 로그를 표시합니다.
- 기본적으로 빠른 편집 중 중복 실행을 방지하기 위해 변경 사항이 5초 동안 디바운스됩니다.
- 프로세스는 중지할 때까지(Ctrl+C) 계속 실행됩니다.
디바운스 옵션
--debounce 플래그를 사용하여 디바운스 지연 시간(밀리초)을 사용자 정의할 수 있습니다.
npx lingo.dev@latest run --watch --debounce 10000
이 예시는 감지된 변경 사항과 다음 번역 실행 사이에 10초의 디바운스 윈도우를 설정합니다.
기능
- 자동 재번역: 소스 파일을 편집하면 즉시 번역이 업데이트됩니다.
- 디바운스 실행: 빠른 파일 변경 중 과도한 번역 요청을 방지합니다.
- 오류 처리: 감시 모드는 오류를 우아하게 처리하고 실패 후에도 모니터링을 계속합니다.
- 모든 파일 유형:
i18n.json구성에서 지원하는 모든 파일 유형과 함께 작동합니다.
감시 모드 사용 시기
- 다국어 기능의 활발한 개발 중
- 앱에서 번역 변경 사항을 실시간으로 미리 볼 때
- 로컬 또는 클라우드 기반 개발 환경과의 지속적인 통합을 위해
팁: 워치 모드는 개발 및 빠른 반복 작업을 위해 설계되었습니다. 프로덕션 또는 CI/CD 환경에서는 일회성 번역 실행을 위해 --watch 없이 표준 run 명령을 사용하세요.