LRM Android Support

From Lingoport Wiki
Revision as of 00:33, 9 March 2021 by Llawson (talk | contribs) (Example of Project Definition for Resources)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Naming Conventions

Android resources files are named strings.xml. Typically, an Android application will have one strings.xml base file located under a directory named values. The corresponding translated resource bundle will be also named strings.xml and located under a directory named values-fr (for French) at the same level as values.

For example, for a few locales, the directory structure and file names would be:

 res/values/strings.xml
 res/values-de/strings.xml
 res/values-es/strings.xml
 res/values-fr/strings.xml
 res/values-it/strings.xml
 res/values-ja/strings.xml
 res/values-ko/strings.xml
 res/values-pt/strings.xml
 res/values-ru/strings.xml
 res/values-zh/strings.xml

The bold file is the base file (U.S. English in this instance since <default-locale>en</default-locale>) to be translated into German, Spanish, French, Italian, Japanese, Korean, Portugese, Russian, and Chinese.

Example strings.xml File For Android

For information on Android string resources see https://developer.android.com/guide/topics/resources/string-resource

 <?xml version="1.0" encoding="utf-8"?>
 <resources xmlns:tools="http://schemas.android.com/tools">
  <string name="menu_find">Find</string>
  <string name="menu_historical_search">Search Historical Records</string>
  <string name="person_activity_title">Person</string>
  <string name="label_person_tree_button">View This Tree</string>
  <string-array name="planets_array">
       <item>Mercury</item>
       <item>Venus</item>
       <item>Earth</item>
       <item>Mars</item>
   </string-array>
   <plurals name="numberOfSongsAvailable">
       <item quantity="one">%d song found.</item>
       <item quantity="other">%d songs found.</item>
   </plurals>
 </resources>

xml parser type using AndroidParser.xml format definition

valid Android xml syntax

Files that use the xml parser and the AndroidParser.xml format definition are expected to have valid Android xml file syntax

Android .xml uses the xml parser type

When defining a project containing LRM Standard Android.xml resource files, there is no need to define a <parser-type> as the xml parser will always be used along with the AndroidParser.xml format definition.

unique file extension needs to define xml parser type. Xml format definition defaults to Android

If a unique file extension is a valid Android xml file, then:

  • In the Project definition xml file, <parser-type> should be xml
  • There is no need to copy over a format definition because the default definition is for Android syntax.

Example of Project Definition for Resources

The following is an example of xml resource file definitions. See resource extensions for more information on extensions. The project defintion can also be setup using Jenkins

  <resource-extensions>
   <resource-extension>
    <!-- parser-type not needed since .xml is a standard LRM extension that maps to the xml parser type -->
     <extension>xml</extension>
     <file-name-pattern/>
     <use-pattern-on-dflt-locale>0</use-pattern-on-dflt-locale>
     <file-location-pattern>*-l-c-v</file-location-pattern>
     <use-location-pattern-on-dflt-locale>0</use-location-pattern-on-dflt-locale>
     <base-file-encoding>UTF-8</base-file-encoding>
     <localized-file-encoding>UTF-8</localized-file-encoding>
     <parameter-regex-pattern><![CDATA[%d|%s|%d+$s|%d+$d|%\{w+\}]]></parameter-regex-pattern>
   </resource-extension>
   <resource-extension>     
     <!-- parser-type is required because .myext is not a standard LRM extension -->
     <extension>myext</extension>
     <!-- There is no need to copy over a parser.xml because the default xml parser is for Android files -->
     <parser-type>xml</parser-type>
     <file-name-pattern/>
     <use-pattern-on-dflt-locale>0</use-pattern-on-dflt-locale>
     <file-location-pattern>*-l-c-v</file-location-pattern>
     <use-location-pattern-on-dflt-locale>0</use-location-pattern-on-dflt-locale>
     <base-file-encoding>UTF-8</base-file-encoding>
     <localized-file-encoding>UTF-8</localized-file-encoding>
     <parameter-regex-pattern><![CDATA[%d|%s|%d+$s|%d+$d|%\{w+\}]]></parameter-regex-pattern>
   </resource-extension>
 </resource-extensions>