String Extraction Utility (Magic xpa 3.x)
When a programmer wants to develop a multi-lingual interface for an application, the programmer needs to maintain a translation dictionary containing all of the text phrases that exist in the application.
This utility makes the programmer's life easier by extracting all of the text phrases from the project.
To use the utility, you should:
-
Open the Tools menu and select the String Extractor option to access the String Extractor Wizard.
-
From the Welcome screen, click Next.
-
From the Project Details screen, decide whether all the programs or just those that were updated after the last scanned date will be processed. The first time that you run the wizard on the project, this text will be disabled.
-
Then, decide whether all the string in the expression or only those inside the MLSTrans() will be processed.
-
In the Output file field, enter an output file name.
-
Click Run and a Progress section will appear at the bottom of the screen. This indicates that the extraction is being performed. When the process is finished, a Finish message will appear.
-
Click OK to close the wizard.
|
Note:
|
1. The source of this tool exists in the StringExtractor folder under the %EngineDir%Add_On folder.
2. This utility is not updated for each Magic xpa version; you can modify the source files to fit your needs.
3. This utility uses XML views to read the source files and save the output. XML views are loaded into the DOM and therefore use lots of memory. The String Extractor utility may crash due to insufficient memory when working on big applications or big programs. To overcome this problem:
A. Limit the size of scanned programs.
If there is a specific program that causes the crash, check the source program size and add a condition in the String Extractor utility to skip a file larger than xxx MB. To process its strings, copy and split it into two temporary half size programs.
B. Change the result file.
You can decrease the size of the fields in the result XML file or save the output into a DB file instead of an SQL file. This change will increase the performance and reduce the memory consumption.
|
|
|
The Magic xpa Single User Edition does not support the String Extraction utility.
|
How Do I Define a Translation File?
