版本更新

升级方式

下载最新版 loxilyLocalizeSDK-X.Y.Z.zip 解压后，把新的 loxilyLocalizeSDK.xcframework 替换到你的 Xcode 项目中即可：

1. 移除旧的 loxilyLocalizeSDK.xcframework；
2. 将新版本拖入项目，保持 Do Not Embed（静态库）；
3. Clean Build Folder（Cmd + Shift + K）后重新编译。

最新版本下载

📦 下载 iOS SDK XCFramework 1.2.3

版本历史

版本	更新内容
1.2.3	无 API 变更，二进制兼容 1.2.2。配合服务端上线的「截图显示（爆框）分析」能力发布：SDK 端无需任何改造，截图按现有逻辑采样上传后即自动参与 AI 显示检测（截断 / 溢出 / 遮挡 / 换行等），分析结果在平台 CAT Panel 中以「显示异常」标记呈现，点击截图可查看异常类型与原因。本版二进制构建指向生产环境。
1.2.2	稳定性补丁，无 API 变更，二进制兼容 1.2.1。针对线上 Crashlytics issue be8648ac（后台 + 系统断网叠加场景下 CFWriteStreamWrite EXC_BREAKPOINT）追加三层加固： 1）GGChatPresenter 监听 UIApplicationDidEnterBackgroundNotification 时由 cancel 升级为 shutdown，主线程同步 invalidateAndCancel 彻底回收 SSE 长连接的 NSURLSession，避免 urlSession 仍 alive 时被系统断网路径触碰已不可写的 CFStream； 2）GGChatPresenter 新增 nw_path_monitor 网络可达性监听，nw_path_status_unsatisfied 时主动 shutdown，覆盖进后台通知与系统断网之间的时间窗口； 3）GGReviewChatVC.fetchStringIdsContextAndSend: 的 [NSURLSession sharedSession] completionHandler 由"在 NSURLSession 内部队列上 strong 化 self"改为顶部直接 dispatch_async(dispatch_get_main_queue(), ^{ … })，杜绝 VC 在非主线程释放最后一个强引用
1.2.1	修复轮，无 API 变更，二进制兼容 1.2.0。 修复 submitTranslationSuggestion(s):imageData:callback: 提交后按钮卡在「提交中...」的问题：GGCommunitySuggestPresenter 在 GGReviewChatVC 内以 alloc-init 局部变量持有，原 __weak self/strongSelf 模式让 presenter 在 NSURLSession 回调前就被 ARC 释放，回调因此早退、用户传入的 callback 永不触发。改为 block 直接 strong-capture self（无循环引用）。 修复 5 星卡片首星被选中后整行错位的问题：UIStackView 默认 distribution=.fill 会把多余空间拉伸到第一个 arrangedSubview 上，给每颗星固定 contentHuggingPriority=Required + 末尾加 trailing spacer 吸收剩余空间。 修复 LoxiBot 思考块折叠后留下整块空白：thinkingContainer 改为 UIStackView，thinkingBorderRow 套 wrapper 后 isHidden 时自动回收高度。 文档：README 和 docs 首页的初始化示例代码切换到 setTranslationPreparedBlock:（block 形态，带 errorMsg），旧的 setTranslationPreparedCallback: 例子已标注为已废弃
1.2.0	共创翻译新增无 UI 提交方法 + submitTranslationSuggestions:imageData:callback:（多条）和 + submitTranslationSuggestion:imageData:callback:（单条便捷重载）：集成方可以用自己的 UI 收集玩家评分/翻译建议，再通过该方法提交，SDK 不弹任何页面。SDK 内部按 stringId 自动回填 currentTranslation，与 Android 1.6.0 行为对齐。 截图审查新增 + reviewCurrentScreenWithViewController:stringIds: 与 + reviewCurrentScreenWithViewController:stringIds:imageData: 两个重载：前者将指定 string_id 对应的当前译文拼到 AI 提示词作为精确匹配上下文（对齐 Android 1.3.2）；后者支持外部传入截图字节（PNG/JPEG），适用于 Unity / Cocos 自取 RenderTexture（对齐 Android 1.3.3）。 共创翻译内置 UI 升级为文本质量反馈：每张卡片直接展示 1-5 星评分 + 翻译建议输入框（默认可见），点击同一星可取消评分；底部单按钮（单条「Submit」/ 多条「Submit All」）批量调用上述 headless 接口提交，提交成功后 0.8s 自动关闭面板（对齐 Android 1.5.0）。 初始化回调新增 block 形态 + setTranslationPreparedBlock: 携带 errorMsg 失败原因（对齐 Android OnTranslationPreparedListener.onDataRetrieved(boolean, String)），原 C 函数指针 setTranslationPreparedCallback: 标 __deprecated_msg。 新增 + setScreenshotPageId: 公开 API + + getStringWithCode:pageId:[defaultString:] 重载，允许集成方在不同业务场景标注页面归属。 废弃 API 收口：evaluateStringWithCode:stringContent: 内部转发到 suggestTranslationWithViewController:stringIds:，evaluateAllStrings 与 enableEvaluateFunction: 改为 no-op + 警告日志，三者均标 __deprecated_msg。 LoxiBot 对话头部新增 "Powered by Loxily" 品牌标识（对齐 Android 1.3.4）。 新增内部 GGCrashReporter：通过 NSSetUncaughtExceptionHandler 捕获 SDK 二进制帧（iLocalizeSDK）涉及的未处理 NSException，缓存到 Library/Caches/loxily_crashes/，最多保留 10 份，下次启动异步上报至 /api/sdk/crash-report；与集成方已注册的 handler 链式兼容（对齐 Android 1.x CrashReporter）。 修复：思考块折叠后留下整块空白的布局问题（thinkingContainer 改为 UIStackView + wrapper hidden 自动回收高度）
1.1.0	新增 LoxiBot AI Agent 功能（reviewCurrentScreenWithUI: / suggestTranslationWithUI:）：玩家可对应用截图发起 AI 对话式审查、提交翻译建议。修复非主线程 dealloc 路径下，外部 GCD source 强持有 GGReviewChatVC 时可能触发的 CFWriteStreamWrite EXC_BREAKPOINT 崩溃：NSTimer 改为线程安全的 dispatch_source、NSURLSession.invalidateAndCancel 统一调度到主线程异步执行、VC 与 Presenter 均监听 UIApplicationDidEnterBackgroundNotification 主动收口
1.0.0	首个正式版本：词条获取、语言切换、日志控制、术语补丁、截图审查接口