---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://yandex.com.tr/dev/games/doc/en/sdk/cocos/localization.md
  - https://yandex.com.tr/dev/games/doc/hi/sdk/cocos/localization.md
  - https://yandex.com.tr/dev/games/doc/ko/sdk/cocos/localization.md
  - https://yandex.com.tr/dev/games/doc/ru/sdk/cocos/localization.md
  - https://yandex.com.tr/dev/games/doc/tr/sdk/cocos/localization.md
  - https://yandex.com.tr/dev/games/doc/vi/sdk/cocos/localization.md
  - https://yandex.com.tr/dev/games/doc/zh/sdk/cocos/localization.md
  - href: https://yandex.com.tr/dev/games/doc/tr/sdk/cocos/localization.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com.tr/dev/games/doc/tr/llms.txt?revision=r21861215
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/games/doc/tr/llms.txt?revision=r21861215

# Yerelleştirme

<!-- source: tr/_includes/script-common.md -->
<!-- source: tr/_includes/script/index-js.md -->

<!-- endsource: tr/_includes/script/index-js.md -->

<!-- source: tr/_includes/script/requirements-js.md -->

<!-- endsource: tr/_includes/script/requirements-js.md -->

<!-- source: tr/_includes/script/image-modal-js.md -->

<!-- endsource: tr/_includes/script/image-modal-js.md -->
<!-- endsource: tr/_includes/script-common.md -->

## Yerelleştirme Editörü {#localization-editor}

Çeviriler proje içinde JSON formatında saklanır ve bunları düzenlemek için bu formatı kullanmanızı öneririz.

Eklentiyi kurduktan sonra Yandex Oyun SDK'sı bölümünde **Localization Editor** seçeneğine tıklayın.

Bir yerelleştirme oluşturmak için sol üst köşedeki **Create** düğmesine tıklayın.

![Cocos Creator ekran görüntüsü, "Localization Editor" penceresi: imleç sol üst köşedeki "+ New" düğmesinin üzerinde. Bu pencerenin sağında kod düzenleyicisi bulunur, ilk satırda "{", ikinci satırda "}" yazılıdır.](../../_images/cocos/localization/create-loc.webp)

Önünüzde dil seçebileceğiniz bir modal pencere açılacaktır. İşiniz bittiğinde **Create JSON file** düğmesine tıklayın.

![Cocos Creator ekran görüntüsü, "Localization Editor" penceresinin üzerinde açılır pencere. Pencerenin ortasında "Create new localization" metni, altında "Language" başlığı ve açılır listede "Afar (aa)" dili seçili, daha altında "Create JSON file!" düğmesi.](../../_images/cocos/localization/create-json.webp)

Örneğin, _English (en)_ seçeneğini seçin ve düzenleyiciye aşağıdakini girin:

```json showLineNumbers
{
    "title": "best game in the world 2"
}
```

Yerelleştirmeyi kaydetmek ve oyunda test etmek için **Save** düğmesine tıklayın.

![Cocos Creator ekran görüntüsü, "Localization Editor" penceresi (pencere adı mavi yazı tipiyle yazılmıştır). Sol üst köşede üç düğme vardır: "+ New", disket simgesi ve "Save" metni (imleç bu düğmenin üzerinde), klasör simgesi ve "Open" metni. Altında tek bir "EN" dosyası olan içindekiler listesi. Bu pencerenin sağında kod düzenleyicisi bulunur, ilk satırda "{", ikinci satırda ""title": "best game in the world 2"", üçüncü satırda "}" yazılıdır.](../../_images/cocos/localization/save-loc.webp)

### Yerelleştirmenizi Uygulama {#localization-use}

Yerelleştirmeyi iki şekilde uygulayabilirsiniz: `l10n.t()` yöntemi veya akıllı yerelleştirme bileşeni ile.

#### l10n.t yöntemi {#l10nt-method}

Öncelikle `l10n.t()` yöntemini kullanmayı deneyelim. Yeni bir bileşen oluşturun ve içine aşağıdakileri yerleştirin:

```tsx showLineNumbers
import { _decorator, Component, Label } from 'cc';
import { l10n } from 'db://yandex-games-sdk/ysdk';
const { ccclass, requireComponent } = _decorator;

@ccclass('ButtonLocalizationTest') // Bileşen adı.
@requireComponent(Label) // Label bileşenine bağımlılık.
export class ButtonLocalizationTest extends Component {
    onLoad() {
        const label = this.getComponent(Label); // Label bileşenini alıyoruz.
        label.string = l10n.t('title'); // Daha önce belirlenmiş anahtara göre Label metnini ayarlıyoruz.
    }
}
```

Sahnede Label bileşenine sahip bir düğüm oluşturduktan sonra, bileşeni düğüme sürükleyerek onu yerelleştirebilirsiniz.

![Cocos Creator kurulum videosu: "Hierarchy" penceresinde "scene-2D" kök öğesiyle yapı genişletilmiş. "Camera" öğesini içeren "Canvas" öğesini içerir. Kullanıcı sağ tıklar, "Create" → "2D objects" → "Label" seçer. "Label" nesnesi belirir ve kullanıcı onu seçer, böylece "Inspector" penceresinde özellikleri görüntülenir. "Assets" penceresinde "scene-2D" öğesinin yanında "LabelLocalization Test" öğesi bulunur. Kullanıcı bu öğeyi cc.Label bölümüne sürükler. Ardından kullanıcı Önizleme panelindeki "Play" düğmesine basar (ekranın üst kısmında, ortada bulunur). Etkileşimli bir oyun içeren bir açılır pencere belirir, yükleme sonrasında ekranda yerelleştirilmiş "best game in the world 2" yazısı görünür.](../../_images/cocos/localization/label.gif)

#### Hazır L10nLabel Bileşeni {#l10nlabel}

Eklentide, anahtarı doğrudan düzenleyicide gösteren hazır bir bileşen vardır. Değişiklikleri görmek için projeyi derlemek gerekmez, çünkü çeviri düzenleyicisinde değişiklik yapıldığında otomatik olarak güncellenir.

İlgilendiğiniz düğüm için **Add Component** düğmesine tıklayın, **YandexGamesSDK** grubuna ilerleyin ve **L10nLabel** seçeneğini seçin.

![Cocos Creator kurulum videosu: kullanıcı bileşen listesinin sonundaki "Add component" düğmesine basar. Açılır listede kullanıcı "YandexGamesSDK" → "L10nLabel" seçer.](../../_images/cocos/localization/l10n-label.gif)

Yerelleştirme değişikliklerinin projeyi yeniden derlemeye gerek kalmadan hemen görüntülenmesi için anahtarınızı **Key** alanına girin.

![Cocos Creator kurulum videosu: "Localization Editor" penceresinde (pencere adı mavi yazı tipiyle yazılmıştır) kullanıcı metni düzenler. ""title": "best game in 3asd a asd a"" metnini ""title": "best game in the world 3"" olarak değiştirir. Ardından "Localization Editor" penceresinin sol üst köşesindeki disket simgesi ve "Save" metni olan düğmeye basar. Hemen ardından "Scene" penceresindeki metin "best game in 3asd a asd a" yerine "best game in the world 3" olarak değişir.](../../_images/cocos/localization/enter-key.gif)

---


<!-- source: tr/_includes/sdk/button-git.md -->
<a href="https://github.com/yandex-games-plugins/cocos">
  <span class="button">Depo</span>
</a>
<!-- endsource: tr/_includes/sdk/button-git.md -->
