Web uygulaması manifestleri için yerelleştirme desteği

Alexander Kyereboah
Alexander Kyereboah
GitHub LinkedIn

Yayınlanma tarihi: 24 Nisan 2026

Chrome ve Edge 148'de manifest yerelleştirme özelliğinin kullanıma sunulduğunu duyurmaktan heyecan duyuyoruz. Web uygulaması geliştiriciler ve küresel kitleleri için bu önemli adım, Microsoft Edge ekibi tarafından Chrome ekibiyle işbirliği içinde uygulanmıştır.

Web uygulaması manifest dosyaları uzun süredir birden fazla dili desteklemiyordu. Bu durum, tek dilli bir deneyim veya karmaşık geçici çözümler arasında seçim yapmanıza neden oluyordu.

Manifest yerelleştirme, basit ve güçlü dil desteğini doğrudan manifest dosyanıza getirerek bu durumu değiştirir.

Sorun: Manifest'te dil desteğinin olmaması

Chrome ve Edge 148'den önce web uygulaması manifestleri, uygulamanız için yalnızca bir dizi alan (ör. name, description ve short_name) tanımlamanıza olanak tanıyordu. Bu sınırlama, uygulamanızın kullanıcınızın tercih ettiği dilden bağımsız olarak aynı ad ve açıklamayla görünmesi anlamına geliyordu. Bu da İngilizce bilmeyen veya birden fazla dil bilen kitleler için daha kötü bir deneyime yol açıyordu.

Birden fazla dili desteklemek için karmaşık istemci tarafı çözümlerine güvenmeniz veya yerelleştirmeyi tamamen bırakmanız gerekiyordu.

Çözüm: Manifest yerelleştirme

Manifest yerelleştirme, web uygulaması manifest spesifikasyonunun bir uzantısıdır. Yeni _localized sonekini kullanarak name, short_name, description gibi manifest alanları için yerelleştirilmiş değerler tanımlayabilirsiniz.

Örneğin, name ve name_localized sağlayarak uygulamanızın varsayılan adını ve farklı dillerdeki çevirilerini doğrudan manifest dosyanızda belirtebilirsiniz.

Tarayıcı, kullanıcının dil tercihlerine en uygun sürümü otomatik olarak seçip göstererek kurulumdan kullanıma kadar sorunsuz bir çok dilli deneyim sunar.

Yerelleştirilmiş alanları tanımlama

Manifest yerelleştirmeyi kullanmak için _localized sonekini içeren alanları manifest.json dosyanıza ekleyin ve BCP47 dil etiketlerini kullanarak çevirileri tanımlayın:

{
 "lang": "en-US",
 "dir": "ltr",
 "name": "Color Picker",
 "name_localized": {
  "de": "Farbwähler",
  "en": {"value": "Color Picker"},
  "en-GB": {"value": "Colour Picker", "dir": "ltr"},
  "fr": {"value": "Sélecteur de Couleur", "lang": "fr-CA", "dir": "ltr"},
  "ar": {"value": "`منتقي` `الألوان`", "dir": "rtl"}
 }
}

Bu yapıda, tarayıcısı girişlerden biriyle eşleşen bir dile ayarlanmış olan kullanıcılar, uygulamanızın adını kendi dillerinde görür. Aksi takdirde, varsayılan ad değeri kullanılır.

Şu anda yerelleştirme için kullanılabilen web uygulaması manifest alanları şunlardır:

  • name
  • short_name
  • description
  • icons
  • shortcuts
    • name
    • short_name
    • description
    • icons

Yerelleştirilebilir alanların ayrıntılı listesi ve tam uygulama ayrıntıları için Web Uygulaması Manifesti spesifikasyonuna bakın.

Demo

Manifest yerelleştirme özelliğinin nasıl çalıştığını görmek için Chrome veya Edge 148 ya da sonraki sürümlerde demo uygulamamıza göz atın:

Geri bildirim

Manifest yerelleştirme, 148 sürümünden itibaren Chrome ve Microsoft Edge'de kullanılabilir. Daha fazla dilin desteklendiği bir web'e doğru ilerlerken bu özelliği denemenizi, geri bildirimde bulunmanızı ve iyileştirmemize yardımcı olmanızı rica ediyoruz. Özelliği bugün deneyin ve görüşlerinizi bizimle paylaşın.

Geri bildiriminizi W3C manifest deposunda yeni bir sorun oluşturarak bize bildirin.