💡 开发笔记

问题背景

在 Swift 6 的严格并发检查模式下，Any 类型默认不遵循 Sendable 协议，会导致编译警告或错误：

⚠️ Type 'Any' does not conform to protocol 'Sendable'

解决方案

使用 any Any & Sendable 来明确声明类型既可以是任意类型，又遵循 Sendable 协议：

// ❌ Swift 6 下会报错
var data: Any
func processData(_ input: Any) { }

// ✅ 正确写法
var data: any Any & Sendable
func processData(_ input: any Any & Sendable) { }

使用场景

• 属性声明：var value: any Any & Sendable
• 函数参数：func handle(_ data: any Any & Sendable)
• 闭包捕获：let callback: (any Any & Sendable) -> Void
• 泛型约束：struct Container

class DataManager: @unchecked Sendable {
    // 存储任意 Sendable 类型的数据
    var cache: [String: any Any & Sendable] = [:]
    
    // 接收 Sendable 参数
    func store(_ value: any Any & Sendable, forKey key: String) {
        cache[key] = value
    }
    
    // 返回 Sendable 类型
    func retrieve(forKey key: String) -> (any Any & Sendable)? {
        return cache[key]
    }
}

问题场景

当你开发一个本地 Framework，并且：

• Framework 是 OC/Swift 混编 项目
• Framework 通过 pod 或 podspec 的 dependency 引入一个 OC 第三方库
• 未来这个 Framework 要通过 pod install 接入到主项目

问题描述

pod install 后，在 Framework 工程中找不到 OC 第三方库的头文件，编译报错。

根本原因

CocoaPods 自动生成的 umbrella header（如 FrameworkName-umbrella.h）不会自动添加对 pod 依赖的 OC 库的头文件引用。这意味着：

• Swift 代码无法直接看到 OC 第三方库的类
• 即使你在 Bridging Header 中声明，也找不到 OC 类的定义

解决方案

在 Framework 项目中创建一个专门的聚合头文件，手动引用需要用到的 OC 第三方库头文件：

// FrameworkName.h（文件名任意，建议与 Framework 同名）

#import <Foundation/Foundation.h>

// ⚠️ 关键：手动导入 OC 第三方库的头文件
#import <AFNetworking/AFNetworking.h>
#import <SDWebImage/SDWebImage.h>
// 或其他你依赖的 OC 库

// 如果有需要导出的 OC 类，也在这里导入
#import <FrameworkName/YourOCClass.h>

配置步骤

1. 创建聚合头文件

   在 Framework 项目中创建一个头文件（如 FrameworkName.h），把所有需要用到的 OC 第三方库头文件都 import 一遍。

2. 确保头文件被编译

   将这个头文件添加到 Framework 的 Target 中（默认会自动添加）。

3. 在 Swift 代码中使用

   import FrameworkName
   
   // 现在可以使用 OC 第三方库的类了
   let manager = AFHTTPSessionManager()
   let image = SDImageCache.shared().imageFromDiskCache(forKey: "key")

# podspec 中
spec.public_header_files = "*.h"  # 公开所有头文件（通配符）
# spec.umbrella_header 不需要显式指定，CocoaPods 会自动处理

问题描述

在 SwiftUI 开发中，当图片组件设置为 ScaleToFill 时，图片会根据其原始加载大小来渲染，导致：

• 图片组件自身的宽度不受控制
• 父组件的宽度也会随之失控，破坏整体布局

解决方案

必须给图片组件显式设置一个固定宽度：

Image("yourImage")
    .resizable()
    .scaledToFill()
    .frame(width: 200)  // ⚠️ 必须设置宽度