老司机 iOS 周报 #332 | 2025-04-21

[ChengzhiHuang]

老司机 iOS 周报，只为你呈现有价值的信息。

你也可以为这个项目出一份力，如果发现有价值的信息、文章、工具等可以到 Issues 里提给我们，我们会尽快处理。记得写上推荐的理由哦。有建议和意见也欢迎到 Issues 提出。

文章

🐕 DocC for Multi-Platform Documentation

@Kyle-Ye: 这篇文章介绍了如何手动创建 Swift 包的跨平台文档。虽然 DocC SPM 插件最近添加了对多目标文档生成的支持，但目前仍不支持跨平台包的文档生成。作者分享了一种解决方案，通过直接使用 Xcode 自带的 DocC 工具来实现。

文章详细讲解了三个主要步骤：

1. 为各平台构建项目并生成符号图
2. 将.docc 包转换为 DocC 存档
3. 将存档处理成可托管的 HTML 文件

作者提供了完整的代码示例，包括如何设置 DocC 包结构、创建 Info.plist 文件定义各平台的部署目标，以及编写 shell 脚本来自动化整个构建过程。这种方法可以有效地显示每个 API 在 iOS、watchOS、visionOS、tvOS 和 macOS 上的可用性。

🐕 iOS 静态代码检查方案解读

@含笑饮砒霜：这篇文章对比了 iOS 开发中三大主流静态代码检查工具：SonarQube、Infer 和 Clang Static Analyzer。SonarQube 存在资源消耗大、配置复杂及 Xcode 适配等问题；Infer 存在语言局限和误报、漏报等问题；Xcode 原生集成的 Clang Static Analyzer，相比 SonarQube 和 Infer，Clang 静态分析在底层问题检测、编译阶段的高效性和多语言支持方面具有显著优势。其凭借增量分析、路径敏感检测和零配置优势，通过脚本筛选增量文件并转换分析结果，可以实现高效自动化检查与定制化报告生成，成为平衡开发效率与质量的中大型项目优选方案。

🐕 How to inspect .ipa files and secure your iOS app from common mistakes

@Barney：本文介绍了如何检查 iOS 应用的 .ipa 文件结构，揭示潜在安全隐患。通过 Apple Configurator 等工具获取 .ipa 文件后，可解压分析 Info.plist（含明文密钥 /URL scheme）、Frameworks（第三方 SDK）和 Resources（测试账户 / 配置文件）。并提出三准则：勿在 Info.plist 存敏感数据，移除开发测试资料，避免明文存储密钥。强调攻击者常用逆向工具（如 Hopper）解析未加密信息，开发者应定期自查 .ipa 文件，强化安全防护。

🐎 你为什么需要了解 Dart AST？一个简单的 bug 带你快速认识下 Dart Kernel AST

@david-clang：作者在调用 extension 拓展 BuildContext 的 context.l10n 时报运行时错误 NoSuchMethodError，最终通过 ast_to_text.dart 相关工具将 IR 层的 dill 文件转成可读文本，定位到问题根本原因是未显式声明函数参数是 BuildContext 类型，导致编译时 context 被推断为 dynamic 类型，最终导致运行时 NoSuchMethodError 错误。文章里通过分析 Dart AST 来找到代码根本问题的思路值得我们学习。

🐎 SwiftUI Keyboard Shortcut Scope

@Smallfly：本文聚焦 SwiftUI 键盘快捷键的「跨视图生效」问题，当控件通过导航跳转离开屏幕时，其关联的快捷键仍被系统识别并响应，导致操作冲突。核心原因是系统按视图层级解析快捷键，而非视图可见性。解决方案是利用状态变量动态禁用父视图控件，间接关闭其快捷键响应。若你在 SwiftUI 开发中需精准管理多层级导航的快捷键作用域，本文可帮助你快速定位逻辑隐患。

代码

🐎 Supercharging SwiftUI Text with Dynamic Content Styling

@阿权：文章提供了一种扩展 SwiftUI Text 视图的思路，通过自定义文本替换规则，允许对文本中的特定字符串（如单词或段落）应用自定义样式。核心实现包括：

1. TextReplacementView：提供单个或多个替换规则的初始化接口。
2. processReplacements：查找文本中的匹配范围，按顺序处理非重叠替换，拼接生成带有不同样式的 Text 视图。

文章最后展示了简单和复杂场景下的用法，支持灵活的视图修饰符（如字体、颜色、斜体等）。其优势在于简化了原有通过组合多个 Text 视图实现样式定制的繁琐流程，提供了更统一的解决方案。

更详细的实现和用法可前往开源库 TextReplacements。

内推

重新开始更新「iOS 靠谱内推专题」，整理了最近明确在招人的岗位，供大家参考

具体信息请移步：https://www.yuque.com/iosalliance/article/bhutav 进行查看（如有招聘需求请联系 iTDriverr）

关注我们

我们是「老司机技术周报」，一个持续追求精品 iOS 内容的技术公众号，欢迎关注。

关注有礼，关注【老司机技术周报】，回复「2024」，领取 2024 及往年内参

同时也支持了 RSS 订阅：https://github.com/SwiftOldDriver/iOS-Weekly/releases.atom 。

说明

🚧 表示需某工具，🌟 表示编辑推荐

预计阅读时间：🐎 很快就能读完（1 - 10 mins）；🐕 中等 （10 - 20 mins）；🐢 慢（20+ mins）

---

This discussion was created from the release 老司机 iOS 周报 #332 | 2025-04-21.