Develop for XenServer

Resources and Internationalization

November 19, 2024

Contributed by:

X X

In the following text, <plug-in_name> is the value of the plug-in name attributes and <entry_name> is the value of the MenuItem/TabPage name attributes.

XenCenter reads the following resources from <plug-in>.resources.dll:

<plug-in_name>.description - Shown in the plug-ins dialog.
<plug-in_name>.copyright - Vendor copyright statement. Shown in the plug-ins dialog.
<plug-in_name>.link - Link to vendor’s webpage. Shown in the plug-ins dialog.
<entry_name>.label - The menu entry label.
<entry_name>.description - Shown in the plug-ins dialog.
<entry_name>.icon - The icon to use in the menu entry. This icon is a 16x16 PNG. Can be omitted.
<entry_name>.tooltip - The tooltip to use when the menu entry is disabled. Can be omitted.

To create the resources file:

Create a RESX file containing the appropriate strings (You can do this task in any project in Visual Studio, for example, console project).
Open up Visual Studio command prompt and navigate to the RESX file’s directory
Run ResGen.exe <plug-in_name>.resx

(ResGen.exe is found in C:\Program Files\Microsoft SDKs\Windows\v7.0A\bin).
Run

al.exe /t:lib /embed:<plug-in_name>.resources /out:<plug-in_name>.resources.dll

(al.exe is also found in C:\Program Files\Microsoft SDKs\Windows\v7.0A\bin).
If you want to compile extra resource DLLs for any specific cultures, edit the RESX file appropriately. Run these commands again with an extra /culture argument in the al.exe command specifying the two letter culture string. For example, for Japanese, run:

al.exe /t:lib /embed:<plug-in_name>.resources /culture:ja /out:<plug-in_name>.resources.dll
Place the invariant culture <plug-in_name>.resources.dll into the <plug-in_dir> folder (with <plug-in_name>.xcplugin.xml and so on). Set up other cultures as follows: <plug-in_dir>\<culture>\<plug-in_name>.resources.dll where <culture> is the two-letter ISO culture name.

Unless stated otherwise, all of these entries are mandatory. If any are missing, then the problem is logged, and the menu option is disabled.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Resources and Internationalization

November 19, 2024

Contributed by:

X X

November 19, 2024

Contributed by:

X X

Resources and Internationalization

In this article