AutoDev iOS App

这是 AutoDev 的 iOS 应用,使用 Kotlin Multiplatform 和 Compose Multiplatform 构建。

✨ 功能特性

• ✅ 自动构建 Kotlin Framework (mpp-core 和 mpp-ui)
• ✅ 自动解析 Swift Package Manager 依赖 (MCP SDK)
• ✅ 生成可运行的 .app 文件
• ✅ 支持模拟器和真机构建
• ✅ 支持 Debug 和 Release 配置

🚀 快速开始

最简单的方式：

cd mpp-ios
./build-ios-app.sh --build    # 构建 .app 文件
./build-ios-app.sh --run      # 构建并运行到模拟器

构建成功后，.app 文件位于：mpp-ios/build/Build/Products/Debug-iphonesimulator/AutoDevApp.app

📖 详细构建方式

方法 1: 使用构建脚本 (推荐)

cd mpp-ios

# 构建应用（生成 .app 文件）
./build-ios-app.sh --build

# 构建并运行到模拟器
./build-ios-app.sh --run

# 清理后重新构建
./build-ios-app.sh --clean

# 构建 Release 版本
./build-ios-app.sh --release --build

# 为真机构建（需要配置签名）
./build-ios-app.sh --device

# 查看帮助
./build-ios-app.sh --help

方法 2: 使用 Makefile

从项目根目录运行:

# 查看所有可用命令
make help

# 构建 iOS 应用
make ios-build

# 构建并运行到模拟器
make ios-run

# 清理并重新构建
make ios-clean

# 构建 Release 版本
make ios-release

方法 3: 使用 Gradle Tasks

从项目根目录运行:

# 查看所有 iOS 任务
./gradlew tasks --group=ios

# 构建 iOS 应用
./gradlew iosBuildApp

# 构建并运行到模拟器
./gradlew iosRun

# 清理并重新构建
./gradlew iosClean

# 构建 Release 版本
./gradlew iosRelease

🔧 构建过程

这些命令会自动:

1. ✅ 编译 Kotlin Framework (mpp-core 和 mpp-ui)
2. ✅ 安装 CocoaPods 依赖
3. ✅ 解析 Swift Package Manager 依赖 (MCP SDK)
4. ✅ 构建 iOS 应用并生成 .app 文件
5. ✅ (可选) 安装并运行到模拟器

📦 构建产物

成功构建后，你会得到：

• Debug 模拟器版本: mpp-ios/build/Build/Products/Debug-iphonesimulator/AutoDevApp.app
• Release 模拟器版本: mpp-ios/build/Build/Products/Release-iphonesimulator/AutoDevApp.app
• 真机版本: mpp-ios/build/Build/Products/Debug-iphoneos/AutoDevApp.app (需要配置签名)

⚠️ 常见问题

1. "No such module 'MCP'" 错误

这个问题已经解决！构建脚本会自动解析 Swift Package Manager 依赖。

2. 重复符号错误

确保 Podfile 中只链接 AutoDevUI，不要同时链接 AutoDevCore，因为 AutoDevUI 已经 export 了 AutoDevCore。

3. SQLite 链接错误

Podfile 已经配置了 -lsqlite3 链接器标志，如果仍然出现问题，请运行 pod install 重新安装依赖。

方法 4: 手动步骤

1. 安装依赖

确保您已安装:

• Xcode 15.0+
• CocoaPods (sudo gem install cocoapods)
• Gradle (项目已包含)

2. 编译 Kotlin Framework

cd mpp-ios
./build-framework.sh

3. 安装 CocoaPods 依赖

pod install

重要: pod install 会自动配置所有必要的编译参数,无需手动修改 Xcode 配置!

详见: PODFILE-CONFIG.md

4. 打开 Xcode 项目

open AutoDevApp.xcworkspace

注意: 必须打开 .xcworkspace 文件,而不是 .xcodeproj 文件!

5. 运行应用

1. 在 Xcode 中选择模拟器 (例如: iPhone 15 Pro)
2. 点击 Run 按钮 (⌘R)
3. 应用将启动并显示 AutoDev Compose UI

项目结构

mpp-ios/
├── AutoDevApp/                    # iOS 应用源代码
│   ├── AutoDevApp.swift          # 应用入口
│   ├── ContentView.swift         # 主视图
│   ├── ComposeView.swift         # Compose UI 包装器
│   ├── Info.plist                # 应用配置
│   └── Assets.xcassets/          # 资源文件
├── AutoDevApp.xcodeproj/         # Xcode 项目
├── AutoDevApp.xcworkspace/       # CocoaPods 工作空间 (pod install 后生成)
├── Podfile                       # CocoaPods 依赖配置
└── README.md                     # 本文件

自动化脚本

新版构建脚本 (推荐)

build-ios-app.sh - 完整的 iOS 构建脚本,支持多种选项:

# 基本用法
./build-ios-app.sh                    # 编译 framework + pod install + 打开 Xcode
./build-ios-app.sh --build            # 完整构建应用
./build-ios-app.sh --run              # 构建并运行到模拟器
./build-ios-app.sh --clean            # 清理后重新构建
./build-ios-app.sh --release          # 使用 Release 配置
./build-ios-app.sh --device           # 为真机构建
./build-ios-app.sh --help             # 显示帮助

# 组合使用
./build-ios-app.sh --clean --release --build  # 清理后构建 Release 版本

旧版脚本 (仍然可用)

build-and-run.sh - 简化版脚本:

./build-and-run.sh

这个脚本会:

1. 编译 Kotlin Framework
2. 安装 CocoaPods 依赖
3. 打开 Xcode 项目

build-framework.sh - 仅编译 Framework:

./build-framework.sh              # Debug 模拟器版本
./build-framework.sh release      # Release 版本
./build-framework.sh device       # 真机版本

开发指南

修改 Kotlin 代码后

每次修改 mpp-core 或 mpp-ui 中的 Kotlin 代码后:

# 重新编译 framework
cd ..
./gradlew :mpp-ui:linkDebugFrameworkIosSimulatorArm64

# 返回 iOS 项目
cd mpp-ios

# 重新安装 pod (可选,如果 framework 没有更新)
pod install

# 在 Xcode 中重新运行

修改 Swift 代码后

直接在 Xcode 中修改并运行即可,无需重新编译 framework。

切换到真机

1. 编译真机 framework:

   cd ..
   ./gradlew :mpp-ui:linkDebugFrameworkIosArm64
   

2. 在 Xcode 中:

   • 连接 iPhone/iPad
   • 选择您的设备
   • 设置开发团队 (Signing & Capabilities)
   • 运行

⚙️ Podfile 自动配置

本项目的 Podfile 已配置为自动管理所有编译参数,包括:

• ✅ FRAMEWORK_SEARCH_PATHS - Framework 搜索路径
• ✅ OTHER_LDFLAGS - 链接器标志 (-ObjC, -lc++, -framework AutoDevUI, -lsqlite3)
• ✅ ENABLE_BITCODE - 禁用 Bitcode (Kotlin/Native 不支持)
• ✅ IPHONEOS_DEPLOYMENT_TARGET - iOS 最低版本

这意味着您无需手动修改 Xcode 项目配置!

每次运行 pod install 时,这些参数会自动应用到生成的 .xcconfig 文件中。

详细说明请参考: PODFILE-CONFIG.md

验证配置

运行 pod install 后,可以验证配置是否正确:

cat Pods/Target\ Support\ Files/Pods-AutoDevApp/Pods-AutoDevApp.debug.xcconfig | grep -E "OTHER_LDFLAGS|FRAMEWORK_SEARCH_PATHS"

应该看到类似输出:

FRAMEWORK_SEARCH_PATHS = $(inherited) "${PODS_ROOT}/../../mpp-core/build/bin/iosSimulatorArm64/debugFramework" "${PODS_ROOT}/../../mpp-ui/build/bin/iosSimulatorArm64/debugFramework"
OTHER_LDFLAGS = $(inherited) -ObjC -l"c++" -framework "AutoDevCore" -framework "AutoDevUI"

故障排除

Pod install 失败

# 清理 CocoaPods 缓存
pod cache clean --all
pod deintegrate
pod install

Framework 找不到

确保已编译对应架构的 framework:

• 模拟器 (Apple Silicon): iosSimulatorArm64
• 模拟器 (Intel): iosX64
• 真机: iosArm64

Xcode 编译错误

1. 清理项目: Product -> Clean Build Folder (⇧⌘K)
2. 重新安装 pods: pod install
3. 重启 Xcode

运行时崩溃

检查:

1. Framework 是否正确嵌入
2. Bitcode 是否已禁用 (应该是 NO)
3. Deployment Target 是否正确 (14.0+)

配置

Bundle Identifier

默认: cc.unitmesh.AutoDevApp

修改位置:

• Xcode: Target -> General -> Bundle Identifier
• 或修改 project.pbxproj 中的 PRODUCT_BUNDLE_IDENTIFIER

Deployment Target

默认: iOS 14.0

修改位置:

• Xcode: Target -> General -> Deployment Info
• 或修改 project.pbxproj 中的 IPHONEOS_DEPLOYMENT_TARGET

开发团队

在 Xcode 中设置:

1. 选择 Target -> Signing & Capabilities
2. 选择您的 Team
3. Xcode 会自动配置证书和 Provisioning Profile

性能优化

使用 Release Framework

cd ..
./gradlew :mpp-ui:linkReleaseFrameworkIosSimulatorArm64

然后在 Podfile 中修改路径为 release 配置。

减小应用大小

1. 使用 Release 配置
2. 启用代码优化
3. 移除未使用的资源

相关文档

• iOS 支持总结
• iOS 集成指南
• iOS 示例应用
• iOS README

技术栈

• Swift 5.0+ - iOS 应用代码
• SwiftUI - UI 框架
• Kotlin Multiplatform - 共享业务逻辑
• Compose Multiplatform - 跨平台 UI
• CocoaPods - 依赖管理

许可证

与 AutoDev 主项目相同。

支持

如有问题,请查看:

• 故障排除
• GitHub Issues
• 项目文档

---

享受在 iOS 上使用 AutoDev! 🚀📱