Flash Flex 国际化问题解决方案大全

Flash Flex 国际化问题解决方案大全
2010年11月18日
　　简单项目的Flash Flex 国际化设置方法
　　如果是简单项目，一般采用的是类似struts的bundle类似的方法，至于好处嘛会STRUTS的人都应该知道。 直接在项目中写.properties文件，具体做法如下： [b]在项目上点击右键，选择Properties。 [b]然后选择Flex Compiler，在Additional Compiler arguments下面已经配置好语言包了，默认为-locale en_US。 [b]这时我们可以用一个locale目录来简单定制我们额外设置（当然不包括Flex内部控件的语言）的语言设置。 [b]比如改为：-locale=en_US -source-path+=g:\flexproj\locale\{locale}。这样在g盘的flexproj目录下建立一个locale目录。 [b]然后目录下放置包含我们要扩展的语言文件的文件夹就可以了。比如：g:\flexproj\locale\en_US。 [b]注意：locale下面的目录名应该和-locale=设置的名称一致。 [b]那么这样，我们就可以使用额外的语言设置了。 [b]举个例子吧： [b]项目属性里Additional Compiler arguments配置为 [b]-locale+=en_US -source-path+=g:\flexproj\testgoufang\locale\{locale} [b]然后在对应的locale目录下添加国际化资源文件， [b]g:\flexproj\testgoufang\locale\en_US\strings.properties [b]这一部分跟struts相似。 [b]里面的内容为键=值的形式，如： [b]Title=测试项目 [b]User=用户名 [b]Password=密码 [b]………… [b]………… [b]使用的时候可以通过[ResourceBundle]元数据标签来绑定locale文件，如： [b] [b]                              [ResourceBundle("strings")] [b] [b]即绑定上文提到的strings.properties文件，然后我们可以通过ResoueceManager来读出其中的内容，比如： [b]var Title : String = resourceManager.getString("strings", 'Title'); [b]或者绑定到控件： [b][Bindable] [b]private var Title:String; [b]………… [b]Title = resourceManager.getString("strings", 'Title'); [b]………… [b] [b]如此多个项目共享统一资源
　　------------------------------------------------------------------------------------------------------------------------------
　　[b]长期使用中文资源 的Flash Flex 国际化设置方法
　　如果是长期的使用中文资源，我们会用另一种方法，即SWF资源文件法： 首先，了解一些背景，Flex内部的国际化文件/库只支持两个版本，一个是en_US，另一个是ja_JP。也就是说，开发者在编译Flex项目的时候在Additional Compiler arguments下配置locale=zh_CN是一定会报错的。 [b]原因是因为zh_CN库，Flex是没有提供的。 [b]那么应该怎么办呢，答案是：自己来构建一个。 [b]事实上，在Flex的sdk中已经提供了所有国际化文本的源码，我们可以通过这些源码来进行核心的国际化功能。 [b]我们可以在sdk的目录下找到对应的源码文件夹，如： [b]D:\Program Files\Adobe\Flex Builder 3\sdks\moxie\frameworks\projects\framework\bundles\en_US [b]这样我们可以根据这个原型的复制品来制作其他语言包。 [b]比如，我们来制作一个中文语言包： [b]首先，先在bundles下创建en_US的副本，然后将副本更名为zh_CN，然后把zh_CN下面的具体内容翻译成中文。 [b]使用SDK命令，在sdk下输入 [b]bin\compc -locale=zh_CN -source-path=frameworks/projects/framework/bundles/zh_CN/src -include-resource-bundles=collections,containers,controls,core,effects,formatters,logging,SharedResources,skins,states,styles,validators [b]-output=frameworks/locale/zh_CN/framework_rb.swc [b]则会将Flex的collections,containers,controls,core,effects,formatters,logging,SharedResources,skins,states,styles,validators模块的语言源文件编译成frameworks/locale/zh_CN/framework_rb.swc的语言库文件，这样，在Additional Compiler arguments下配置locale=zh_CN就不会报错了。 [b]此外，语言文件也可以像CSS文件一样编译成SWF文件： [b]mxmlc -locale= zh_CN [b]-source-path=locale/{locale} -allow-source-path-overlap=true -include-resource-bundles=collections,containers,controls,core,effects,myResources,skins,styles -output=Resources_ zh_CN.swf [b]编译后的文件更小，效率会更高。 [b]这样，从此使用-locale=zh_CN 就等于全部翻译成中文了，使用-locale=en_US编译就又回去了，在程序中什么也不用改动
　　---------------------------------------------------------------------------------------------------------------------------------------------------------
　　[b]Flash Flex 编译国际化
　　编译CSS资源
　　文件浏览器（Navigator）中，在标准的Flex CSS文件上点击右键，点击Compile CSS to SWF即可完成编译CSS的任务。
　　在程序中可以用StyleManager.loadStyleDeclarations()来读出已编译好的CSS文件中的内容。
　　具体操作如下:
　　// 读取Style
　　private function loadStyle():void
　　{
　　var eventDispatcher:IEventDispatcher = StyleManager.loadStyleDeclarations(“xxx.swf”);
　　eventDispatcher.addEventListener(StyleEvent.COMPLETE, completeHandler);
　　}
　　然后，
　　// 读取完毕的处理
　　private function completeHandler(event:StyleEvent):void
　　{
　　// 具体的处理内容
　　………………
　　super.initialized = true;
　　}
　　做好了这两个函数后，在要调用的页面编辑它的preinitialize属性，指向loadStyle()，如：
　　
　　2) 编译locale文件
　　为了国际化的需要，我们需要使用locale文件或国际化相关技术。
　　最简单的方法是本地化编译，即编译不同的语言版本，然后使用Application Server来判定客户使用的是哪种语言，并自动指向对应的swf文件。
　　具体做法如下：
　　在项目上点击右键，选择Properties。
　　然后选择Flex Compiler，在Additional Compiler arguments下面已经配置好语言包了，默认为-locale en_US。
　　这时我们可以用一个locale目录来简单定制我们额外设置（当然不包括Flex内部控件的语言）的语言设置。
　　比如改为：-locale=en_US -source-path+=g:\flexproj\locale\{locale}。这样在g盘的flexproj目录下建立一个locale目录。
　　然后目录下放置包含我们要扩展的语言文件的文件夹就可以了。比如：g:\flexproj\locale\en_US。
　　注意：locale下面的目录名应该和-locale=设置的名称一致。
　　那么这样，我们就可以使用额外的语言设置了。
　　例：
　　Additional Compiler arguments配置为
　　-locale+=en_US -source-path+=g:\flexproj\testgoufang\locale\{locale}
　　然后在对应的locale目录下添加国际化资源文件，如图：
　　这一部分跟struts相似。
　　里面的内容为键=值的形式，如：
　　Title=测试项目
　　User=用户名
　　Password=密码
　　…………
　　…………
　　使用的时候可以通过[ResourceBundle]元数据标签来绑定locale文件，如：
　　
　　[ResourceBundle("strings")]
　　
　　即绑定上文提到的strings.properties文件，然后我们可以通过ResoueceManager来读出其中的内容，比如：
　　var Title : String = resourceManager.getString(“strings”, ‘Title’);
　　或者绑定到控件：
　　[Bindable]
　　private var Title:String;
　　…………
　　Title = resourceManager.getString(“strings”, ‘Title’);
　　…………
　　
　　上面对针对国际化而使用locale文件的方式做了一个简单的介绍，不过问题还是很多，比如Flex控件的国际化，动态国际化用上面的方法都无法做到。也就是说如果我使用Flex的控件，就必须在程序中指定，或者额外挂在国际化的xxx. Properties文件来进行国际化，并且，只能静态编译多个版本，然后让Application Server根据不同的语言来定位不同版本的SWF文件来进行，这是很不方便的。其实Flex是可以做到的。
　　下面我们来看比较复杂的定制国际化方案：
　　首先，了解一些背景，Flex内部的国际化文件/库只支持两个版本，一个是en_US，另一个是ja_JP。也就是说，开发者在编译Flex项目的时候在Additional Compiler arguments下配置locale=zh_CN是一定会报错的。
　　原因是因为zh_CN库，Flex是没有提供的。
　　那么应该怎么办呢，答案是：自己来构建一个。
　　事实上，在Flex的sdk中已经提供了所有国际化文本的源码，我们可以通过这些源码来进行核心的国际化功能。
　　我们可以在sdk的目录下找到对应的源码文件夹，如：
　　D:\Program Files\Adobe\Flex Builder 3\sdks\moxie\frameworks\projects\framework\bundles\en_US
　　这样我们可以根据这个原型的复制品来制作其他语言包。
　　比如，我们来制作一个中文语言包：
　　首先，先在bundles下创建en_US的副本，然后将副本更名为zh_CN，然后把zh_CN下面的具体内容翻译成中文。
　　在sdk下输入
　　bin\compc -locale=zh_CN -source-path=frameworks/projects/framework/bundles/zh_CN/src -include-resource-bundles=collections,containers,controls,core,effects,formatters,logging,SharedResources,skins,states,styles,validators
　　-output=frameworks/locale/zh_CN/framework_rb.swc
　　则会将Flex的collections,containers,controls,core,effects,formatters,logging,SharedResources,skins,states,styles,validators模块的语言源文件编译成frameworks/locale/zh_CN/framework_rb.swc的语言库文件，这样，在Additional Compiler arguments下配置locale=zh_CN就不会报错了。
　　此外，语言文件也可以像CSS文件一样编译成SWF文件：
　　mxmlc -locale= zh_CN
　　-source-path=locale/{locale} -allow-source-path-overlap=true -include-resource-bundles=collections,containers,controls,core,effects,myResources,skins,styles -output=Resources_ zh_CN.swf
　　编译后的文件更小，效率会更高。
　　在Flex中动态使用国际化：
　　之前我们所讲都是通过Application Server跟据不同的语言来定位不用的SWF文件来实现国际化的。现在，我们来讲一下，如何在Flex中，动态指定国际化语言。
　　首先，我们应通过Additional Compiler arguments的locale选项来指定多个语言：
　　-locale=zh_CN,en_US，我们也可以这样-locale+=zh_CN，因为en_US为默认语言。
　　然后，我们可以在程序中指定语言顺序链
　　resourceManager.localeChain = [ "zh_CN", "en_US" ];
　　这样我们通过resourceManager.localeChain = [0];就可以选择zh_CN了。
　　在外部，我们可以通过html-template目录下对index.template.html进行修改，来达到动态更换语言的目的，当然，这也需要Application Server的支持，不过，不再是定位到不同的SWF文件了，比如下面的JS脚本：
　　AC_FL_RunContent(
　　“src”, “${swf}”,
　　“FlashVars”, “localeChain=zh_CN”,
　　“width”, “${width}”,
　　“height”, “${height}”,
　　“align”, “middle”,
　　“id”, “${application}”,
　　“quality”, “high”,
　　“bgcolor”, “${bgcolor}”,
　　“name”, “${application}”,
　　“allowscrīptAccess”,”sameDomain”,
　　“type”, “application/x-shockwave-flash”,
　　“pluginspage”, “http://www.adobe.com/go/getflashplayer”
　　);
　　我们可以利用JSP或者ASP.NET动态替换红色的部分，来动态的更换语言
　　当然，我们也可以引用编译的文件，只需要把红色的部分改为：
　　“FlashVars”, “resourceModuleURLs=Resources_zh_CN.swf&localeChain= zh_CN “,
　　这样就可以了。
　　---------------------------------------------------------------------------------------------------------------------------------------------------------
　　Flex国际化后，利用JSP向Flex传递语言信息，当切换语言时，菜单时儿有，时儿没有，究其原因是在切换时，如果菜单是在MXML的createComplete方法中初始化的，切换语言不会重新执行该初始化，导致菜单项不能获得Capital导致菜单不能显示，此时重新刷新页面可以解决该问题。
　　最好的解决方法是，在切换语言时，重新执行初始化菜单。
　　---------------------------------------------------------------------------------------------------------------------------------------------------------
　　Flash flex3国际化详解准备：flex3只支持两种语言，en_US,ja_JP,而flex4中则支持多国语言，所以可以将flex4中的FLEX_HOME\frameworks\locale\zh_CN拷贝至flex3中。
　　项目中增加国际化一.配置目录结构:
　　flex_src
　　--locale
　　--zh_CN
　　message.properties
　　--en_US
　　message.properties
　　
　　message.properties内容使用UTF-8编码.
　　开发环境配置:
　　在Eclipse开发环境中的Flex Compiler/Additional compiler arguments选项
　　增加如下参数
　　-locale zh_CN -locale en_US -source-path=locale/{locale}
　　二.使用国际化
　　Flex中提供了两种方法使用本地化文件:
　　1.使用@Resource
　　
　　其中 key 表示的是要取资源的 key ， bundle 表示的是本地化文件，去掉 .properties 之后的名称
　　2.使用 ResourceManager
　　
　　注意：如果容器中没有resourceManager这个变量，可以使用ResourceManager.getInstance()代替resourceManager,因为ResourceManager是单态的。
　　编译检查:
　　使用[ResourceBundle('message')]可以为编译器提供编译检查，实际不需要指定这个也是可以的。
　　
　　[ResourceBundle('message')]
　　
　　三.动态修改当前语言
　　ResourceManager.getInstance().localeChain = ['zh_CN']; 
　　四.减少编译大小由于flex是使用编译器将国际化信息编译进swf中，所以如果将所有的语言全部编译进swf,会导致swf文件过于庞大。而正如国内的环境，如果你的用户大部分都是中文用户，实在没有必要为了少量英文用户而增加swf文件的大小。所以最好的效果是 *独立编译*。即编译出:
　　main_zh_CN.swf 
　　main_en_US.swf 
　　参考: http://www.nbilyk.com/flex-localization-example
　　当然这样处理会麻烦一点，请具体参考你编译出来的swf大小，相差不大的请也可以忽略此项。
　　五. ant编译   
　　
　　
　　
　　
　　
　　
　　
　　flex/${flex.application.name}.swf"
　　actionscript-file-encoding="UTF-8"
　　keep-generated-actionscript="false"
　　incremental="true"
　　compiler.show-actionscript-warnings="true"
　　compiler.show-binding-warnings="true"
　　compiler.show-unused-type-selector-warnings="true"
　　compiler.strict="true">
　　
　　
　　
　　
　　
　　zh_CN
　　en_US
　　
　　
　　true
　　
　　
　　
　　
　　
　　
　　
　　
　　
　　false
　　
　　
[/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b]