docs: add iOS deployment guide for Flutter project#3
Open
225441 wants to merge 1 commit into
Open
Conversation
Add comprehensive guide for building and installing Mobile Agent on iOS physical devices using free Apple Developer account. Covers: - Environment setup (Xcode, Flutter, CocoaPods) - Creating iOS project and disabling Swift Package Manager - Configuring code signing with free Apple ID - Enabling iOS Developer Mode (iOS 16+) - Common issues: white screen, SPM conflicts, missing platform - Free developer account limitations
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概述
docs/ios-deployment-guide.md（项目级通用指南）mobile_agent/README_iOS_DEPLOY.md（移动端专项指南）涵盖内容
环境准备（macOS、Xcode、Flutter、CocoaPods 版本要求）
创建 iOS 项目及禁用 Swift Package Manager（解决
flutter_secure_storage插件冲突）免费 Apple ID 个人开发者账号签名配置步骤
iOS 16+ 开发者模式开启（含重启后弹窗二次确认的关键步骤）
命令行和 Xcode 两种安装方式
首次运行时的开发者证书信任流程
常见问题排查：
xcodebuild -downloadPlatform iOS免费开发者账号限制说明
App 安装后 7 天有效，到期需重新编译安装
同一时间最多安装 3 个个人证书签名的 App
无法发布到 App Store（需付费 Developer Program，¥688/年）
已在 iPhone 真机实测通过。