Udostępnij przez

Ciągi i lokalizacja w Centrum administracyjnym systemu Windows

  • Dotyczy: ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Zgłębmy bardziej szczegółowo rozszerzenia SDK dla Windows Admin Center i porozmawiajmy o ciągach tekstowych i lokalizacji.

Aby włączyć lokalizację wszystkich ciągów renderowanych w warstwie prezentacji, skorzystaj z pliku strings.resjson w obszarze /src/resources/strings — jest już skonfigurowany. Gdy musisz dodać nowy ciąg do rozszerzenia, dodaj go do tego pliku resjson jako nowy wpis. Istniejąca struktura ma następujący format:

"<YourExtensionName>_<Component>_<Accessor>": "Your string value goes here.",

Możesz użyć dowolnego formatu dla ciągów, ale należy pamiętać, że proces generowania (proces, który pobiera plik resjson i wyprowadza używaną klasę TypeScript), konwertuje podkreślenie (_) na kropki (.).

Na przykład ten wpis:

"HelloWorld_cim_title": "CIM Component",

Generuje tę następującą strukturę akcesoryjną:

MsftSme.resourcesStrings<Strings>().HelloWorld.cim.title;

Dodawanie innych języków na potrzeby lokalizacji

W przypadku lokalizacji w innych językach należy utworzyć plik strings.resjson dla każdego języka. Te pliki należy umieścić w \loc\output\{!LanguageFolder}\strings.resjson. Dostępne języki z odpowiednimi folderami to:

Język 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
Português (Portugalia) pt-PT
Русский ru-RU
Svenska sv-SE
Türkçe tr-TR
中文(简体) zh-CN
中文(繁體) zh-TW

Note

Jeśli Twoje potrzeby dotyczące struktury plików różnią się w katalogu loc/output, musisz dostosować localeOffset dla zadania gulp "generate-resjson-json-localized", które znajduje się w gulpfile.js. To przesunięcie określa, jak głęboko w folderze loc należy rozpocząć wyszukiwanie plików strings.resjson.

Każdy plik strings.resjson będzie formatowany w taki sam sposób, jak wcześniej wymienione na początku tego przewodnika.

Aby na przykład uwzględnić lokalizację dla Español, dołącz ten wpis w \loc\output\HelloWorld\es-ES\strings.resjson:

"HelloWorld_cim_title": "CIM Componente",

Za każdym razem, gdy dodasz zlokalizowane ciągi, należy uruchomić ponownie polecenie gulp generate, aby się pojawiły. Run:

gulp generate

Aby potwierdzić, że te ciągi zostały wygenerowane, przejdź do \src\app\assets\strings\{!LanguageFolder}\strings.resjson. Nowo dodany wpis pojawi się w tym pliku. Teraz, jeśli przełączysz opcję języka w Centrum administracyjnym systemu Windows, będziesz mógł zobaczyć zlokalizowane ciągi w swoim rozszerzeniu.

  • Last updated on