iOS 自定义能力
一、自定义 UI
本文主要介绍如何使用自定义 UI 和自定义识别页面。
构建步骤
1. SDK 压缩包解压后，进入 demo 目录，打开 HuiYanODemo 项目。
2. 切换构建 secheme 到 UserUIBundle ，command+B 可以构建出产物。
3. 构建出 bundle 后右键查看包内容，打开 info.plist ，删掉 “Executable file” 字段，否则会影响 AppStore 上架，导致上传 IPA 报错。也可以将 info.plist 文件删掉。
4. 将构建产物直接替换掉根目录 SDK 目录下的 UserUIBundle.bundle ，将该目录下所有 lib 和 bundle 添加到自己的项目中（注：若没有修改 bundle 内容，可不进行替换，直接使用该目录下的 bundle 即可）。
自定义内容
自定义配置
支持修改页面字体和颜色。您可以通过 “ HuiYanOsConfig ” 中的字段进行设置。
HuiYanOsConfig*config=[[HuiYanOsConfig alloc]init]；//设置出现操作错误时提示文本的颜色config.feedBackErrorColor=0xFF584C；//设置操作正确时提示文本的颜色config.feedBackTxtColor=0xFF0000；//设置出现操作错误时圆形框的颜色config.authCircleErrorColor=0xFF584C；//当动作正确时设置圆形框的颜色config.authCircleCorrectColor=0x29CC85；//设置识别页面背景颜色config.authLayoutBgColor=0xFFFFFFF；//设置提示文本字体和大小config.feedBackTxtFont=[UIFont systemFontOfSize:18]；//设置其他提示文本大小config.feedbackExtraTxtFont=[UIFont systemFontOfSize:18]；//设置是否显示内部对话框，默认为YESconfig.isShowDialog=YES；//设置隐藏核心头像框，默认为NOconfig.isHideAvatarGuideFrame=NO；
自定义布局
xib 内布局调整。如 TXYOsAuthingViewController 识别页面，则可以执行以下操作：
1. 可以修改 xib 内组件的布局；
2. 可以在 xib 中添加新组件并设置布局；
3. 为新添加的组件设置 “ Tag ” 字段，通过 “onMainViewCreate:authView” 回调检索 “authView” ，并在 “ authView “ 中找到通过 “ Tag ” 添加的目标组件。
通过设置 userUIBundleName 字段设置到 SDK 中：
HuiYanOsConfig *config = [[HuiYanOsConfig alloc]init];config.huiyanSdkUIBundlePath = [[NSBundle mainBundle] pathForResource:@"UserUIBundle" ofType:@"bundle"];
二、自定义多语言
添加自定义语言
1. demo 中 UserUIBundle 文件夹中包含 Localizable 。下图中右侧可设置支持的语言类型，对应左侧会出现子文件，在子文件中对已有的 key 字符串做多语言映射。
2. 若右侧没有目标语言可先对工程设置里添加对应语言，之后重复步骤 1 即可。
3. 对目标文件进行翻译映射。下图示例为简体中文的映射，若添加其他语言左侧 key 保持不变，右侧为译文即可。
4. 通过设置 languageBundlePath 字段设置到 SDK 中:
HuiYanOsConfig *config = [[HuiYanOsConfig alloc]init];config.languageBundlePath = [[NSBundle mainBundle] pathForResource:@"UserUIBundle" ofType:@"bundle"];// Allow specified language:config.setLanguageFileName = @"en.lproj";
userLanguageFileName 可以查看编译出的 bundle 文件中对应的文件名。
维护方式
1. 将 Demo 工程作为自定义 UI 的工程，通过修改 Demo 工程里的 bundle 源文件，然后构建 bundle 并接入自己项目。缺点是需要自行维护 Demo 工程。
2. 将 Demo 工程中的 OcrSDK 资源 copy ，在自己的项目中新增一个 bundle target 后自行维护，便于跟随项目管理。
文档反馈