Rangkaian Teks dan Pelokalan di Pusat Admin Windows

Mari kita lebih mendalami SDK Ekstensi Pusat Administrasi Windows dan mengulas 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 siap 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\{!LanguageFolder}\strings.resjson. Bahasa yang tersedia dengan folder yang sesuai adalah:

Bahasa	Folder
Čeština	cs-CZ
Deutsch	de-DE
English	en-US
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
Bahasa Portugis (Portugal)	pt-PT
Русский	ru-RU
Svenska	sv-SE
Türkçe	tr-TR
中文(简体)	zh-CN
中文(繁體)	zh-TW

Note

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 menunjukkan seberapa jauh ke dalam folder loc seharusnya memulai pencarian untuk 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, perintah gulp generate harus dijalankan lagi agar string tersebut muncul. Run:

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.