String dan pelokalan di Pusat Admin Windows
Berlaku untuk: Pusat Admin Windows, Pratinjau Pusat Admin Windows
Mari kita lebih mendalami SDK Ekstensi Pusat Admin Windows dan berbicara tentang string dan pelokalan.
Untuk mengaktifkan pelokalan semua string yang dirender pada lapisan presentasi, manfaatkan file strings.resjson di bawah /src/resources/strings - sudah disiapkan. Saat Anda perlu menambahkan string baru ke ekstensi Anda, tambahkan ke file resjson ini sebagai entri baru. Struktur yang ada mengikuti format ini:
"<YourExtensionName>_<Component>_<Accessor>": "Your string value goes here.",
Anda dapat menggunakan format apa pun yang Anda suka untuk string, tetapi ketahuilah bahwa proses pembuatan (proses yang mengambil resjson dan menghasilkan kelas TypeScript yang dapat digunakan) mengonversi garis bawah (_) menjadi titik (.).
Misalnya, entri ini:
"HelloWorld_cim_title": "CIM Component",
Menghasilkan struktur aksesor berikut:
MsftSme.resourcesStrings<Strings>().HelloWorld.cim.title;
Menambahkan Bahasa Lain untuk Pelokalan
Untuk pelokalan ke bahasa lain, file strings.resjson perlu dibuat untuk setiap bahasa. File-file ini perlu ditempatkan di \loc\output\{!ExtensionName}\{!LanguageFolder}\strings.resjson. Bahasa yang tersedia dengan folder yang sesuai adalah:
| Language | Folder |
|---|---|
| Čeština | cs-CZ |
| Deutsch | de-DE |
| Inggris | id-ID |
| Español | es-ES |
| Français | fr-FR |
| Magyar | hu-HU |
| Italiano | it-IT |
| 日本語 | ja-JP |
| 한국어 | ko-KR |
| Nederlands | nl-NL |
| Polski | pl-PL |
| Português (Brasil) | pt-BR |
| Português (Portugal) | pt-PT |
| Русский | ru-RU |
| Svenska | sv-SE |
| Türkçe | tr-TR |
| 中文(简体) | zh-CN |
| 中文(繁體) | zh-TW |
Catatan
Jika kebutuhan struktur file Anda berbeda di dalam loc/output, Anda harus menyesuaikan localeOffset untuk tugas gulp 'generate-resjson-json-localized' yang ada di gulpfile.js. Offset ini adalah seberapa dalam folder loc seharusnya mulai mencari file strings.resjson.
Setiap file strings.resjson akan diformat dengan cara yang sama seperti yang disebutkan sebelumnya di bagian atas panduan ini.
Misalnya, untuk menyertakan pelokalan untuk Español, sertakan entri ini dalam \loc\output\HelloWorld\es-ES\strings.resjson:
"HelloWorld_cim_title": "CIM Componente",
Setiap kali Anda menambahkan string yang dilokalkan, hasil gulp harus dijalankan lagi agar string tersebut muncul. Jalankan:
gulp generate
Untuk mengonfirmasi bahwa string Anda telah dibuat, navigasikan ke \src\app\assets\strings\{!LanguageFolder}\strings.resjson. Entri Anda yang baru ditambahkan akan muncul dalam file ini.
Sekarang jika Anda mengalihkan opsi bahasa di Pusat Admin Windows, Anda akan dapat melihat string yang dilokalkan di ekstensi Anda.