logo hsb.horse

Architecture Decision Record

PWA manifest 다국어 전략

로케일별 manifest를 생성하여 lang/name/short_name을 현지화합니다.

채택됨 #pwa #i18n

PWA manifest 다국어 전략

결정

  • Astro endpoint를 사용하여 각 로케일에 대해 manifest.{locale}.webmanifest를 생성
  • 각 manifest는 로케일에 따라 lang, name, short_name을 변경
  • Favicon.astro는 로케일 인식 manifest를 참조

배경

사이트는 6개 로케일(ja, en, ko, fr, de, pt)을 지원하지만 manifest는 lang: "ja"로 고정되어 있었습니다. 적절한 PWA 경험을 제공하기 위해 로케일별 manifest가 필요합니다.

근거

  • PWA 모범 사례에 따르면 manifest의 lang은 페이지 언어와 일치해야 함
  • 앱 이름(name, short_name)도 각 언어에 맞게 표시되어야 함
  • Astro endpoint 생성은 정적 호스팅 환경에서도 작동

영향

  • manifest는 /brand/manifest.{locale}.webmanifest 형식으로 생성됨
  • Favicon.astro는 페이지 로케일을 기반으로 적절한 manifest를 참조
  • 새 로케일 추가 시 src/pages/brand/manifest.[lang].webmanifest.ts 업데이트 필요