Databases
StackOverflow2013
Postsdbo
POSingle-assembly multi-language Windows Forms deployment (ILMerge and satellite assemblies / localization) - possible?
 

Note that there are some explanatory texts on larger screens.

plurals
  1. POSingle-assembly multi-language Windows Forms deployment (ILMerge and satellite assemblies / localization) - possible?
    primarykey
    data
    text
    <p>I have a simple Windows Forms (C#, .NET 2.0) application, built with Visual Studio 2008.</p> <p>I would like to support multiple UI languages, and using the "Localizable" property of the form, and culture-specific .resx files, the localization aspect works seamlessly and easily. Visual Studio automatically compiles the culture-specific resx files into satellite assemblies, so in my compiled application folder there are culture-specific subfolders containing these satellite assemblies.</p> <p>I would like to have the application be deployed (copied into place) as a <strong>single assembly</strong>, and yet retain the ability to contain multiple sets of culture-specific resources.</p> <p>Using <a href="http://www.microsoft.com/downloads/details.aspx?familyid=22914587-b4ad-4eae-87cf-b14ae6a939b0&amp;displaylang=en#Overview" rel="noreferrer">ILMerge</a> (or <a href="https://github.com/gluck/il-repack" rel="noreferrer">ILRepack</a>), I can merge the satellite assemblies into the main executable assembly, but the standard .NET ResourceManager fallback mechanisms do not find the culture-specific resources that were compiled into the main assembly.</p> <p>Interestingly, if I take my merged (executable) assembly and place copies of it into the culture-specific subfolders, then everything works! Similarly, I can see the main and culture-specific resources in the merged assemby when I use <a href="http://en.wikipedia.org/wiki/.NET_Reflector" rel="noreferrer">Reflector</a> (or <a href="http://wiki.sharpdevelop.net/ILSpy.ashx" rel="noreferrer">ILSpy</a>). But copying the main assembly into culture-specific subfolders defeats the purpose of the merging anyway - I really need there to be just a single copy of the single assembly...</p> <p>I'm wondering <strong>whether there is any way to hijack or influence the ResourceManager fallback mechanisms to look for the culture-specific resources in the same assembly rather than in the GAC and culture-named subfolders</strong>. I see the fallback mechanism described in the following articles, but no clue as to how it would be modified: <a href="http://blogs.msdn.com/bclteam/archive/2009/02/16/working-with-the-resourcemanager-kim-hamilton.aspx" rel="noreferrer">BCL Team Blog Article on ResourceManager</a>.</p> <p>Does anyone have any idea? This seems to be a relatively frequent question online (for example, another question here on Stack Overflow: "<a href="https://stackoverflow.com/questions/1613407/ilmerge-and-localized-resource-assembli">ILMerge and localized resource assemblies</a>"), but I have not found any authoritative answer anywhere.</p> <hr> <h2>UPDATE 1: Basic Solution</h2> <p>Following <a href="https://stackoverflow.com/questions/1952638/single-assembly-multi-language-windows-forms-deployment-ilmerge-and-satellite-as/1955060#1955060">casperOne's recommendation below</a>, I was finally able to make this work.</p> <p>I'm putting the solution code here in the question because casperOne provided the only answer, I don't want to add my own.</p> <p>I was able to get it to work by pulling the guts out of the Framework resource-finding fallback mechanisms implemented in the "InternalGetResourceSet" method and making our same-assembly search the <strong>first</strong> mechanism used. If the resource is not found in the current assembly, then we call the base method to initiate the default search mechanisms (thanks to @Wouter's comment below).</p> <p>To do this, I derived the "ComponentResourceManager" class, and overrode just one method (and re-implemented a private framework method):</p> <pre><code>class SingleAssemblyComponentResourceManager : System.ComponentModel.ComponentResourceManager { private Type _contextTypeInfo; private CultureInfo _neutralResourcesCulture; public SingleAssemblyComponentResourceManager(Type t) : base(t) { _contextTypeInfo = t; } protected override ResourceSet InternalGetResourceSet(CultureInfo culture, bool createIfNotExists, bool tryParents) { ResourceSet rs = (ResourceSet)this.ResourceSets[culture]; if (rs == null) { Stream store = null; string resourceFileName = null; //lazy-load default language (without caring about duplicate assignment in race conditions, no harm done); if (this._neutralResourcesCulture == null) { this._neutralResourcesCulture = GetNeutralResourcesLanguage(this.MainAssembly); } // if we're asking for the default language, then ask for the // invariant (non-specific) resources. if (_neutralResourcesCulture.Equals(culture)) culture = CultureInfo.InvariantCulture; resourceFileName = GetResourceFileName(culture); store = this.MainAssembly.GetManifestResourceStream( this._contextTypeInfo, resourceFileName); //If we found the appropriate resources in the local assembly if (store != null) { rs = new ResourceSet(store); //save for later. AddResourceSet(this.ResourceSets, culture, ref rs); } else { rs = base.InternalGetResourceSet(culture, createIfNotExists, tryParents); } } return rs; } //private method in framework, had to be re-specified here. private static void AddResourceSet(Hashtable localResourceSets, CultureInfo culture, ref ResourceSet rs) { lock (localResourceSets) { ResourceSet objA = (ResourceSet)localResourceSets[culture]; if (objA != null) { if (!object.Equals(objA, rs)) { rs.Dispose(); rs = objA; } } else { localResourceSets.Add(culture, rs); } } } } </code></pre> <p>To actually use this class, you need to replace the System.ComponentModel.ComponentResourceManager in the "XXX.Designer.cs" files created by Visual Studio - and you will need to do this every time you change the designed form - Visual Studio replaces that code automatically. (The problem was discussed in "<a href="http://social.msdn.microsoft.com/Forums/en/vsx/thread/c87c991d-78cf-4fa3-aa7d-c3531fddbe88" rel="noreferrer">Customize Windows Forms Designer to use MyResourceManager</a>", I did not find a more elegant solution - I use <a href="http://sourceforge.net/projects/fart-it/" rel="noreferrer">fart.exe</a> in a pre-build step to auto-replace.)</p> <hr> <h2>UPDATE 2: Another Practical Consideration - more than 2 languages</h2> <p>At the time I reported the solution above, I was actually only supporting two languages, and ILMerge was doing a fine job of merging my satellite assembly into the final merged assembly.</p> <p>Recently I started working on a similar project where there are <em>multiple</em> secondary languages, and therefore multiple satellite assemblies, and ILMerge was doing something very strange: Instead of merging the multiple satellite assemblies I had requested, it was merging the first satellite assembly in multiple times!</p> <p>eg command-line:</p> <pre><code>"c:\Program Files\Microsoft\ILMerge\ILMerge.exe" /t:exe /out:%1SomeFinalProg.exe %1InputProg.exe %1es\InputProg.resources.dll %1fr\InputProg.resources.dll </code></pre> <p>With that command-line, I was getting the following sets of resources in the merged assembly (observed with ILSpy decompiler):</p> <pre><code>InputProg.resources InputProg.es.resources InputProg.es.resources &lt;-- Duplicated! </code></pre> <p>After some playing around, I ended up realizing this is just a bug in ILMerge when it encounters <strong>multiple files with the same name</strong> in a single command-line call. The solution is simply to merge each satellite assembly in a different command-line call:</p> <pre><code>"c:\Program Files\Microsoft\ILMerge\ILMerge.exe" /t:exe /out:%1TempProg.exe %1InputProg.exe %1es\InputProg.resources.dll "c:\Program Files\Microsoft\ILMerge\ILMerge.exe" /t:exe /out:%1SomeFinalProg.exe %1TempProg.exe %1fr\InputProg.resources.dll </code></pre> <p>When I do this, the resulting resources in the final assembly are correct:</p> <pre><code>InputProg.resources InputProg.es.resources InputProg.fr.resources </code></pre> <p>So finally, in case this helps clarify, here's a complete post-build batch file:</p> <pre><code>"%ProgramFiles%\Microsoft\ILMerge\ILMerge.exe" /t:exe /out:%1TempProg.exe %1InputProg.exe %1es\InputProg.resources.dll IF %ERRORLEVEL% NEQ 0 GOTO END "%ProgramFiles%\Microsoft\ILMerge\ILMerge.exe" /t:exe /out:%1SomeFinalProg.exe %1TempProg.exe %1fr\InputProg.resources.dll IF %ERRORLEVEL% NEQ 0 GOTO END del %1InputProg.exe del %1InputProg.pdb del %1TempProg.exe del %1TempProg.pdb del %1es\*.* /Q del %1fr\*.* /Q :END </code></pre> <hr> <h2>UPDATE 3: ILRepack</h2> <p>Another quick note - One of the things that bothered me with ILMerge was that it is an additional proprietary Microsoft tool, not installed by default with Visual Studio, and therefore an extra dependency that makes it that little bit harder for a third party to get started with my open-source projects.</p> <p>I recently discovered <a href="https://github.com/gluck/il-repack" rel="noreferrer">ILRepack</a>, an open-source (Apache 2.0) equivalent that so far works just as well for me (drop-in replacement), and can be freely distributed with your project sources.</p> <hr> <p>I hope this helps someone out there!</p>
    singulars
    1. PO
      singulars
      1. PTAnswer
    1. This table or related slice is empty.
    1. PTQuestion
    1. USCommunity
    1. USTao
    plurals
    1. PL
      singulars
      1. LTLinked
    1. PL
      singulars
      1. LTLinked
    2. PL
      singulars
      1. LTLinked
    3. PL
      singulars
      1. LTLinked
    1. This table or related slice is empty.
    1. PO
      singulars
      1. PTAnswer
    2. PO
      singulars
      1. PTAnswer
    1. VO
      singulars
      1. POSingle-assembly multi-language Windows Forms deployment (ILMerge and satellite assemblies / localization) - possible?
      1. This table or related slice is empty.
      1. VTUpMod
    2. VO
      singulars
      1. POSingle-assembly multi-language Windows Forms deployment (ILMerge and satellite assemblies / localization) - possible?
      1. This table or related slice is empty.
      1. VTUpMod
    3. VO
      singulars
      1. POSingle-assembly multi-language Windows Forms deployment (ILMerge and satellite assemblies / localization) - possible?
      1. This table or related slice is empty.
      1. VTUpMod
    1. COAfter some more (relatively obscessive) searching, I have found some promising snippets: http://www.neowin.net/forum/lofiversion/index.php/t625641.html http://social.msdn.microsoft.com/Forums/en/vsx/thread/c87c991d-78cf-4fa3-aa7d-c3531fddbe88 It looks like creating a custom ResourceManager will be the way to go - I'm off to decompile the default ResourceManager (Reflector to the rescue!) to see if I can better understand what it does / how it works.
      singulars
      1. POSingle-assembly multi-language Windows Forms deployment (ILMerge and satellite assemblies / localization) - possible?
      1. USTao
    2. COHello. I need to do exactly the same. I've added this new class and replaced in a designer file, but I'm getting NullReferenceException at line: this.outputPath.Properties.AutoHeight = ((bool)(resources.GetObject("outputPath.Properties.AutoHeight"))); (resources is a SingleAssemblyComponentResourceManager) outputPath - is a DevExpress control. Even after merging all DevExpress assemblies.
      singulars
      1. POSingle-assembly multi-language Windows Forms deployment (ILMerge and satellite assemblies / localization) - possible?
      1. USieaglle
    3. CODo you know what's actually Null? is it the "resources" object that's not actually initialized? Not sure this is the best forum for me to help you work on your code, but feel free to send me details at stuff at klerks dot biz.
      singulars
      1. POSingle-assembly multi-language Windows Forms deployment (ILMerge and satellite assemblies / localization) - possible?
      1. USTao
 

Querying!

 
Guidance
A row detail

Detail views are divided into sections. All the information in the data section comes from columns in the selected row. The other sections display data from other, related rows.

Related data can be related in a to-one or a to-many fashion. Captions of data related in a to-many fashion link to a list view showing a filtered view of the table.

Try moving around until you find a non-empty to-many entry and click on the label to get to one. You can move back to the root by clicking on the database name in the header.

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload