iOS本地化国际化（续）：不更随系统，手动选择APP语言 本地化和国际化的实现

最新推荐文章于 2023-01-19 14:25:37 发布
最新推荐文章于 2023-01-19 14:25:37 发布
阅读量2.6k 收藏
点赞数
分类专栏： iOS 文章标签： 手动选择国际化语言 本地化 国际化


  1. 环境
  2. iOS国际化原理分析
  3. 开始国际化
  4. 文本的国际化
  5. 图片的国际化
    1. 方案二原生支持
  6. StoryboardXIB的国际化
    1. 应用内切换语言
  7. 其他


在真正将国际化实践前，只知道通过NSLocalizedString方法将相应语言的字符串加载进来即可。但最近公司项目的新需求增加英文版本，并支持应用内无死角切换~，这才跳过各种坑实现了应用内切换语言，并记录至此。

more

环境

系统环境: iOS7 - iOS9

开发环境: Swift2 & Xcode7

DEMO: LocalDemo

locale_0.gif

这个Demo的功能主要是切换语言后相应的界面文字&图片以及搜索引擎都会随语言变化。我们会围绕这个DEMO进行讲解，读者可以先下载这个Demo运行看下效果再往下


iOS国际化原理分析

国际化其实都大同小异，其核心思想就是为每种语言单独定义一份资源。

iOS就是通过xxx.lproj目录来定义每个语言的资源，这里的资源可以是图片，文本，Storyboard，Xib等。我们可以看看LocalDemo源代码的物理目录结构

Base，暂时无需理会

locale_1.png

English

locale_1_1.png

中文

locale_1_2.png

每种语言都有自己的 语言代码.lproj文件夹，加载资源时只需要加载相应语言文件夹下的资源就OK，这步可以系统为我们完成，也可以手动去做。

项目源代码中如果有多个不同目录的国际化资源，则会有产生多个xxx.lproj，但在编译打包后，会集中放在app的根目录中的xxx.lproj中，不信你看~

 

locale_1_3.png

开始国际化

首先点击项目->PROJECT->Info->Localizations中添加要支持的语言

locale_2.png

此处Use Base Internationalization开启状态下，每个国际化资源文件会有个Base选项，主要针对String，Storyboard，Xib作为一个基础的模板，像后述storyboard国际化中方案二就是基于Base StoryBoard进行改动。

在点击+ 添加相应语言时会弹出以下对话框，意思是为现有的资源添加语言文件，我们点击Finish就行了

locale_2_1.png


文本的国际化

主要针对代码中的字符串进行国际化，比如说一些消息，UI标题等。

我们通过一个Localizable.strings文件来存储每个语言的文本，它是iOS默认加载的文件，如果想用自定义名称命名，在使用NSLocalizedString方法时指定tableName为自定义名称就好了，但你的应用规模不是很大就不要分模块搞特殊了。

每个资源文件如果想为一种语言添加支持，通过其属性面板中的Localization添加相应语言就行了，此时Localizable.strings处于可展开状态，子级有着相应语言的副本。我们把相应语言的文本放在副本里面就行了

locale_3.png

此处Base与前面提过到的开启Use Base Internationalization是有关联的，只有开启了全局Use Base Internationalization此处才会显示。那为什么这里没有勾选Base？Base做为一个基础模板，作用于Strings文件是没有太大意义的，另外去掉Base意义着在Base.lproj中少了一个strings文件，APP大小也所有下降，这点对于图片的Base更是如此

在上图可以看到其实就是为每一套语言新建一份strings，其内容采用"key" = "value";的格式，注意有;号

我们在代码中这样写就行了

<span style="font-size:14px;">NSLocalizedString("首页",comment: "")
NSLocalizedString("好友",comment: "")
NSLocalizedString("我",comment: "")</span>

另外中文strings【Localizable.strings(Simplified)】可以不要的(可以理解为中文为APP的默认语言)，因为key就是value，当找不到相应的语言strings或value时会直接返回key。nice！这样一来我们做文本的国际化就只要维护一个英文副本strings就O了


图片的国际化

二种方案，通过原生支持与自定义命名

注意，新版Xcode中Images.xcassets不支持国际化（属性页面中没有Localization），Xcode5以前是支持的

  • 方案一：自定义文本命名
    locale_4.png
    利用文本国际化的方式，在代码中调用
    UIImage(named: NSLocalizedString("search_logo",comment:""))
    • 1

  • 不推荐，一是因为做法太low了，工作量明显加大。二是不能在Storyboard或XIB中使用
  • 方案二：原生支持
    locale_4_1.png
    同上，Base副本去掉。另外需要注意的是，使用这种方式，在XIB或Storyboard中引用图片时如果只使用名称是实时显示不了的，一定要加上后缀名。如avater.png

    使用方式不变，iOS会自动找相应语言(xxx.lproj)下的图片
    UIImage(named: "avater")
    • 1

  • 对于图片的放置，正确姿态应该是需要国际化的图片放在自定义Group里面，不需要国际化的图片放在Images.xcassets


Storyboard&XIB的国际化

前面的两种资源国际化比较简单，但Storyboard国际化就稍微麻烦了点。同样它也有二种方案

  • 方案一：每种语言定制一套Storyboard
    locale_5.png
    在上图我们可以看到，每种语言都可以切换为strings或Storyboard（默认为strings）。如果选用    Interface Builder Storyboard方案，那么每种语言都有一套相应的Storyboard，各个语言Storyboard间的界面改动不关联
  • 方案二：基于基础的Base StoryBoard以及每种语言一套strings
    locale_5_1.png
    基于一个基础的Storyboard，可以看作是一个基础的模板，Storyboard里面所有的文本类资源(如UILabel的text)都会被放在相应语言的strings里面。此时我们为Storyboard里的字符类资源作国际化只需要编辑相应语言的strings就行了

首选方案二。因为采用方案一，意义着你每改动一个界面元素就得去相应语言Storyboard一一改动，那跟为每个语言新起一个项目是一样的道理。但是采用方案二，我们只需改动Base Storyboard就行了

注意，方案二中相应语言的strings一旦生成后，Base Storyboard有任何编辑都不会影响到strings，这就意味着如果我们删除或添加了一个UILabel的text，strings也不能同步改动

还好，Xcode为我们提供了ibtool工具来生成Storyboard的strings文件。

<span style="font-size:14px;">ibtool Main.storyboard --generate-strings-file ./NewTemp.string</span>

    但是ibtool生成的strings文件是BaseStoryboard的strings(默认语言的strings)，且会把我们原来的strings替换掉。所以我们要做的就是把新生成的strings与旧的strings进行冲突处理(新的附加上，删除掉的注释掉)，这一切可以用这个pythoy脚本来实现，见AutoGenStrings.py。然后我们将借助Xcode 中 Run Script来运行这段脚本。这样每次Build时都会保证语言strings与Base Storyboard保持一致

    locale_5_2.png


    应用内切换语言

    应用启动时，首先会读取NSUserDefaults中的key为AppleLanguages的内容，该key返回一个String数组，存储着APP支持的语言列表，数组的第一项为APP当前默认的语言。

    在安装后第一次打开APP时，会自动初始化该key为当前系统的语言编码，如简体中文就是zh-Hans。

    <span style="font-size:14px;">//获取APP当前语言
(NSUserDefaults.standardUserDefaults().valueForKey("AppleLanguages") as! Array<String>)[0]</span>

      那么我们要实现语言切换改变AppleLanguages的值即可，但是这里有一个坑，因为苹果没提供给我们直接修改APP默认语言的API，我们只能通过NSUserDefaults手动去操作，且AppleLanguages的值改变后APP得重新启动后才会生效（才会读取相应语言的lproj中的资源，意义着就算你改了，资源还是加载的APP启动时lproj中的资源），猜测应该是框架层在第一次加载时对AppleLanguages的值进行了内存缓冲

      <span style="font-size:14px;">//设置APP当前语言
var def = NSUserDefaults.standardUserDefaults()
def.setValue([“zh-Hans”], forKey:"AppleLanguages")
def.synchronize()</span>

        那么问题来了，如何做到改变AppleLanguages的值就加载相应语言的lproj资源？

        其实，APP中的Storyboard的加载，图片与字符串的加载都是在NSBundle.mainBundle()上操作的，那么我们只要在语言切换后把NSBundle.mainBundle()替换成当前语言的bundle就行了，这样系统通过NSBundle.mainBundle()去加载资源时实则是加载的当前语言bundle中的资源

        lproj目录可以用一个NSBundle表示

        <span style="font-size:14px;">import Foundation

/**
*  当调用onLanguage后替换掉mainBundle为当前语言的bundle
*/
private  let _bundle:UnsafePointer<Void> =  unsafeBitCast(0,UnsafePointer<Void>.self)
class BundleEx: NSBundle {
    override func localizedStringForKey(key: String, value: String?, table tableName: String?) -> String {
        if let bundle = languageBundle() {
            return bundle.localizedStringForKey(key, value: value, table: tableName)
        }else{
            return super.localizedStringForKey(key, value: value, table: tableName)
        }
    }
}

extension NSBundle{
    private struct Static {
        static var onceToken : dispatch_once_t = 0
    }
    func onLanguage(){
        //替换NSBundle.mainBundle()为自定义的BundleEx
        dispatch_once(&Static.onceToken) {
            object_setClass(NSBundle.mainBundle(), BundleEx.self)
        }
    }

    //当前语言的bundle
    func languageBundle()->NSBundle?{
        return Languager.standardLanguager().currentLanguageBundle
    }
}</span>

        以上Languager是iOS-i18n 开源库的一部分，我把项目中国际化部分封装了下，有兴趣的童鞋可以去看看

        其他

        • 设置运行语言环境
          有时我们第一次安装APP时不想默认跟随系统，那么可以通过Xcode的scheme来指定特定语言
        • Storyboard实时预览
          直接上图~
        • IB中UIImageView国际化无效
          解决办法就是为          UIImageView扩展一个方法，然后通过IB中的User Defined Runtime Attributes把imageName传进去

         
        <span style="font-size:14px;">extension UIImageView{
  var locale:String{
      get{
          return ""
      }
      set(newlocale){
          self.image = localizedImage(newlocale)
      }
  }
}</span>

        locale_6_2.png
        • IB中UITextView国际化无效
          解决办法和UIImageView类似，扩展一个方法，然后把self.text做为key去strings文件中拿相应语言的value
        <span style="font-size:14px;">extension UITextView{
  var locale:Bool{
      get{
          return true
      }
      set(newlocale){
          self.text = localized(self.text)
      }
  }
}</span>

        locale_6_3.png
        • LaunchScreen.xib的国际化
          很遗憾，到目前为止，还不支持LaunchScreen.xib的国际化，我们只能通过自定义一个LaunchViewController来完成此需求，但也有些不足，就是应用启动时会黑屏一段时间，所以建议启动页面不要弄国际化

        参考:

        ==================================================

        原文参考地址

        ==================================================

        http://blog.csdn.net/VictorMoKai/article/details/48894873

        接管系统Bundle方法这样不需要在拷贝storyboardc文件到对应.lproj目录。

        object_setClass(NSBundle.mainBundle(), BundleEx.self) 


        源码下载地址：

        点击打开链接


        水麒麟灬
        关注
        专栏目录
        iOS国际化
        mokai
        10-04 7008
        在真正将国际化实践前，只知道通过NSLocalizedString方法将相应语言的字符串加载进来即可。但最近公司项目的新需求增加英文版本，并支持应用内无死角切换~，这才跳过各种坑实现了应用内切换语言，并记录至此。
        iPhone 的国际化
        热门推荐
        kmyhy的专栏
        03-10 1万+
        在iPhone项目中如何才能国际化？难道同一个项目，非要写一个英文版的源代码，再写一个中文版的源代码？ 其实大可不必。我们可以使用iPhone的多语言支持来实现项目的本地（国际）化。
        IOS国际化
        zzuli_xiaomingke的博客
        02-25 515
        IOS国际化 在IOS开发中，有时候如果产品会有机会走出国门，一般都会在程序中设置国际化的相关内容，下面描述一下IOS国际化的相关内容，理论上国际化主要包含以下几种 应用info.plist内容的国际化 应用内标签的国际化 storyboard，xib的国际化 图文，声音等第三方资源国际化 应用内切换语言 基本的内容就是以上的几种了，如果以后意识到有其他方面的内容，在进行补充，目前就先讨论以上几种情况 要做国际化的话，首先要在设置里面修改某些设置，点击项目–>Project–>info–&gt
        iOS 国际化
        liu_yun_long的博客
        06-20 211
        https://www.cnblogs.com/yanzheng216/p/8674722.html
        3分钟实现iOS语言本地化/国际化(图文教程)
        08-25
        本文主要介绍了iOS语言本地化/国际化的实现方法，通过配置需要国际化的语言、应用名称本地化、代码中字符串本地化、多人开发情况下的字符串本地化、图片本地化、Storyboard/XIB本地化等7个主要章节，详细讲解了如何...
        ios 国际化 本地化
        09-26
        国际化（Internationalization，通常缩写为i18n）和本地化（Localization，简称l10n）是iOS应用开发中的重要环节，旨在使应用程序能够适应不同国家和地区的语言、文化以及用户习惯。这两个概念虽然经常一起提及，但...
        IOS 解决推送本地国际化 loc-key 本地化失败的问题
        09-01
        在iOS应用开发中，国际化（Internationalization）是一个重要的环节，尤其对于那些面向全球用户的App来说。...通过这些步骤，我们可以有效地解决iOS推送通知本地化失败的问题，为用户提供更友好的多语言体验。
        iOS APP 内的国际化切换【案例：中英文切换】
        05-26
        文章：https://kunnan.blog.csdn.net/article/details/103733872 原理： 1、自定义解析本地化字符串的工具类LanguageManager 2、应用内切换语言生效的技术实现:采用销毁根控制器，重新进入一次
        iOS国际化（APP国际化）
        12-07
        iOS国际化 欢迎关注 http://blog.csdn.net/u014220518/article/details/53486699
        ios 国际化（项目名和内容）
        04-16
        NULL 博文链接：https://zhangmingwei.iteye.com/blog/1782613
        iOS的国际化
        Love@YR
        08-12 419
        iOS的国际化
        iOS 应用国际化
        奋斗的菜鸟ing
        09-01 2152
        应用国际化目的：在不改变应用程序的逻辑功能的前提下，程序可以提供自适应、更友好的界面。用户不希望系统语言为中文，但应用却是英文吧。 国际化是指应用程序运行时，可根据系统设置的国家／地区、语言的不同而显示不同的界面。如：手机设置的语言为中文，则应用程序中的各种提示信息都显示中文；而如果手机系统语言为中文，则应用程序中的各种信息都显示英文。 应用国际化思路 iOS应用的国际化思路是将程序中的信息
        iOS 国际化(多语言)
        最新发布
        长沙火山
        01-19 8521
        Xcode使用带有 “.strings” 扩展名的文件来存储和检索 程序中使用的所有字符串，以及支持的每种语言。创建完“InfoPlist.strings”（命名随意~），工程目录结构文件如下，单击“InfoPlist.strings”，查看右边的属性，在Localizable栏添加语言。”，选择“iOS”对应的“Resource”中的“Strings File”）。这个时候就可以在对应语言的“InfoPlist.strings”文件中，添加所支持的字符串了。创建一个 “.strings” 扩展名的文件。
        ios开发国际化
        lifugui001的专栏
        05-10 192
        ios国际化笔记 背景 一开始做app的时候没考虑到国际化，项目快做完了，领导要求做国际化（汗。。。。） 涉及的内容 app名称的国际化 文本的国际化 图片的国际化 启动画面的国际化 添加app支持的语言 如下图所示，添加app支持的语言 app名称的国际化 1、 新建InfoPlist.strings文件，注意名字不能错，右侧图后缀名(.string...
        iOS项目国际化
        公会驻地
        07-18 722
        相关链接 详述iOS国际化 示例demo链接 iOS本地化 NSLocalizedString的使用 基本操作步骤 1. 设置国际化 2. 添加Localizable.strings文件 3. 选择配置Localizable文件 4. 配置Main.storyboard文件 5. 导入能自动跟踪storyboard变动的pyth...
        ios自定义国际化
        huoshes的博客
        01-16 684
        工作闲暇之余，对ios知识进行梳理。废话不多说，直接上图，简单明了。 一、应用中字符串国际化 a、新建一个工程，工程默认是支持英文，这里添加中文。 图1 图2 图3
        iOS开发之国际化
        坤宇的博客
        12-21 558
        前言 语言本地化，又叫做语言国际化。是指根据用户操作系统的语言设置，自动将应用程序的语言设置为和用户操作系统语言一致的语言。往往一些应用程序需要提供给多个国家的人群使用，或者一个国家有多种语言，这就要求应用程序所展示的文字、图片等信息，能够让讲不同语言的用户读懂、看懂。进而提出为同一个应用程序适配多种语言，也即是国际化。语言国际化之所以又叫做语言本地化，这是站在每个用户的角度而言的，是指能够
        评论
        添加红包

        请填写红包祝福语或标题

        个

        红包个数最小为10个

        元

        红包金额最低5元

        当前余额3.43元 前往充值 >
        需支付：10.00元
        成就一亿技术人!
        领取后你会自动成为博主和红包主的粉丝 规则
        hope_wisdom
        发出的红包
        实付元
        使用余额支付
        点击重新获取
        扫码支付
        钱包余额 0

        抵扣说明：

        1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
        2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

        余额充值