Flutter ARB
리소스 메타데이터와 플레이스홀더 정의를 유지하면서 ARB 메시지 값을 번역합니다.
애플리케이션 리소스 번들인 ARB는 Flutter 메시지를 설명, 플레이스홀더 정의와 함께 저장합니다. flutter 파일 핸들러는 이 평면 JSON 객체의 일반 문자열 항목을 번역하고, @로 시작하는 키는 메타데이터로 보존합니다.
메시지와 메타데이터 #
예를 들어 배송 메시지에는 전달받을 숫자를 다음과 같이 선언할 수 있습니다.
{
"@@locale": "en",
"delivery": "Delivery within {days} days",
"@delivery": {
"description": "Checkout estimate for the latest arrival date",
"placeholders": {
"days": { "type": "int" }
}
}
}delivery은 번역 단위가 됩니다. 같은 계층의 @delivery.description는 번역가를 위한 힌트로, 출력에서도 메타데이터로 유지됩니다. 플레이스홀더 정의는 번역하지 않고 그대로 유지합니다. 핸들러는 임의의 중첩 객체를 별도의 메시지 카탈로그로 처리하지 않습니다.
@@locale이 있고 대상 로캘이 지정되어 있으면 재구성 과정에서 해당 값을 갱신합니다. @@locale가 없더라도 자동으로 추가하지는 않습니다. 그 밖의 번들 전역 값은 원본 그대로 유지합니다.
기존 값과 범위 #
이전 원본을 기준으로 키별 메시지 변경 사항을 식별합니다. 기존 대상 파일에 승인된 값이 있으면 이를 활용할 수 있습니다. 재구성에는 현재 원본의 메타데이터를 사용하므로, 메시지 문구를 재사용하더라도 원본 메타데이터의 변경 사항은 출력에 반영될 수 있습니다.
메시지가 바뀌면 일반적인 원본 업데이트로 처리하세요. 번역 지침을 바꾼 뒤에는 필요에 따라 파일 전체를 명시적으로 새로 고치세요. 자세한 내용은 CLI 범위를 참고하세요. Flutter 생성 작업을 실행하기 전에 결과 메시지와 메타데이터를 확인하세요.
출력은 공백 두 칸으로 들여쓴 JSON 형식이며, 끝에 줄바꿈이 추가됩니다. 구조를 재구성하는 방식이므로 원본 서식을 바이트 단위로 보존하지는 않습니다.
번역 후 Flutter 리소스 생성 #
CLI는 .arb에서 flutter을 추론합니다. app_en.arb 같은 원본에서는 app_de.arb 같은 로캘별 파일이 생성됩니다. 이 경로를 프로젝트의 로컬라이제이션 설정에 맞추세요. 파일 선택에는 CLI 설정 또는 GitHub를 사용하세요.
파일을 가져온 뒤에는 프로젝트의 Flutter 로컬라이제이션 생성기와 빌드 검사를 실행하세요. 매개변수가 있는 메시지는 실제 값을 넣어 화면에 표시하고, 각 대상 로캘에서 복수형이 쓰이는 경우를 테스트하세요. 보존된 메타데이터는 생성기에 필요한 정보를 제공하지만, 번역된 메시지에서도 해당 플레이스홀더를 올바르게 사용해야 합니다. Flutter 앱 로컬라이제이션에서는 리소스를 준비해 애플리케이션에서 확인하는 이 단계까지 안내합니다.