tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Chat
    Documentation
    Download PDF

    iOS

    Last updated: 2024-05-20 17:07:59
    Download PDF

      Feature Description

      The iOS version of TUIKit comes standard with Simplified Chinese, English, and Arabic language packs, serving as the display languages for the user interface. Guided by this document, you have the option to utilize the default language packs, or to customize the language translations and add additional language packs.
      Note：
      Beginning with version 7.5.4852, TUIKit has introduced support for RTL languages (languages with a right-to-left script, such as Arabic and Hebrew), concurrently incorporating Arabic into its built-in languages.
      English
      Arabic
      Simplified Chinese
      
      
      

      Using the built-in language

      If your app only requires Simplified Chinese, English, and Arabic languages, please refer to this section.

      Follow the system language

      You can use TUIKit directly without any additional steps. The language inside the component will follow the system language.

      Specify the displayed language

      Should you require to specify the interface language for TUIKit, please input the desired language in [TUIGlobalization setCustomLanguage:@""]. Once the language is specified, the internal component will no longer follow the system language. Language selection, value is:
      @"zh-Hans" ,//Simplified Chinese 
      @"en", // English
      @"ar", // Arabic
      Note:
      The language code inventory can be found in the appendix.

      Utilizing Additional Languages/Customizing Translation Expressions

      Should your application necessitate the inclusion of additional languages, or the modification of certain translation entries, please refer to this section. This chapter illustrates the process of adding new language packs and customizing translations, using the addition of a Korean language pack to the TUIGroup component as an example.

      Adding New Language Resource Files

      All inherent language packs we provide are stored within the TUICore component of your project's Pods, in the form of String file templates, located at the TUIKitLocalizable/Localizable/ path.
      
      Please create a new directory and name it {language code}.lproj. In this directory, add a new file named Localizable.strings. Here, ${language code} needs to be replaced with the ISO 639-1 language code. (You can directly copy the language file you are familiar with, such as zh-Hans.lproj, and directly modify the directory name.) Should you require compatibility support for multiple new languages, simply duplicate the necessary files, ensuring each one is accurately assigned its respective language encoding.
      For instance, when adding Korean, create a new language resource file: ko.lproj/Localizable.strings.
      

      Personalized Custom Translation

      The previous step has successfully generated the Korean resource file ko.lproj/Localizable.strings. The keys within the language resource files across different languages remain identical, allowing for customized translations of the specific content.

      Follow System Language

      Upon the addition of lproj resource packages for Simplified Chinese, Traditional Chinese, English, Korean, Russian, and Ukrainian, one can directly utilize TUIKit without the necessity for additional steps.
      Should there be other languages, they must be added in TUIGlobalization.m's + (NSString *)tk_localizableLanguageKey. The naming of the newly added language entries must adhere to the standard, as the component will adapt to the system language internally.
      
      Note：
      The inventory of language codes can be found in the ISO 639-1 language codes.

      Specified Display Language

      Should you require to specify the language for the TUIKit interface, please input the desired language in [TUIGlobalization setCustomLanguage:@""]. Once the language is specified, the internal components will no longer follow the system language. Language selection, represented by ISO 639-1 language codes. Using Korean as an example, [TUIGlobalization setCustomLanguage:@"ko"];
      The effect is illustrated as follows:
      

      Appendix: Language Code Table

      Language
      Code
      Language
      Code
      Arabic
      ar
      Bulgarian
      bg
      Croatian
      hr
      Czech
      cs
      Danish language
      da
      German
      de
      Greek
      el
      English
      en
      Estonian
      et
      Spanish
      es
      Finnish
      fi
      French
      fr
      Irish
      ga
      Hindi
      hi
      Hungarian
      hu
      Hebrew
      he
      Italian
      it
      Japanese
      ja
      Korean
      ko
      Latvian
      lv
      Lithuanian
      lt
      Dutch
      nl
      Norwegian
      no
      Polish
      pl
      Portuguese
      pt
      Swedish
      sv
      Romanian
      ro
      Russian
      ru
      Serbian
      sr
      Slovak
      sk
      Slovenian
      sl
      Thai
      th
      Turkish
      tr
      Ukrainian
      uk
      Chinese (Simplified)
      zh-Hans
      Chinese (Traditional)
      zh-Hant
      For the complete version, please refer here.
      Contact Us

      Contact our sales team or business advisors to help your business.

      Contact Us
      Technical Support

      Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy