iOS文本的多语言适配以及实践指南

目录

• 背景
• 字体包的多语言适配和实践
  • 需求分析
  • 技术设计
• 文本信息的多语言适配和实践
  • 需求分析
  • 技术设计
  • 技术开发
  • 拓展
• 总结

//壳工程中的配置文件，反序列化传回FontPackage层
//appfont.json
{
    "list": [{
        "env" : "vi",
        "note" : "越南语，按照国际编码：vi、vi-VN。FontPackageManager 判断国际编码来对应",
        "data" : [{
                "font" : 0,
                "name" : "genjyuu_light（越南细）"
            },{
                "font" : 1,
                "name" : "genjyuu_medium（越南中）"
            },{
                "font" : 2,
                "name" : "genjyuu_bold（越南粗）"
            }
        ]
    }, {
        "env" : "default",
        "note" : "其他语种默认使用字体，但优先判断设备的国际编码来匹配字体包",
        "data" : [{
                "font" : 0,
                "name" : "GothamRndSSm-Light"
            },{
                "font" : 1,
                "name" : "GothamRndSSm-Medium"
            },{
                "font" : 2,
                "name" : "GothamRndSSm-Bold"
            }
        ]
    }
]}

//已处理
+ (UIFont *)systemFontOfSize:(CGFloat)fontSize;
+ (UIFont *)systemFontOfSize:(CGFloat)fontSize weight:(UIFontWeight)weight;
+ (UIFont *)boldSystemFontOfSize:(CGFloat)fontSize;
+ (UIFont *)italicSystemFontOfSize:(CGFloat)fontSize;
+ (UIFont *)fontWithName:(NSString *)fontName size:(CGFloat)fontSize;

//FontPackageExtension.m 
//UIFont+FontPackage.m



+ (UIFont *)xxxFontPackage_systemFontOfSize:(CGFloat)fontSize weight:(UIFontWeight)weight {
    NSString *fontName = @"";
    if (weight == UIFontWeightMedium) {
        fontName = @"medium";
    } else if (weight > UIFontWeightMedium) {
        fontName = @"bold";
    }
    return [self fontWithName:fontName size:fontSize];
}

+ (UIFont *)xxxFontPackage_italicSystemFontOfSize:(CGFloat)fontSize {
    //斜体默认是medium
    return [self fontWithName:@"medium" size:fontSize];
}

+ (UIFont *)xxxFontPackage_boldSystemFontOfSize:(CGFloat)fontSize {
    return [self fontWithName:@"bold" size:fontSize];
}

+ (UIFont *)xxxFontPackage_systemFontOfSize:(CGFloat)fontSize {
    return [self fontWithName:@"" size:fontSize];
}

+ (UIFont *)xxxFontPackage_fontWithName:(NSString *)fontName size:(CGFloat)fontSize {
    fontName = [self fontpackage_name:fontName];
    return [self xxxFontPackage_fontWithName:fontName size:fontSize];
}



+ (NSString *)fontpackage_name:(NSString *)fontName {
    fontName = [fontName lowercaseString];
    FontPackageFont replaceFont = FontPackageFontLight; //默认light
    if ([fontName containsString:@"medium"]) {
        replaceFont = FontPackageFontMedium;
    } else if ([fontName containsString:@"bold"]) {
        replaceFont = FontPackageFontBold;
    }
    //匹配替换的字体
    NSString *replaceFontName = [[FontPackageManager shareInstance].fontPackageInfo.dataMap objectForKey:@(replaceFont)];
    return replaceFontName;
}

@interface UILabel (Localized)
@property (nonatomic, assign) BOOL isAutoLocalized; ///< 设置的文字是否要自动转换成本地化的语言，默认YES
@end

@interface NSString (Localized)
@property (nonatomic, copy) NSString *oriStr; ///< 上次本地化的字符串原始值
@property (nonatomic, copy) NSString *localizedStr; ///< oriStr 本地化后的字符串
@end

/**
 @brief 直接返回指定 key 对应的 本地化文字
 @param key 转译文件表中的key
 */
+ (NSString *)forKey:(NSString *)key;

 /**
 @brief 根据指定的 language code，返回key 对应的 本地化文字
 @param key 转译文件表中的key
 @param langCode语言编码
 */
+ (NSString *)forKey:(NSString *)key langCode:(NSString *)langCode;

/**
 @brief 设置当前默认的语言编码
 @param langCode语言编码
 */
+ (void)setCurrentLangCode:(NSString *)langCode;