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

项目结构

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

构建命令

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

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

# 使用 Xcode 构建和运行

图标和启动图生成

# 安装工具
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 审核）

# 从 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 版本采用现代化的软件工程实践：

MVVM + Coordinator Pattern
- 清晰的职责分离
- 可测试性强
- 导航逻辑独立管理
依赖注入（DI Container）
- 松耦合设计
- 易于单元测试
- 模块化组件
Combine 响应式编程
- 声明式数据流
- 自动内存管理
- 异步操作简化
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)

构建命令

# 使用 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

开发工作流

# 切换到 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 版本

cd OC
pod install
open PhotoDIY.xcworkspace

Swift 版本

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

原生支持

📄 许可证

📞 支持

如有问题或建议，请访问：

支持网站: 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 个月）

完成 Swift 版本核心功能开发
实现社交分享功能对齐
添加完整的错误处理和日志
性能测试和优化

中期目标（3-6 个月）

Swift 版本功能完全对齐 OC 版
完整的单元测试覆盖（>80%）
UI/UX 现代化改进
App Store 上架准备

长期目标（6-12 个月）

Swift 版本替代 OC 版作为主版本
添加更多 AI 驱动功能
跨平台扩展（iPad、macOS）
社区版本开源考虑

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

Name		Name	Last commit message	Last commit date
Latest commit History 132 Commits
.claude		.claude
.github		.github
OC		OC
Swift		Swift
doc		doc
graphify-out		graphify-out
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
PhotoDIY-OC-Analysis.md		PhotoDIY-OC-Analysis.md
Photofy-Development-Roadmap.md		Photofy-Development-Roadmap.md
Photofy-Swift-Technical-Specification.md		Photofy-Swift-Technical-Specification.md
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

PhotoDIY - 图片编辑应用

graphify Knowledge Graph

📚 项目概览

🔹 版本对比总览

📱 应用信息

📊 详细技术分析

架构对比

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

🎯 版本概要

核心依赖

图像处理

UI 组件

社交分享

广告

项目结构

多语言支持

构建命令

图标和启动图生成

模拟器构建（Facebook 审核）

🚀 Swift 版本 (现代化重写)

🎯 版本概要

🏛️ 架构优势

核心技术

图像处理

架构特性

分享功能

项目结构

主要功能模块

1. 图像编辑工具

2. AI 功能

3. 编辑管理

4. 用户界面

构建命令

开发工作流

🔄 功能特性对比

已实现功能

技术栈对比

🛠️ 开发指南

前置要求

安装步骤

OC 版本

Swift 版本

权限配置

📦 发布流程

App Store 信息

构建配置

🔐 社交平台配置

已集成平台

微信 (WeChat)

新浪微博 (Sina Weibo)

QQ

Facebook

Twitter & Instagram

📄 许可证

📞 支持

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

当前状态

项目演进历史

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

🔴 高优先级（核心功能）

🟡 中优先级（增强功能）

🟢 低优先级（可选功能）

💡 技术选型建议

何时使用 OC 版本？

何时使用 Swift 版本？

📈 代码质量对比

🎯 未来规划

短期目标（1-3 个月）

中期目标（3-6 个月）

长期目标（6-12 个月）

About

Topics

Resources

Uh oh!

Stars

Watchers

Packages