Çeviri Düzenleyici ile kullanıcı arayüzünü yerelleştirme

Çeviri Düzenleyici, tüm varsayılan ve çevrilmiş dize kaynaklarınızın birleştirilmiş ve düzenlenebilir bir görünümünü sunar.

Uygulamanızı farklı dillere çevirme hakkında bilgi edinmek için Farklı dilleri ve kültürleri destekleme başlıklı makaleyi okuyun.

Çeviri Düzenleyici, uygulama metnini çevrilmeden önce gösteriyor.
Şekil 1. Çeviri
yapılmadan önce uygulama metnini gösteren Çeviri Düzenleyici

Dize kaynakları

Bir projenin dize kaynakları strings.xml dosyalarında bulunur. Projenizde, uygulamanızın varsayılan dilindeki dize kaynaklarını içeren varsayılan bir strings.xml dosyası bulunur. Bu dil, uygulama kullanıcılarınızın çoğunun konuşmasını beklediğiniz dildir. Ayrıca, uygulamanızın desteklemesini istediğiniz diğer diller için dize kaynakları içeren çevrilmiş strings.xml dosyalarınız da olabilir.

Varsayılan strings.xml dosyanızı tamamladıktan sonra çevirileri kendiniz ekleyebilir veya çevirileri yapması için profesyonel hizmetlere ödeme yapabilirsiniz. Her iki durumda da yerelleştirilebilir metinleri yönetmenize ve test etmenize yardımcı olacak Android Studio özelliklerinden yararlanmanız gerekir. Profesyonel çeviri hizmetleri hakkında bilgi edinmek için Çeviri hizmetleri başlıklı makaleyi inceleyin.

Çeviri Düzenleyici'yi açma

Çeviri Düzenleyici'ye Android Studio'da aşağıdaki yerlerden erişebilirsiniz.

Android görünümünden açma

  1. Soldaki Proje > Android panelinde ModuleName > res > values'ı seçin.
  2. strings.xml dosyasını sağ tıklayın ve Çeviri Düzenleyici'yi aç'ı seçin.

    Çeviri Düzenleyici, strings.xml dosyasındaki anahtar ve değer çiftlerini gösterir.

Şekil 1'de, çeviri çalışması yapılmadan önce bir uygulamanın Çeviri Düzenleyicisi'ndeki varsayılan uygulama metni (bu örnekte İngilizce) gösterilmektedir. Çevrilen strings.xml dosyanın içeriği, Şekil 2'de gösterildiği gibi Çevrilemez sütununun sağında, her dil için bir sütun olacak şekilde gösterilir.

strings.xml içinden açma

Çeviri Düzenleyici'ye strings.xml dosyalarınızın herhangi birinden erişebilirsiniz.

  1. Soldaki Proje > Android panelinde ModuleName > res > values'ı seçin.
  2. Düzenlemek üzere açmak için strings.xml dosyasını çift tıklayın.
  3. strings.xml dosyasında, sağ üst köşedeki Open editor (Düzenleyiciyi aç) bağlantısını tıklayın.

Çevrilemeyen satırları yapılandırma

Çeviri Düzenleyici'de, bu satırdaki metnin çevrilmesini istemediğinizi belirtmek için Çevrilemez'i seçebilirsiniz. Çevrilmesini istemediğiniz metinler, ticari unvanlar ve ticari markalar gibi ürüne özgü metinler veya çevirisi olmayan teknik terimler olabilir.

Çevrilemez'i seçtiğinizde, varsayılan strings.xml dosyasındaki ilgili satıra translatable="false" eklenir. Aşağıdaki örnekte, ilk satırdaki EasyApp ürün adı olduğu için çevrilmemiştir.

<resources>
    <string name="app_name" translatable="false">EasyApp</string>
    <string name="action_settings">Settings</string>
    <string name="easy_app">I am a Simple App!</string>
    <string name="next_page">Next Page</string>
    <string name="second_page_message">I am the Second Page!</string>
    <string name="title_activity_second">SecondActivity</string>
</resources>

Dil ekleme ve silme

Çeviri Düzenleyici, BCP 47'yi destekler ve hedeflenen yerelleştirmeler için yerel ayar ve bölge (ülke) kodlarını tek bir seçimde birleştirir. Yerel ayar, dilden daha fazlasını tanımlar. Yerel ayar; tarih ve saat, para birimleri ve ondalık sayılar gibi öğeler için ülkeye bağlı biçimlendirmeyi içerir.

Dil eklemek için aşağıdakileri yapın:

  1. Çeviri Düzenleyici'de dünya simgesini tıklayın.
  2. Açılır listeden eklemek istediğiniz dili seçin.

    Yeni dil, Çeviri Düzenleyici'de görünür ve projeye strings.xml dosyası içeren bir values-* klasörü eklenir. Örneğin, İspanyolca için values-es.

Bir dili silmek için aşağıdakileri yapın:

Çeviri Düzenleyici'de bir dili silmek için sütundaki her değeri silebilir (Metin düzenleme, ekleme ve silme bölümüne bakın) veya ilgili dilin proje klasörünü aşağıdaki gibi silebilirsiniz:

  1. Soldaki Proje > Android panelinde ModuleName > res'i seçin.
  2. Silmek istediğiniz dilin values-* klasörünü sağ tıklayın. Örneğin, Hintçe için values-hi.
  3. Listeden Delete'i (Sil) seçerek klasörü ve strings.xml dosyasını silin.

Metin düzenleme, ekleme ve silme

Metin ayarlarını doğrudan strings.xml dosyasında veya Çeviri Düzenleyici aracılığıyla değiştirebilirsiniz. Bu bölümde Çeviri Düzenleyici yaklaşımı açıklanmaktadır. Çeviri Düzenleyici'de, liste görünümü veya Çeviri Düzenleyici'nin alt kısmındaki Çeviri alanı aracılığıyla metinleri düzenleyebilir, ekleyebilir veya silebilirsiniz.

Üstte liste görünümü ve altta Çeviri alanı.
Şekil 2. Üstte liste görünümü ve altta Çeviri alanı

Liste görünümü

Metin düzenlemek veya eklemek için aşağıdakileri yapın:

  1. Metin düzenlemek veya eklemek istediğiniz hücreyi çift tıklayın.
  2. Klavyeyle kopyalayıp yapıştırın veya aksan işaretlerini destekleyen bir klavyeniz varsa doğrudan liste görünümüne yazın.
  3. Sekme tuşuna basın veya imleci alanın dışına taşıyın.

Metni silmek için aşağıdakileri yapın:

  1. Silmek istediğiniz hücreyi çift tıklayın.
  2. Liste görünümünde metni seçip Sil'e basın.
  3. Sekme tuşuna basın veya imleci alanın dışına taşıyın.

Çeviri alanı

Metin düzenlemek veya eklemek için aşağıdakileri yapın:

  1. Liste görünümünde, metin düzenlemek veya eklemek istediğiniz hücreyi tek tıklayın.
  2. Çeviri alanında klavyeyle kopyalayıp yapıştırın veya aksan işaretlerini destekleyen bir klavyeniz varsa doğrudan Çeviri alanına yazın.
  3. Sekme tuşuna basın veya imleci alanın dışına taşıyın.

Metni silmek için aşağıdakileri yapın:

  1. Silmek istediğiniz hücreyi tek tıklayın.
  2. Çeviri alanında metni seçip Sil'e basın.

Anahtar ekleme ve silme

Çeviri Düzenleyici'deki Anahtar sütununda, strings.xml dosyalarınızdaki her bir veri öğesinin benzersiz tanımlayıcıları listelenir. Çeviri Düzenleyici'yi kullanarak anahtar ekleyip silebilirsiniz. Bir anahtarı sildiğinizde Çeviri Düzenleyici, anahtarı ve ilişkili tüm çevirilerini siler. Çeviri Düzenleyici, bir anahtarı silmek için Güvenli Silme yeniden düzenlemesini kullanır. Böylece, anahtar metninin başka bir yerde kullanılıp kullanılmadığını öğrenir ve anahtarı silmeden önce gerekli düzenlemeleri yapma şansına sahip olursunuz. Güvenli Silme yeniden düzenlemesi, anahtarı sildikten sonra kodunuzun derlenmeye devam etmesini sağlar.

Anahtar eklemek için aşağıdakileri yapın:

  1. Çeviri Düzenleyici'de Anahtar Ekle'yi tıklayın.
  2. İletişim kutusuna bir anahtar adı, varsayılan değer ve varsayılan strings.xml dosyasının konumunu girin.

    Çeviri Düzenleyici'deki anahtar ekleme iletişim kutusu.
    Şekil 3. Anahtar ekleme

Bir anahtarı silmek için aşağıdakileri yapın:

  1. Çeviri Düzenleyici'de silmek istediğiniz anahtarı seçin.
  2. Anahtarları Kaldır'ı tıklayın .
  3. Sil iletişim kutusunda, güvenli silme işlemi isteyip istemediğinize ve yorumlar ile dizelerde arama yapmak isteyip istemediğinize karar verip Tamam'ı tıklayın.

    Çeviri Düzenleyici'de anahtar silme iletişim kutusu.
    Şekil 4. Silme iletişim kutusu

    Silinen anahtara referans (kullanım) yoksa veya tüm referanslar güvenli bir şekilde daraltılabiliyorsa anahtar silinir. Aksi takdirde, Çeviri Düzenleyici, tespit edilen sorunlarla ilgili bilgileri içeren Kullanımlar Tespit Edildi iletişim kutusunu gösterir.

    Çeviri Düzenleyici'deki Kullanımlar Algılandı iletişim kutusu.
    Şekil 5. Kullanım Tespit Edildi iletişim kutusu
  4. Nelerin silineceğini incelemek için Kullanımları Görüntüle'yi seçin. Güvenli Silme Çakışmalarını Bul iletişim kutusu, silinmesi güvenli olmayan tüm kullanımları gösterir. Böylece ilgili kodunuzu düzenleyebilirsiniz.

    Güvenli olmayan kullanımları gösteren &quot;Güvenli Silme Çakışmalarını Bul&quot; iletişim kutusu.
    Şekil 6. Güvenli olmayan kullanımlar
  5. Bağlam menüsünü görüntülemek için bir kullanımı sağ tıklayın ve Kaynağa Git'i seçerek gerekli değişiklikleri yapın.

  6. Güvenli Silme Çakışmalarını Bul panelinde, dikkatinize sunulması gereken başka kullanım olmadığını doğrulamak için Güvenli Silme'yi Yeniden Çalıştır'ı seçin.

  7. Kullanımlar temizlendiğinde anahtarı silmek için Do Refactor'u (Yeniden Düzenle) tıklayın.

Hataları düzeltin

Şekil 7'de, İngilizce, Fransızca ve İspanyolca strings.xml dosyalarının içeriğini gösteren Çeviri Düzenleyici gösterilmektedir. Kırmızı metin, hata içeren satırları gösterir.

Çeviri Düzenleyici'de hatalar kırmızı metinle gösterilir.
Şekil 7. Kırmızı metin, düzeltmeniz gereken bir hata durumunu gösterir.

Bir hatayı düzeltmek için fareyle kırmızı metnin üzerine gelerek sorunun açıklamasını ve çözümünü görüntüleyin.

Çeviri Düzenleyici'de değişiklik yaptığınızda temel strings.xml dosyaları değişikliklerinizle güncellenir. Bir strings.xml dosyasında değişiklik yaptığınızda Çeviri Düzenleyici'deki ilgili sütun, değişikliklerinizle güncellenir.

Çeviri Düzenleyici düzeltmelerine örnekler:

  • Şekil 7'de, app_name satırında Çevrilemez seçeneğinin işaretli olduğu ancak İspanyolca çevirinin sağlandığı gösterilmektedir. Hatayı düzeltmek için İspanyolca çeviriyi silin.
  • Şekil 7'de, next_page satırında Fransızca çevirinin eksik olduğu gösterilmektedir. Hatayı düzeltmek için klavyenizi kullanarak hücreye Page Suivante yazın. Klavye kopyalama-yapıştırma işlemi, metni tüm aksan işaretleriyle birlikte hücreye kopyalar.

Yerelleştirilebilir metinleri yönetme ve test etme

Android platformu ve Android Studio, yerelleştirilebilir uygulama metninizi yönetmenize ve test etmenize yardımcı olacak çeşitli özellikler sunar. Bu özelliklerde, Arapça veya İbranice gibi sağdan sola (RTL) yazılan dillerle ilgili sorunları hedeflemenize yardımcı olacak seçenekler bulunur. Yerelleştirilebilir metninizi test etmek, mesajlarınızı daha sonra çeviriye gönderilmek üzere kaynak depoya göndermeden önce kullanıcı arayüzü metninde ve düzeninde ayarlamalar yapmanıza olanak tanır.

Sağdan sola yazılan dilleri destekleme

Jetpack Compose, sağdan sola (RTL) düzenleri yerel olarak işler. Düzen değiştiriciler ve API'ler, left ve right gibi mutlak yönler yerine start ve end gibi yön kavramları üzerine kuruludur. Sistem dili sağdan sola yazılan bir yerel ayara değiştiğinde Compose, bu düzenleri sizin için otomatik olarak yansıtır.

Uygulamanızın RTL yerel ayarını tanıması ve bu yansıtmayı tetiklemesi için uygulamanızın manifest dosyasını kullanarak etkinleştirmeniz gerekir.

Sağdan sola desteğini etkinleştirmek için aşağıdakileri yapın:

  1. AndroidManifest.xml dosyanızı açın.
  2. <application> öğesine android:supportsRtl="true" özelliğini ekleyin:
<manifest ... >
    <application
        ...
        android:supportsRtl="true">
    </application>
</manifest>

Compose'un metin düzenini, yansıtmayı ve özel RTL yapılandırmalarını nasıl işlediği hakkında daha fazla bilgi edinmek için RTL dilleriyle çalışma başlıklı makaleyi inceleyin.

Metin yönünü manuel olarak ayarlama

Jetpack Compose'da, düzen veya metin yönlerini zorunlu kılmak için görsel bir Özellikler penceresi kullanmazsınız. Compose, sistem yerel ayarına göre sağdan sola yansıtmayı otomatik olarak yönetir.

Ancak belirli bir metin öğesinin yönünü manuel olarak geçersiz kılmanız gerekiyorsa (örneğin, sağdan sola düzende soldan sağa dize görüntüleme) TextStyle öğenize bir TextDirection nesnesi iletebilirsiniz.

Desteklenen değerler şunlardır:

Compose'da metin stilini belirleme ve manuel metin yönlerini yapılandırma hakkında daha fazla bilgi edinmek için Metin stili belirleme başlıklı makaleyi inceleyin.

Uygulamanızda yerelleştirilmiş dizeler kullanma

Çeviri Düzenleyici'yi kullanarak dizelerinizi ekleyip çevirdikten sonra temel res/values/strings.xml dosyalarınız otomatik olarak güncellenir ve yerelleştirilmiş kaynakları doğrudan kullanıcı arayüzünüzde kullanabilirsiniz.

Yerelleştirilmiş metinleri görüntüleme, RTL'yi yerel olarak işleme ve farklı yerel ayarlar ile sözde yerel ayarları test etmek için @Preview kullanma hakkında bilgi edinmek isterseniz Compose'da Kaynaklar'ın Dizeler bölümüne bakın.

Sözde yerel ayarlar

Sözde yerel ayar, bir uygulama çevrildiğinde kullanıcı arayüzü, düzen, RTL ve diğer çeviri sorunlarına neden olan dillerin özelliklerini üstlenecek şekilde tasarlanmış simüle edilmiş bir yerel ayardır. Sözde yerel ayarlar, yerelleştirilebilir tüm mesajlar için İngilizce olarak okunabilen anında ve otomatik çeviriler sağlar. Bu sayede, kaynak kodunuzdaki çevrilemeyen mesajları yakalayabilirsiniz.

Sözde yerel ayarların nasıl kullanılacağı hakkında bilgi için Uygulamanızı sözde yerel ayarlarla test etme başlıklı makaleyi inceleyin.

Ek kaynaklar

İçerik görüntüleme