> ⚠️ **ARCHIVED** — This repository has been migrated to the mobile-workspace private monorepo (2026-08-07).
# PhotoDIY - 图片编辑应用


## graphify Knowledge Graph

- Interactive graph: https://luowei.github.io/PhotoDIY/
- Report: https://luowei.github.io/PhotoDIY/GRAPH_REPORT.md
- Graph data: https://luowei.github.io/PhotoDIY/graph.json

PhotoDIY 是一款功能强大的 iOS 照片编辑应用，提供滤镜、裁剪、文字叠加、绘图和社交分享等多种图像编辑功能。

## 📚 项目概览

本项目包含 **两个独立实现版本**，采用不同技术栈满足不同的开发需求：

### 🔹 版本对比总览

| 版本 | 技术栈 | 开发状态 | 分支 | 代码规模 |
|------|--------|---------|------|----------|
| **OC 版本** | Objective-C | ✅ 生产环境（App Store） | `master` | ~22,665 行代码，134 个文件 |
| **Swift 版本** | Swift 5.9+ | 🚧 开发中 | `swift` | ~10,000 行代码，29 个文件 |

> **注意**：经过仔细检查，本项目**不包含** Web/H5 实现版本。仅有上述两个 iOS 原生实现。

## 📱 应用信息

- **App Store**: https://itunes.apple.com/app/id1133036606
- **支持网站**: http://app.wodedata.com/myapp/photodiy.html
- **当前版本**: 1.2 (Build 20180130)
- **Bundle ID**: com.wodedata.PhotoDIY

---

## 📊 详细技术分析

### 架构对比

| 维度 | OC 版本 | Swift 版本 |
|------|---------|------------|
| **架构模式** | MVC（传统） | MVVM + Coordinator Pattern |
| **UI 框架** | UIKit + Storyboard | SwiftUI + UIKit 混合 |
| **图像处理** | GPUImage (第三方) | Core Image + Metal Performance Shaders |
| **响应式编程** | KVO + Delegate | Combine Framework |
| **依赖管理** | CocoaPods | 无（纯 Swift 原生） |
| **数据持久化** | NSUserDefaults + File System | Core Data + CloudKit 同步 |
| **依赖注入** | 无 | 自定义 DI 容器 |
| **最低 iOS 版本** | iOS 7.0+ | iOS 15.0+ |
| **代码维护性** | 中等 | 高（现代化架构） |

---

## 🏗️ OC 版本 (Legacy - Objective-C)

### 🎯 版本概要

- **项目路径**: `OC/PhotoDIY.xcworkspace`
- **语言**: Objective-C
- **最低 iOS 版本**: 7.0+
- **项目结构**: `.xcworkspace` (CocoaPods)
- **UI 框架**: UIKit + Storyboard
- **版本**: 1.2 (Build 20180130)
- **代码规模**: 22,665 行代码，134 个 .h/.m 文件
- **状态**: ✅ 已上线 App Store，生产环境稳定运行

### 核心依赖

#### 图像处理
- **GPUImage** (0.1.7) - 实时滤镜和效果处理
- **SDWebImage** (3.8.1) - 异步图像加载和缓存

#### UI 组件
- **MBProgressHUD** - 进度指示器
- **FCAlertView** (1.4.0) - 自定义弹窗
- **FDStackView** (1.0) - 堆栈视图
- **FXBlurView** (1.6.4) - 模糊效果

#### 社交分享
- **UMengUShare** (6.2.2) - 统一社交分享平台
  - 微信 (WeChat): `wxe9ee15bc76746188`
  - 新浪微博 (Sina Weibo): `wb3082351787`
  - QQ: `tencent1105751861` / `QQ41e86f35`
  - Twitter
  - Instagram
  - Facebook: `fb326136004438567`

#### 广告
- **Google-Mobile-Ads-SDK** (7.28.0)

### 项目结构

```
OC/PhotoDIY/
├── AppDelegate.h/m          # 应用入口
├── PhotoTools/              # 核心照片处理和相机功能
├── ContentView/             # 主编辑界面和 UI 组件
├── DataManager/             # 数据持久化和应用状态管理
├── ThirdParts/              # 第三方集成和自定义修改
├── Assets.xcassets/         # 图像资源（按功能组织）
│   ├── FilterView/          # 滤镜相关资源
│   ├── ToolBar/             # 工具栏图标
│   ├── Drawboard/           # 绘图板资源
│   └── ...
├── InAppPurchase/           # 应用内购买
├── Resource/                # 其他资源文件
└── *.lproj/                 # 多语言支持
```

### 多语言支持

- 🇨🇳 简体中文 / 繁体中文
- 🇺🇸 English
- 🇰🇷 Korean
- 🇯🇵 Japanese
- 🇸🇦 Arabic
- 🇩🇪 German
- 🇪🇸 Spanish
- 🇫🇷 French
- 🇵🇹 Portuguese
- 🇷🇺 Russian

### 构建命令

```bash
# 安装 CocoaPods 依赖
cd OC && pod install

# 打开项目（必须使用 .xcworkspace）
open PhotoDIY.xcworkspace

# 使用 Xcode 构建和运行
```

### 图标和启动图生成

```bash
# 安装工具
brew install imagemagick
sudo npm i -g ticons

# 生成图标
ticons icons ./PhotoDIY.png --output-dir ~/Pictures/icons --alloy --platforms iphone,ipad

# 生成启动屏幕
ticons splashes ./Launch.png --output-dir ~/Pictures/launch --alloy --platforms iphone,ipad
```

### 模拟器构建（Facebook 审核）

```bash
# 从 DerivedData 创建模拟器构建包
ditto -ck --sequesterRsrc --keepParent \
  `ls -1 -d -t ~/Library/Developer/Xcode/DerivedData/*/Build/Products/*-iphonesimulator/PhotoDIY.app | head -n 1` \
  ~/Desktop/PhotoDIY.zip

# 使用 ios-sim 验证
ios-sim --devicetypeid com.apple.CoreSimulator.SimDeviceType.iPhone-6s launch ~/Desktop/PhotoDIY.app
```

---

## 🚀 Swift 版本 (现代化重写)

### 🎯 版本概要

- **项目路径**: `Swift/Photofy.xcodeproj`
- **语言**: Swift 5.9+
- **最低 iOS 版本**: 15.0+
- **架构**: MVVM + Coordinator Pattern
- **UI 框架**: SwiftUI + UIKit (混合)
- **响应式编程**: Combine Framework
- **依赖管理**: 无外部依赖管理器（100% 原生 Swift）
- **代码规模**: 10,000 行代码，29 个 .swift 文件
- **状态**: 🚧 开发中（位于 `swift` 分支）

### 🏛️ 架构优势

Swift 版本采用现代化的软件工程实践：

1. **MVVM + Coordinator Pattern**
   - 清晰的职责分离
   - 可测试性强
   - 导航逻辑独立管理

2. **依赖注入（DI Container）**
   - 松耦合设计
   - 易于单元测试
   - 模块化组件

3. **Combine 响应式编程**
   - 声明式数据流
   - 自动内存管理
   - 异步操作简化

4. **SwiftUI + UIKit 混合**
   - 现代化 UI 声明式语法
   - 复杂视图使用 UIKit 保证性能
   - 渐进式迁移策略

### 核心技术

#### 图像处理
- **Core Image** - 滤镜和效果
- **Metal Performance Shaders** - 高性能图像处理
- **PhotoKit** - 现代化照片库访问

#### 架构特性
- **Dependency Injection** - 自定义 DI 容器
- **Coordinator Pattern** - 导航管理
- **Combine** - 响应式数据流
- **Core Data** - 数据持久化（支持 CloudKit 同步）

#### 分享功能
- **UIActivityViewController** - 原生分享
- 自定义社交活动扩展

### 项目结构

```
Swift/Photofy/
├── App/
│   ├── PhotofyApp.swift        # SwiftUI 应用入口
│   ├── ContentView.swift       # 主视图
│   └── AppState.swift          # 全局状态管理
├── Core/
│   ├── Models/
│   │   ├── EditingHistory.swift    # 编辑历史记录
│   │   └── ...
│   ├── Services/
│   │   ├── ImageFilterManager.swift     # 滤镜管理
│   │   ├── ImageCropManager.swift       # 裁剪管理
│   │   └── ...
│   ├── Theme/                   # 主题和样式系统
│   ├── DependencyInjection/    # DI 容器
│   ├── Coordinator/            # 导航协调器
│   ├── Extensions/             # Swift 扩展
│   └── Utilities/              # 工具类
├── Views/
│   ├── EditingOverlayView.swift     # 编辑覆盖层
│   ├── CropView.swift               # 裁剪视图
│   ├── StyleToolsView.swift         # 样式工具
│   ├── FilterSelectorView.swift     # 滤镜选择器
│   ├── EditingToolsPanel.swift      # 编辑工具面板
│   ├── AIFeaturesView.swift         # AI 功能
│   ├── CameraView.swift             # 相机视图
│   ├── SettingsView.swift           # 设置页面
│   ├── EditingHistoryView.swift     # 编辑历史
│   └── ZoomableImageView.swift      # 可缩放图片视图
├── Services/
│   ├── AIImageProcessor.swift           # AI 图像处理
│   ├── AIEnhancedImageProcessor.swift   # AI 增强处理器
│   └── AdvancedStyleProcessor.swift     # 高级样式处理器
├── Models/                     # 数据模型
├── Resources/                  # 资源文件
└── Tests/                      # 单元测试和 UI 测试
```

### 主要功能模块

#### 1. 图像编辑工具
- ✂️ **裁剪工具** (`CropView.swift`) - 支持自由裁剪和预设比例
- 🎨 **滤镜系统** (`FilterSelectorView.swift`) - 多种内置滤镜
- 🖌️ **样式工具** (`StyleToolsView.swift`) - 亮度、对比度、饱和度等调整
- 📝 **文本叠加** - 添加和编辑文本
- ✏️ **绘图功能** - 自由绘制

#### 2. AI 功能
- 🤖 **AI 图像处理** (`AIImageProcessor.swift`)
- ✨ **AI 增强** (`AIEnhancedImageProcessor.swift`)
- 🎭 **高级样式** (`AdvancedStyleProcessor.swift`)

#### 3. 编辑管理
- 📜 **编辑历史** (`EditingHistory.swift`, `EditingHistoryView.swift`)
  - 撤销/重做功能
  - 历史记录查看
- 💾 **状态持久化** - Core Data + CloudKit

#### 4. 用户界面
- 📷 **相机集成** (`CameraView.swift`)
- ⚙️ **设置页面** (`SettingsView.swift`)
- 🔍 **缩放和平移** (`ZoomableImageView.swift`)
- 🛠️ **编辑工具面板** (`EditingToolsPanel.swift`)

### 构建命令

```bash
# 使用 Xcode 打开项目
cd Swift/Photofy
open Photofy.xcodeproj

# 使用 xcodebuild 命令行构建
xcodebuild -project Photofy.xcodeproj \
  -scheme Photofy \
  -destination 'platform=iOS Simulator,name=iPhone 17' \
  build

# 运行测试
xcodebuild -project Photofy.xcodeproj \
  -scheme Photofy \
  -destination 'platform=iOS Simulator,name=iPhone 17' \
  test
```

### 开发工作流

```bash
# 切换到 Swift 实现
git checkout swift

# 切换回 Objective-C
git checkout main
```

---

## 🔄 功能特性对比

### 已实现功能

| 功能模块 | OC 版本 | Swift 版本 | 备注 |
|---------|---------|-----------|------|
| **基础编辑** |
| 图像裁剪 | ✅ | ✅ | Swift 版更流畅 |
| 图像旋转/翻转 | ✅ | ✅ | |
| 缩放和平移 | ✅ | ✅ `ZoomableImageView` | |
| **滤镜系统** |
| 预设滤镜 | ✅ GPUImage | ✅ Core Image | Swift 版性能更优 |
| 滤镜强度调节 | ✅ | ✅ | |
| 自定义滤镜 | ✅ | ✅ | |
| **样式调整** |
| 亮度/对比度 | ✅ | ✅ `StyleToolsView` | |
| 饱和度 | ✅ | ✅ | |
| 色温/色调 | ✅ | ✅ | |
| **高级功能** |
| 绘图工具 | ✅ `LWDrawView` | ✅ | OC 版功能更丰富 |
| 文字叠加 | ✅ | ✅ | |
| 涂鸦/画笔 | ✅ `LWScrawlView` | ✅ | |
| 马赛克/模糊 | ✅ `LWScratchView` | ⏳ 待实现 | |
| **AI 功能** |
| AI 图像增强 | ❌ | ✅ `AIEnhancedImageProcessor` | Swift 独有 |
| 高级样式处理 | ❌ | ✅ `AdvancedStyleProcessor` | Swift 独有 |
| **编辑管理** |
| 撤销/重做 | ❌ | ✅ `EditingHistory` | Swift 独有 |
| 编辑历史查看 | ❌ | ✅ `EditingHistoryView` | Swift 独有 |
| **社交分享** |
| 微信分享 | ✅ UMengUShare | ⏳ 待实现 | |
| 微博分享 | ✅ | ⏳ 待实现 | |
| Facebook/Twitter | ✅ | ✅ 原生 `UIActivityViewController` | |
| Instagram | ✅ | ✅ | |
| **变现功能** |
| Google Ads | ✅ | ⏳ 待实现 | |
| 应用内购买 | ✅ | ⏳ 待实现 | |
| **其他** |
| 相机集成 | ✅ | ✅ `CameraView` | |
| 照片库访问 | ✅ | ✅ PhotoKit | Swift 使用现代 API |
| 多语言支持 | ✅ 10 种语言 | ⏳ 部分实现 | |
| 推送通知 | ✅ | ⏳ 待实现 | |
| 数据同步 | ❌ | ✅ CloudKit | Swift 独有 |

### 技术栈对比

| 特性 | OC 版本 | Swift 版本 |
|------|---------|------------|
| **语言** | Objective-C | Swift 5.9+ |
| **最低 iOS** | 7.0+ | 15.0+ |
| **UI 框架** | UIKit + Storyboard | SwiftUI + UIKit |
| **架构** | MVC | MVVM + Coordinator |
| **图像处理** | GPUImage | Core Image + Metal |
| **响应式** | KVO/Delegate | Combine |
| **依赖管理** | CocoaPods (8 个依赖) | 无（原生） |
| **代码规模** | 22,665 行 | 10,000 行 |
| **状态** | ✅ 生产环境 | 🚧 开发中 |
| **分支** | `master` | `swift` |

---

## 🛠️ 开发指南

### 前置要求

- Xcode 15.0+
- macOS 13.0+
- iOS 15.0+ (Swift) 或 iOS 7.0+ (OC)
- CocoaPods (仅 OC 版本)

### 安装步骤

#### OC 版本
```bash
cd OC
pod install
open PhotoDIY.xcworkspace
```

#### Swift 版本
```bash
cd Swift
open Photofy.xcodeproj
```

### 权限配置

应用需要以下权限：
- 📷 **相机访问** - 拍摄照片
- 🖼️ **照片库访问** - 选择和保存照片
- 💾 **照片库添加** - 保存编辑后的图片

权限描述已在 `Info.plist` 中配置。

---

## 📦 发布流程

### App Store 信息
- **版本**: 1.2
- **功能**:
  - iPhone X 兼容性
  - 自定义字体下载
  - 推送通知支持
  - 远程通知后台模式

### 构建配置
- 支持设备: iPhone 和 iPad
- 支持方向:
  - iPhone: 仅竖屏
  - iPad: 所有方向

---

## 🔐 社交平台配置

### 已集成平台

#### 微信 (WeChat)
- App ID: `wxe9ee15bc76746188`
- URL Scheme: `wxe9ee15bc76746188`

#### 新浪微博 (Sina Weibo)
- App Key: `3082351787`
- URL Scheme: `wb3082351787`

#### QQ
- App ID: `1105751861`
- URL Schemes: `tencent1105751861`, `QQ41e86f35`

#### Facebook
- App ID: `326136004438567` (Test)
- Production: `325600794492088`
- URL Scheme: `fb326136004438567`

#### Twitter & Instagram
- 原生支持

---

## 📄 许可证

版权所有 © 2018 WodeData. 保留所有权利。

---

## 📞 支持

如有问题或建议，请访问：
- 支持网站: http://app.wodedata.com/myapp/photodiy.html
- App Store: https://itunes.apple.com/app/id1133036606

---

## 🗺️ 开发路线图与项目演进

### 当前状态
- ✅ **OC 版本**：已上线 App Store，稳定运行于生产环境
- 🚧 **Swift 版本**：正在开发中（`swift` 分支），已完成核心功能 60%

### 项目演进历史

```
2016-2018  →  OC 版本开发及上线
   ├─ 2016.11: 项目启动
   ├─ 2017.03: 首次上线 App Store (v1.0)
   ├─ 2017.11: 添加 iPhone X 支持
   └─ 2018.01: 发布 v1.2（当前生产版本）

2024-至今  →  Swift 版本重写
   ├─ 2024.09: Swift 重写项目启动
   ├─ 2024.09: 完成基础架构和核心编辑功能
   └─ 2025.10: 持续开发中
```

### Swift 版本待完成功能（优先级排序）

#### 🔴 高优先级（核心功能）
- [ ] 完整的社交分享集成（微信、微博）
- [ ] 马赛克/模糊工具实现
- [ ] 应用内购买支持
- [ ] 完整的本地化支持（10 种语言）

#### 🟡 中优先级（增强功能）
- [ ] 推送通知支持
- [ ] 更多滤镜效果
- [ ] UI/UX 优化和动画效果
- [ ] 性能优化（大图处理）

#### 🟢 低优先级（可选功能）
- [ ] 完整单元测试覆盖
- [ ] UI 自动化测试
- [ ] 深色模式优化
- [ ] iPad 适配优化

---

## 💡 技术选型建议

### 何时使用 OC 版本？
- ✅ 需要立即上线的功能
- ✅ 需要支持旧版 iOS 设备（iOS 7-14）
- ✅ 需要完整的变现功能（广告、内购）
- ✅ 需要成熟的社交分享集成

### 何时使用 Swift 版本？
- ✅ 新功能开发和实验
- ✅ 需要现代化架构和可维护性
- ✅ 需要 AI 功能（图像增强）
- ✅ 需要编辑历史和撤销功能
- ✅ 只支持 iOS 15+ 的新项目

---

## 📈 代码质量对比

| 指标 | OC 版本 | Swift 版本 |
|------|---------|-----------|
| **代码复杂度** | 高（MVC 模式） | 低（MVVM 清晰分层） |
| **可测试性** | 低 | 高（DI + 单元测试友好） |
| **可维护性** | 中等 | 高（现代语法 + 清晰架构） |
| **性能** | 良好（GPUImage 优化） | 优秀（Metal + Core Image） |
| **第三方依赖** | 8 个 CocoaPods | 0 个（100% 原生） |
| **编译时间** | 慢（OC + CocoaPods） | 快（纯 Swift） |
| **崩溃率** | 低（生产验证） | 待验证 |
| **代码复用** | 低 | 高（模块化设计） |

---

## 🎯 未来规划

### 短期目标（1-3 个月）
1. 完成 Swift 版本核心功能开发
2. 实现社交分享功能对齐
3. 添加完整的错误处理和日志
4. 性能测试和优化

### 中期目标（3-6 个月）
1. Swift 版本功能完全对齐 OC 版
2. 完整的单元测试覆盖（>80%）
3. UI/UX 现代化改进
4. App Store 上架准备

### 长期目标（6-12 个月）
1. Swift 版本替代 OC 版作为主版本
2. 添加更多 AI 驱动功能
3. 跨平台扩展（iPad、macOS）
4. 社区版本开源考虑

---

**最后更新**: 2025-10-02
**文档版本**: 2.0
**分析工具**: Claude Code