Files

edwinQQQ 8b09653c4c feat: 更新动态功能，新增我的动态视图及相关状态管理

- 在HomeFeature中添加MeDynamicFeature以管理用户动态状态。
- 在MainFeature中集成MeDynamicFeature，支持动态内容的加载与展示。
- 新增MeDynamicView以展示用户的动态列表，支持下拉刷新和上拉加载更多功能。
- 更新MeView以集成用户动态视图，提升用户体验。
- 在APIEndpoints中新增getMyDynamic端点以支持获取用户动态信息。
- 更新DynamicsModels以适应新的动态数据结构，确保数据解析的准确性。
- 在OptimizedDynamicCardView中优化图片处理逻辑，提升动态展示效果。
- 更新相关视图组件以支持动态内容的展示与交互，增强用户体验。

2025-07-23 19:17:49 +08:00

6.2 KiB

Raw Permalink Blame History

Yana 项目问题排查与解决流程文档

问题概述

初始错误

错误信息: "Could not compute dependency graph: unable to load transferred PIF: The workspace contains multiple references with the same GUID"

问题表现:

项目无法启动
Xcode 无法计算依赖图
出现 GUID 冲突错误

根本原因分析

混合包管理系统: 项目同时使用了 Swift Package Manager (SPM) 和 CocoaPods
缓存冲突: Xcode DerivedData 与 SPM 状态不同步
TCA 结构问题: 代码中 HomeFeature 缺少必要的状态和 Action 定义

解决流程

第一阶段：GUID 冲突解决

步骤 1: 清理缓存

# 清理 Xcode DerivedData
rm -rf ~/Library/Developer/Xcode/DerivedData/*

# 重置 Swift Package Manager
swift package reset
swift package resolve

步骤 2: 重新安装 CocoaPods

pod install --clean-install

步骤 3: 验证项目解析

xcodebuild -workspace yana.xcworkspace -list

第二阶段：TCA 结构修复

问题识别

HomeFeature.State 缺少 isSettingPresented 和 settingState 属性
HomeFeature.Action 缺少 settingDismissed 和 setting actions
HomeView.swift 中的 store.scope() 调用语法错误

修复步骤

1. 修复 HomeFeature.swift

@ObservableState
struct State: Equatable {
    var isInitialized = false
    var userInfo: UserInfo?
    var accountModel: AccountModel?
    var error: String?
    
    // 添加设置页面相关状态
    var isSettingPresented = false
    var settingState = SettingFeature.State()
}

enum Action: Equatable {
    case onAppear
    case loadUserInfo
    case userInfoLoaded(UserInfo?)
    case loadAccountModel
    case accountModelLoaded(AccountModel?)
    case logoutTapped
    case logout
    
    // 添加设置页面相关actions
    case settingDismissed
    case setting(SettingFeature.Action)
}

2. 添加子 Reducer

var body: some ReducerOf<Self> {
    Scope(state: \.settingState, action: \.setting) {
        SettingFeature()
    }
    
    Reduce { state, action in
        // ... existing cases ...
        
        case .settingDismissed:
            state.isSettingPresented = false
            return .none
            
        case .setting:
            // 由子reducer处理
            return .none
    }
}

3. 修复 HomeView.swift

.sheet(isPresented: Binding(
    get: { store.isSettingPresented },
    set: { _ in store.send(.settingDismissed) }
)) {
    SettingView(store: store.scope(state: \.settingState, action: \.setting))
}

技术细节

依赖管理配置

Swift Package Manager (Package.swift):

ComposableArchitecture: 1.20.2+
其他依赖根据需要添加

CocoaPods (Podfile):

Alamofire (网络请求)
SDWebImage (图像加载)
CocoaLumberjack (日志)
其他 UI 相关库

TCA 架构模式

Feature
├── State (数据状态)
├── Action (用户操作)
├── Reducer (状态转换逻辑)
└── Dependencies (外部依赖)

文件结构

yana/
├── Features/           # TCA Feature 定义
├── Views/             # SwiftUI 视图
├── APIs/              # 网络 API 层
├── Utils/             # 工具类
└── Managers/          # 管理器类

最终解决方案

命令执行顺序

# 1. 清理环境
rm -rf ~/Library/Developer/Xcode/DerivedData/*
swift package reset

# 2. 重新解析依赖
swift package resolve
pod install --clean-install

# 3. 验证项目
xcodebuild -workspace yana.xcworkspace -scheme yana -configuration Debug build

关键代码修改

HomeFeature.swift: 添加设置相关状态管理
HomeView.swift: 修复 TCA store 绑定语法
SettingFeature.swift: 确保 Action 完整性

构建结果

✅ 编译成功: Exit code 0
⚠️ 警告信息: 仅 Swift 6 兼容性警告，不影响运行

预防措施

开发规范

统一包管理: 优先使用一种包管理工具
定期清理: 定期清理 DerivedData 避免缓存问题
代码审查: 确保 TCA Feature 结构完整
版本控制: 及时提交关键配置文件

监控指标

项目编译时间 < 30s
无编译错误
依赖解析正常
TCA 结构完整

工具使用

# 项目健康检查脚本
check_project() {
    echo "🔍 检查项目状态..."
    xcodebuild -workspace yana.xcworkspace -list > /dev/null 2>&1
    if [ $? -eq 0 ]; then
        echo "✅ 项目解析正常"
    else
        echo "❌ 项目解析失败，需要执行清理流程"
        return 1
    fi
}

常见问题FAQ

Q1: 再次出现 GUID 冲突怎么办？

A: 执行完整清理流程：

rm -rf ~/Library/Developer/Xcode/DerivedData/*
swift package reset && swift package resolve
pod install --clean-install

Q2: TCA Reducer 编译错误如何处理？

A: 检查以下项目：

State 属性完整性
Action 枚举完整性
Reducer body 中的 case 处理
子 Reducer 的 Scope 配置

Q3: 如何避免混合包管理器问题？

尽量使用单一包管理工具
如需混合使用，确保依赖版本兼容
定期更新依赖并测试

Q4: Swift 6 兼容性警告如何处理？

短期：可以忽略，不影响功能
长期：逐步迁移到 Swift 6 Sendable 模式

Q5: 项目构建缓慢怎么办？

使用 xcodebuild -quiet 减少输出
开启 Xcode Build System 并行构建
定期清理 DerivedData

总结

本次问题解决涉及以下关键技术点：

Xcode 项目配置管理
Swift Package Manager 与 CocoaPods 共存
TCA (The Composable Architecture) 最佳实践
iOS 开发环境故障排除

通过系统性的排查和修复，项目现已恢复正常运行状态。建议团队建立定期维护机制，避免类似问题再次发生。

文档更新时间: 2025-07-10
适用版本: iOS 16+, Swift 6, TCA 1.20.2+
维护者: AI Assistant & 开发团队

6.2 KiB Raw Permalink Blame History Unescape Escape