个人开发者使用 Flutter 开发 App
并上架 App Store 完整流程指南
面向独立开发者:环境准备 → 账号注册 → 项目配置 → 证书签名 → 打包上传 → TestFlight → 审核上架 → 后续运营,全链路 20 章。
一、全流程总览(一张图看懂)
flutter build ipa --release关键时间预期(首次上架)
| 事项 | 耗时(典型) |
|---|---|
| 个人开发者账号注册审核 | 即时 ~ 3 个工作日(可能人脸核验) |
| ICP 备案(中国大陆,个人主体) | 约 1~3 周(依托云厂商免费办理) |
| 上传后构建处理 | 5~30 分钟(邮件通知结果) |
| TestFlight 外部测试首版审核 | 通常 1 天内(首次较严) |
| App 审核 Waiting for Review | 1~3 天(旺季可能更久) |
| In Review(在审) | 几小时 ~ 1 天 |
二、前置条件与费用清单
2.1 硬性条件
一台 Mac
构建 iOS App 必须用 macOS(Xcode 无 Windows 版)。没有 Mac 可考虑 Mac mini、云 Mac(MacStadium、阿里云 Mac)或 CI 服务(Codemagic、GitHub Actions macOS runner)。
Xcode
Mac App Store 安装最新稳定版,2026 年主流为 Xcode 16.x。
Flutter SDK
建议 stable 渠道最新版(Flutter 3.3x+),可用 fvm 管理多版本。
Apple ID + 双重认证
必须开启 2FA;建议使用自己长期使用、不会废弃的 Apple ID。
一台 iPhone(强烈建议):真机调试与体验测试,模拟器无法测试推送、相机、部分传感器能力。
2.2 费用清单
| 项目 | 费用 | 说明 |
|---|---|---|
| Apple Developer Program(个人) | US$99/年 | 到期不续 App 会下架;支持双币信用卡支付 |
| ICP 备案 | 免费 | 云厂商(阿里云/腾讯云等)代办,需国内服务器/域名 |
| 软著(计算机软件著作权) | 免费 ~ 几百元代理费 | iOS 非强制;安卓商店强制;建议办理(部分省份备案前置要求) |
| 苹果设备 | 自备 | Mac + iPhone |
2.3 个人账号要点与可上架范围
- 年费 US$99,商店中"供应商/卖家"显示为你的个人法定姓名(拼音),与"开发者名称"不是一回事,属正常现象。
- 无需 D-U-N-S 编码、无需营业执照,凭本人身份即可注册,通常线上人脸核验,很少电话回访。
- 不支持添加团队成员,证书、App、收款都在你一个人名下。
- 可上架范围:工具类、效率类、内容阅读类等非经营性轻量 App 最友好;社交、直播、金融、医疗、新闻等类目以及含版号要求的游戏,个人主体在国区基本无法通过,建议避开或仅上架海外区。
三、第一步:注册 Apple Developer Program 账号
四、Flutter 开发环境准备
4.1 安装 Flutter 与 Xcode
# 1) 安装 Flutter SDK(推荐 fvm 管理多版本)
# 官方下载:https://docs.flutter.dev/get-started/install/macos
# 2) 检查环境
flutter doctor -v
flutter doctor 中与 iOS 相关的两项必须通过:Xcode - develop for iOS and macOS 与 CocoaPods installed(Flutter 的 iOS 插件依赖管理工具)。若 CocoaPods 缺失:
sudo gem install cocoapods # 或 brew install cocoapods
pod --version
4.2 创建 / 打开项目
flutter create --org com.yourname --project-name my_app my_app
cd my_app
open ios/Runner.xcworkspace # 永远打开 .xcworkspace,不是 .xcodeproj
--org com.yourname会构成 Bundle ID 前缀,如com.yourname.myApp。Bundle ID 一旦上架不可更改,建议使用自己拥有的域名反写。- 首次真机运行:在 Xcode 中登录 Apple ID(Settings → Accounts),数据线连接 iPhone,信任开发者证书后
flutter run。
4.3 iOS 最低系统版本
Flutter 当前支持 iOS 13 及以上(以官方 flutter.dev/deployment/ios 为准)。在 Xcode → Runner → Build Settings → iOS Deployment Target 设置;若插件要求更高版本需取最高值。2026 年新项目直接设 iOS 13/14 通常无压力。
五、注册 Bundle ID(App ID)
Bundle ID 是 App 在苹果生态的唯一身份证,建议与 ios/Runner.xcodeproj 中的 PRODUCT_BUNDLE_IDENTIFIER 完全一致。
com.yourname.myapp,不要用通配符 Wildcard(内购/推送不支持)六、在 App Store Connect 创建应用记录
- 打开 App Store Connect → 我的 App(My Apps) → 左上角 + → 新建 App(New App)。
- 填写表单:
- 平台:勾选 iOS(Flutter 不支持 tvOS,不勾)。
- 名称:App Store 显示名,全店唯一,后期可改(每次改需随版本审核)。
- 主要语言:简体中文 / English。
- Bundle ID:下拉选择上一步注册的 ID。
- SKU:内部管理用任意唯一字符串,如
myapp001,用户不可见。 - 用户访问权限:全权限。
- 创建后进入 App 页面,在 App 信息 / App Information 中确认 Bundle ID、副标题、类别等。
七、配置 Xcode 工程(名称/版本/签名/权限)
用 Xcode 打开 ios/Runner.xcworkspace,选中 Runner target。
7.1 General 标签
Identity
Display Name:桌面图标下显示的名称(可中文,≤ 12~15 字符为佳)。
Bundle Identifier:与后台注册一致。
Version:面向用户的营销版本号(CFBundleShortVersionString),如 1.0.0,只能加不能降级。
Build
构建号(CFBundleVersion),同一 Version 下每次上传必须递增:1 → 2 → 3。也可在 pubspec.yaml 的 version: 1.0.0+1 用 flutter build 自动写入(+号后即 build number)。
7.2 自动签名(推荐)
- Signing & Capabilities → 勾选 Automatically manage signing。
- Team 选择你本人的 Personal Team(你的名字)。
- Xcode 会自动创建/维护 Development 证书、Provisioning Profile。
- Capabilities 点 + Capability,与开发者后台保持一致(Push、Sign in with Apple 等)。
7.3 手动签名(CI 自动打包才需要,本地开发可跳过)
- 在后台 Certificates 中创建 Apple Distribution 证书(CSR 由钥匙串生成)。
- 创建一个 App Store 类型的 Provisioning Profile,绑定 Bundle ID 与发布证书,下载双击安装。
- Xcode 取消自动签名,Release 配置选择该 Profile。
.p12 妥善保存(CI 换机要用到)。个人账号通过 Xcode 自动管理最省心,手动签名仅在 Codemagic/GitHub Actions 等无人值守打包时才需要。7.4 Info.plist 权限文案(高频拒审点)
凡是用到相机、相册、麦克风、定位、通讯录、通知、蓝牙等,必须在 ios/Runner/Info.plist 添加用途描述键,且文案要说明为什么用,否则系统弹窗为空且审核必拒。
| 权限 | Info.plist Key | 示例文案 |
|---|---|---|
| 相机 | NSCameraUsageDescription | 用于拍摄头像并上传到个人资料 |
| 相册读取 | NSPhotoLibraryUsageDescription | 用于选择图片以保存/分享 |
| 仅保存到相册 | NSPhotoLibraryAddUsageDescription | 用于将生成的图片保存到相册 |
| 麦克风 | NSMicrophoneUsageDescription | 用于录制语音消息 |
| 使用期间定位 | NSLocationWhenInUseUsageDescription | 用于在地图上显示您附近的内容 |
| 始终定位 | NSLocationAlwaysAndWhenInUseUsageDescription | 需在后台持续记录您的运动轨迹 |
| 通讯录 | NSContactsUsageDescription | 用于帮助您快速邀请好友 |
| 蓝牙 | NSBluetoothAlwaysUsageDescription | 用于连接蓝牙设备 |
| 本地网络 | NSLocalNetworkUsageDescription | 用于发现局域网内的设备 |
| Face ID | NSFaceIDUsageDescription | 用于快速解锁应用 |
Flutter 常用插件对应关系:image_picker(相机+相册)、geolocator(定位)、permission_handler(按其 README 补充所有用到的键)、speech_to_text(麦克风+可能需要语音识别键)。
7.5 加密声明(出口合规)
App 使用了 HTTPS 即涉及加密。在 Info.plist 添加以下键后,可免去每次上传都在后台手动声明(仅使用系统标准 HTTPS/TLS 的普通 App 适用):
<key>ITSAppUsesNonExemptEncryption</key>
<false/>
若 App 自带专有加密算法、VPN、自定义加密协议等,需如实选"是"并可能提交文档。
7.6 其他配置
- 支持方向:General → Deployment Info → Device Orientation(竖屏手机应用只留竖屏可减少适配成本)。
- iPad:若不想适配 iPad,可在 App Store Connect 提审时仅勾选 iPhone,或在 Xcode 设置 Devices 为 iPhone。
- Launch Screen:使用
LaunchScreen.storyboard(默认),勿放广告/动态内容(4.2 条款)。 - 删除无用的模拟器架构/调试代码,关闭调试日志中的敏感输出。
八、配置应用图标与启动屏
8.1 App 图标
iOS 不允许透明背景/圆角(系统自动裁切圆角),准备一张 1024×1024 PNG 方形不透明图标。推荐用 flutter_launcher_icons 一键生成全尺寸:
# pubspec.yaml dev_dependencies 中加入
flutter_launcher_icons: ^0.14.0
flutter_icons:
ios: true
image_path: "assets/icon/app_icon.png" # 1024x1024 不透明 PNG
remove_alpha_ios: true
# 可选:iOS 18+ 深色/着色图标
image_path_dark_ios: "assets/icon/app_icon_dark.png"
image_path_tinted_ios: "assets/icon/app_icon_tinted.png"
dart run flutter_launcher_icons
也可直接用 Xcode → Assets.xcassets → AppIcon 拖入各尺寸。2024 年起 Xcode 支持单一 1024 图标自动生成全部尺寸。
8.2 启动屏(Launch Screen)
flutter_native_splash:
color: "#ffffff"
image: assets/splash/splash_logo.png
ios: true
ios_content_mode: center
android_12:
image: assets/splash/splash_logo.png
color: "#ffffff"
dart run flutter_native_splash:create
九、隐私清单与 Required Reason API 合规(2024 起强制)
Apple 自 2024 年春季起要求:使用了"Required Reason API"的 App 和第三方 SDK 都必须提供隐私清单 PrivacyInfo.xcprivacy,否则上传后收到 ITMS-91053 警告甚至无法提交审核。Flutter 新版 SDK 及主流插件已陆续内置,但需确认。
9.1 需要声明的四大类键
NSPrivacyTracking
布尔值:App 是否用于跨站/跨 App 追踪(接广告归因一般为 true)。
NSPrivacyTrackingDomains
追踪域名列表(不追踪则留空数组)。
NSPrivacyCollectedDataTypes
收集的数据类型(对应 App 隐私问卷内容,不收集可留空)。
NSPrivacyAccessedAPITypes
Required Reason API 使用声明,最常踩坑的一项。
9.2 添加步骤(Xcode)
- Xcode 菜单 File → New → File… 搜索 Property List,命名为
PrivacyInfo.xcprivacy,Target 勾选 Runner。 - 按上表填写四项键;常用的 Required Reason 示例:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>NSPrivacyTracking</key><false/>
<key>NSPrivacyTrackingDomains</key><array/>
<key>NSPrivacyCollectedDataTypes</key><array/>
<key>NSPrivacyAccessedAPITypes</key>
<array>
<dict>
<key>NSPrivacyAccessedAPIType</key>
<string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
<key>NSPrivacyAccessedAPITypeReasons</key>
<array><string>C617.1</string></array>
</dict>
<dict>
<key>NSPrivacyAccessedAPIType</key>
<string>NSPrivacyAccessedAPICategoryUserDefaults</string>
<key>NSPrivacyAccessedAPITypeReasons</key>
<array><string>CA92.1</string></array>
</dict>
<dict>
<key>NSPrivacyAccessedAPIType</key>
<string>NSPrivacyAccessedAPICategorySystemBootTime</string>
<key>NSPrivacyAccessedAPITypeReasons</key>
<array><string>35F9.1</string></array>
</dict>
</array>
</dict>
</plist>
9.3 第三方 SDK 缺失隐私清单怎么办
- 优先把所有插件升级到已内置
PrivacyInfo.xcprivacy的版本(flutter pub upgrade)。 - 在 Xcode 中展开
Pods目录,可检查对应 Pod 是否包含该文件。 - 若某老插件未适配:在 GitHub 提 issue / 换替代包;紧急情况下可自行给 Pod 补充,但升级后会被覆盖。
- 上传后邮件出现 ITMS-91053: Missing API declaration → 按邮件列出的 API 类别补声明后重新构建上传。
十、完善隐私政策与「App 隐私」标签
10.1 隐私政策
没有隐私政策 URL 无法提审(Guideline 5.1.1)。需要一个公开可访问的 HTTPS 网页链接(托管在 GitHub Pages、自己的博客、Vercel、腾讯云 COS 等均可)。内容至少包含:
- 开发者身份与联系方式(邮箱);
- 收集哪些数据(设备信息、账号、位置、相册……)、用途;
- 是否与第三方共享(列出友盟、微信 SDK、Firebase 等);
- 数据保留与删除方式、用户权利(查询/删除/注销账号入口,国内合规强制);
- 未成年人保护、政策更新机制。
10.2 App 隐私(App Store Connect 问卷)
- App Store Connect → 对应 App → App 隐私。
- 按真实情况声明收集的数据类型与用途(Analytics、App Functionality 等)。
- 声明是否用于追踪(Tracking):若用了 IDFA/广告归因必须选 Yes,并集成 ATT 弹窗。
- 数据是否与用户身份关联(Linked to User)、是否用于追踪。
10.3 建议的首次启动合规弹窗
- 首次启动展示《用户协议》《隐私政策》摘要 + 同意/不同意按钮(国区应用商店审核惯例,虽非 Apple 强制但属网信办要求)。
- 用户同意前不要初始化采集 SDK、不要申请权限。
- 涉及账号体系的 App 必须提供注销账号入口(5.1.1(v)),且"游客模式可浏览"是常见过审建议(非绝对强制)。
十一、中国大陆 ICP 备案(仅国区上架需要)
11.1 个人主体能不能备案?
可以。个人凭身份证即可办理,无需营业执照。但部分类目(新闻、出版、广播、网络文化、游戏等)个人主体不予备案,纯工具/效率类一般可行。
11.2 办理路径(以云厂商为例,免费)
沪ICP备2026xxxxxx号-x(App 备案通常是主备案号的 -N 子号/或单独 App 备案标识),填入 App Store Connect → App 信息 → App 备案号 字段- App 名称在备案时就要确定,后续改名、增删平台、包名变更多需变更备案,提前定好名称和 Bundle ID。
- 安卓商店普遍还要软著,若打算双端上架,建议趁备案同步办理软件著作权(中国版权保护中心线上申请,免费,周期数周)。
- 备案期间域名需可访问,按云厂商要求放置备案编号页脚(网站备案部分)。
- 个人开发者若只想快速试水,可先上美区/海外区,国区备案完成后再增加销售区域。
十二、本地 Release 构建前检查
flutter clean
flutter pub get
cd ios && pod install --repo-update && cd .. # 或 flutter precache --ios
flutter analyze
用 Release/Profile 模式在真机跑一遍(Debug 掩盖很多性能与权限问题):
flutter run --release # 连真机
flutter build ios --release # 仅验证可构建(产物 .app,不含 IPA)
构建前 Checklist
工程与签名
□ 版本号/构建号已设置
□ 自动签名 Team 正确
□ Deployment Target 与插件兼容
□ 真机 Release 跑通无崩溃
权限与隐私
□ 所有 Info.plist 权限文案已填且"说人话"
□ PrivacyInfo.xcprivacy 已添加
□ ATT(若用 IDFA)已集成
□ 隐私政策 URL 可公开访问
界面与素材
□ 1024 图标无 alpha
□ 启动屏无广告
□ 各主流机型(SE/全面屏)适配
□ Dark Mode(若声明支持)无白字白底
内容与账号
□ 登录类应用准备好审核专用测试账号
□ 内购走 StoreKit 沙盒验证过
□ 无测试数据/占位图/localhost 接口
□ 第三方登录同时提供"App 内其他登录方式"+Sign in with Apple
十三、打包 IPA(flutter build ipa)
13.1 一条命令打包
flutter build ipa --release
成功后产物:
build/ios/ipa/<app名>.ipabuild/ios/archive/Runner.xcarchive
若未配置 ExportOptions.plist,Flutter 会生成一个默认的(自动签名场景通常可直接用)。若打包报签名错误,先用 Xcode 打开工程走一次 Product → Archive 让 Xcode 生成并下载描述文件。
13.2 ExportOptions.plist(手动签名/CI 需要)
放在项目根或 ios/ 下:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>teamID</key><string>YOUR_TEAM_ID</string>
<key>method</key><string>app-store</string>
<key>uploadBitcode</key><false/> <!-- Bitcode 已废弃,固定 false -->
<key>uploadSymbols</key><true/> <!-- 上传符号表以在 Xcode Organizer 看到可读崩溃日志 -->
<key>compileBitcode</key><false/>
</dict>
</plist>
flutter build ipa --release \
--export-options-plist=ios/ExportOptions.plist
13.3 代码混淆(可选,推荐开启)
flutter build ipa --release \
--obfuscate --split-debug-info=build/symbols/1.0.0
把 build/symbols/ 下的符号文件自己妥善留存(不要上传服务器),以后崩溃堆栈需要它还原;uploadSymbols=true 时苹果侧也会收到 dSYM 用于 Organizer 崩溃解析。
十四、上传到 App Store Connect
14.1 方式一:Xcode Organizer(新手推荐)
open ios/Runner.xcworkspace- 菜单 Product → Archive(设备选 Any iOS Device,模拟器时菜单不可用)。
- Archive 完成自动打开 Organizer → Distribute App → App Store Connect → Upload,默认选项一路 Next。
14.2 方式二:Transporter(最稳,推荐大文件/弱网)
- Mac App Store 安装 Transporter。
- 用 App Store Connect 账号登录(或生成 App 专用密码/API Key)。
- 把
build/ios/ipa/*.ipa拖入 → 交付(Deliver)。支持断点续传,失败有详细日志。
14.3 方式三:命令行 altool / xcrun notary(CI 用)
xcrun altool --upload-app -f build/ios/ipa/app.ipa \
-t ios -u "you@example.com" -p "@keychain:AC_PASSWORD"
-p 需使用在 appleid.apple.com 生成的 App 专用密码(App-Specific Password),不是 Apple ID 登录密码。更现代的方案是 appstored / Codemagic CLI(app-store-connect),用 API Key 免 2FA,适合 CI。
14.4 上传之后
- 状态显示 Upload Received / 正在处理(Processing),约 5~30 分钟,完成后会收到邮件。
- 邮件内容很重要:ITMS 警告/错误(隐私清单、废弃 API、SDK 问题)会明确列出。Warning 不阻塞但应尽快处理,Error 必须修复重传。
- 处理完成后,构建版本出现在:App Store Connect → TestFlight 页面;提交版本页的"构建版本"下拉即可选中。
| 上传方式 | 适用场景 | 特点 |
|---|---|---|
| Xcode Organizer | 本地手动打包上传 | 图形化、自动签名友好 |
| Transporter | 已有 IPA / 网络不稳 | 支持断点续传、日志清晰,官方推荐 |
| altool / API Key | CI/CD 自动化 | 可脚本化,新版推荐 App Store Connect API |
十五、TestFlight 测试
15.1 内部测试(App Store Connect 用户)
个人账号只有你自己(账号持有人即全部内部成员,无法在后台添加其他团队成员):构建处理完成后你本人在 TestFlight App 里即可安装,无需 Beta 审核,构建最多保留 90 天。
15.2 外部测试(朋友、公测用户,最多 1 万人)
- TestFlight → 外部测试群组 → 新建测试员:填邮箱邀请,或开启公开链接(Public Link),任何人点链接即可加入(可设人数上限)。
- 首个外部构建版本必须经过 Beta App Review(通常几小时~1 天,标准接近正式审核);后续小版本若未大改常可免审。
- 必须填写测试信息(测试说明、演示账号),以及 Beta 版隐私信息。
- 测试员通过 Apple 官方 TestFlight App 安装,每个构建版本有效期 90 天。
- 崩溃与反馈可在 TestFlight → 反馈、Xcode Organizer → Crashes 中查看。
十六、填写商店资料(截图/描述/分级等)
App Store Connect → 选中 App → 准备提交的版本(如 1.0.0)。所有带感叹号/必填项都要补齐。
16.1 截图规范(2026 现行)
苹果已大幅简化:6.9 英寸(iPhone 16 Pro Max / 15 Pro Max,1320×2868)一套截图即可覆盖全部 iPhone 机型;iPad 截图仅在支持 iPad 时需要。截图必须是真实功能界面,不得放 Android 状态栏、价格、"审核中"字样或与功能无关的宣传图(4.3/2.3 拒审高发)。
| 用途 | 尺寸(px) | 要求 |
|---|---|---|
| 6.9" iPhone(主力,一套即可) | 1320 × 2868 | 竖屏 PNG/JPEG;至少 1 张,最多 10 张 |
| 6.7" / 6.5"(备用旧规格) | 1290×2796 / 1242×2688 | 若上传 6.9" 则无需再传 |
| 13" iPad Pro M4(支持 iPad 时) | 2064×2752(横/竖均可) | 最多 10 张 |
| App 预览视频(可选) | 与对应机型规格一致 | 15~30 秒,最多 3 条 |
截图制作工具:iOS Simulator ⌘S 直接出图、xcrun simctl io booted screenshot x.png、Screenshot Prod、CleanShot 加框加字。
16.2 文本信息
| 字段 | 字符限制 | 建议 |
|---|---|---|
| 名称 Name | 30 字符 | 品牌词+核心功能,不可堆砌竞品词 |
| 副标题 Subtitle | 30 字符 | 一句话卖点,可随版本改 |
| 推广文本 Promotional Text | 170 字符 | 可随时更新无需审核 |
| 描述 Description | 4000 字符 | 分功能点、更新日志、联系方式;避免提到安卓/其他平台 |
| 关键词 Keywords | 100 字符 | 英文逗号分隔,不要重复 App 名、不要用竞品商标 |
| 支持网址 / 营销网址 | URL | 支持网址必填且必须能正常访问 |
| 版权 | 如 2026 Your Name | 个人开发者填本人姓名或自己持有的品牌 |
16.3 分级、审核信息与协议
- 年龄分级:如实完成问卷;含 UGC/抽奖/无过滤网页内容分级会升高。
- 审核信息(Review Information):需要登录的 App 必须提供演示账号密码,并在备注(Notes)里写清测试步骤、特殊硬件、测试手机号/验证码获取方式;附演示视频链接可大幅降低被拒概率。
- 附件:权限说明演示视频(如后台定位、蓝牙设备)建议上传。
16.4 定价与内购(IAP)
- 免费/付费在 价格与销售范围 设置;销售区域可勾选中国内地(需备案号)、美国等。
- 数字内容/服务必须使用 Apple IAP,苹果抽成:小企业项目(个人开发者年收入低于 100 万美元自动适用)15%,标准 30%;订阅第二年起 15%。
- 实物商品、线下服务必须用微信/支付宝/Stripe 等第三方支付,不得用 IAP(3.1.1)。
- 内购商品需在 App Store Connect 配置(消耗型/非消耗型/自动续期订阅/非续期订阅)并随版本一起提交审核;订阅类必须提供隐私政策、使用条款、恢复购买入口。
- Flutter 集成:
in_app_purchase官方插件,沙盒账号务必在 TestFlight 完整验证订阅、恢复购买。
16.5 税务、收款与协议(重要,否则无法上架/收款)
- 协议、税务和银行业务(Agreements, Tax, and Banking):接受 Paid Apps Schedule 协议(即使只做免费 App + 内购也要签)。
- 填写收款银行账户(支持境内银行卡结汇,苹果按月打款,满最低起付额)。
- 税务表单:中国区 App 销售主要涉及美国区税务,个人填写 W-8BEN(非美国居民个人税收优惠表,线上问卷形式完成);按中美协定,App Store 销售版税通常可享受优惠预扣税率,按问卷如实填写即可。
十七、提交审核与审核流程
17.1 提交步骤
- 版本页关联处理完成的构建版本。
- 确认出口合规(已加 Info.plist 键则自动跳过询问)、广告标识符(IDFA)声明:用了就选 Yes 并说明用途(只能选广告/归因/App 内功能对应的合法选项)。
- 发布方式二选一:
- 自动发布(Automatically release):审核通过立即上架。
- 手动发布(Manually release):推荐首次使用,审核通过后自己在后台点发布。
- 还可选分阶段发布(通过后按 7 天灰度比例推送)。
- 点 添加以供审核 → 提交审核(Submit for Review)。
17.2 状态流转
异常分支:
- 元数据被拒(Metadata Rejected):不用改包,后台改完文字/截图直接回复即可,较快。
- 二进制被拒(Binary Rejected):必须改代码重新构建、递增 Build 号上传。
- 无效二进制(Invalid Binary):上传处理阶段就被拦下,按邮件 ITMS 错误修复。
十八、常见审核被拒原因与对策
| 条款 | 典型原因 | 对策 |
|---|---|---|
| 2.1 App 完整性 | 崩溃、白屏、演示账号登录不了、功能没做完、支付失败 | 真机+TestFlight 完整回归;提供有效演示账号与详细测试步骤 |
| 2.3 元数据准确 | 截图含安卓状态栏/价格信息;描述提到其他平台;隐藏功能 | 截图全用模拟器/真机 iOS 界面;不出现"安卓""Google Play"等字样 |
| 2.3.1 / 4.2 最低功能 | 套壳网页、功能过于简单、启动屏当广告页 | 增加原生能力(推送、本地存储、分享、Widget);网页壳要有原生增值;丰富内容 |
| 3.1.1 IAP | 数字内容用了支付宝/微信/Stripe;引导外部支付;无"恢复购买" | 数字商品一律走 StoreKit IAP;实物/线下才可第三方支付;补"恢复购买"按钮 |
| 4.0 设计 / 4.3 垃圾应用 | 与已有 App 高度雷同、模板批量、UI 像网页 | 差异化功能与视觉;使用规范控件与导航;避免纯 WebView |
| 5.1.1 数据收集与存储 | 无隐私政策链接、权限用途不清、未提供注销入口、强制注册才能用 | 补隐私政策 URL、Info.plist 文案、账号注销入口;尽量允许游客浏览 |
| 5.1.2 第三方数据分析/IDFA | 用 IDFA 却没有 ATT 弹窗或用途勾选错误 | 集成 AppTrackingTransparency 弹窗,上架时准确声明追踪用途;不用 IDFA 就声明 No |
| ITMS-91053 | 缺隐私清单 Required Reason API 声明 | 补 PrivacyInfo.xcprivacy;升级不合规 SDK |
| Guideline 1.2 / 5.1.4(v) | UGC 无举报/拉黑机制、无内容审核、无 EULA 冲突处理 | UGC App 必须有:举报入口、拉黑、内容过滤、24 小时联系机制 |
| 删号条款 5.1.1(v) | 只能注册不能注销 | App 内提供发起账号删除(不仅是退出登录),并删除关联数据 |
| 中国区备案 | 国区销售但未填 ICP 备案号;类目个人主体不允许 | 完成 App 备案并回填;受限类目移除国区销售范围或调整业务 |
| Sign in with Apple | 提供微信/Google 登录却没有 Sign in with Apple | 只要有第三方登录,就必须同时提供 Sign in with Apple(4.8) |
被拒后怎么做
- 在 Resolution Center 完整阅读拒审原文(含设备、截图、操作步骤)。
- 判定类型:能解释清楚的(如审核员漏看了功能)→ 礼貌回复说明并标注入口位置;确实有问题 → 修复后递增 Build 号重新上传。
- 回复时附上新版本号、修改点清单、演示视频链接,必要时请求电话沟通。
- 同一问题反复被拒且认为误判,可在 Resolution Center 请求 Expedited Review(加急审核)(理由充分时,如线上严重 Bug)或走申诉(App Review Appeal)。
十九、发布后的版本迭代与运营
19.1 发新版本
- pubspec.yaml 提升 version(如 1.0.0 → 1.0.1),Xcode Version 同步;Build 号递增。
flutter build ipa→ 上传 → App Store Connect 新建版本号(或自动出现该版本)→ 关联构建 → 写"新功能"日志 → 提交审核。- 修复审核期间,线上旧版不受影响。
19.2 分阶段发布(Phased Release)
审核通过后可开启 7 天分阶段更新:第 1 天 1%、第 2 天 2%、第 3 天 5%、第 4 天 10%、第 5 天 20%、第 6 天 50%、第 7 天 100%。用户也可在 TestFlight/商店手动提前更新。发现严重问题可暂停最多 30 天,但无法回滚二进制——只能加急提新版,所以灰度期要盯紧崩溃率。
19.3 运营与监控
崩溃监控
Xcode Organizer → Crashes(免费、需上传符号);Flutter 侧可用 Sentry、Firebase Crashlytics、Bugly。
数据分析
App Store Connect 自带 App 分析(展示、下载、留存、收入);可接 Firebase/自建埋点。
评价管理
回复用户评论;用 requestReview(StoreKit 2 API)在合适时机弹评分,每版本限次。
紧急下架
价格与销售范围 → 取消全部区域可立即下架;修好后重新勾选恢复。
账号续订
$99 到期前续费;过期后 App 会被下架且无法更新。
证书与 Profile
Distribution 证书有效期约 1 年,过期不影响已上架 App,但影响新包上传;推送证书过期会导致推送失败。
19.4 合规跟进
- 关注苹果每年 WWDC 后的审核指南更新与新邮件通知(隐私清单、SDK 签名等近年均为强制项)。
- 第三方 SDK 升级后回归 TestFlight(尤其微信、支付、统计类)。
- 国区备案信息(名称、域名、服务内容)有变更要及时做变更备案,避免被通报下架。
二十、附录:自动化打包(CI/CD)与常用命令速查
20.1 常见 CI 方案
Codemagic
Flutter 官方深度合作,零配置模板多,免费额度够个人项目;支持自动签名或上传 API Key/certificate。
GitHub Actions
macOS runner + subosito/flutter-action,用 Codemagic CLI 的 app-store-connect 上传,免费时长有限但够用。
自建 / 其他
Mac mini、MacStadium、阿里云 Mac;Fastlane match + pilot 管理证书与上传。
20.2 用 Codemagic CLI 在任意 CI 上传(免 2FA)
# App Store Connect → 用户与访问 → 密钥 → 生成 API Key
# 需要:Issuer ID、Key ID、AuthKey_XXXXXX.p8 文件
pip3 install codemagic-cli-tools
app-store-connect fetch-signing-files com.yourname.myapp \
--platform IOS --type IOS_APP_STORE --create
app-store-connect publish build/ios/ipa/*.ipa \
--issuer-id xxx --key-id xxx --private-key @file:AuthKey_xxx.p8
20.3 命令速查
| 用途 | 命令 |
|---|---|
| 环境检查 | flutter doctor -v |
| 清理/装依赖 | flutter clean && flutter pub get && cd ios && pod install --repo-update |
| 真机 Release 运行 | flutter run --release |
| 构建可测试的 .app | flutter build ios --release |
| 构建 IPA | flutter build ipa --release |
| 构建 IPA + 指定导出配置 | flutter build ipa --export-options-plist=ios/ExportOptions.plist |
| 混淆打包 | flutter build ipa --obfuscate --split-debug-info=build/symbols |
| 指定版本号 | flutter build ipa --build-name=1.0.1 --build-number=12 |
| 更新图标/启动屏 | dart run flutter_launcher_icons / dart run flutter_native_splash:create |
| 命令行上传 | xcrun altool --upload-app -f xx.ipa -t ios -u ... -p @keychain:... |
20.4 首次上架最终 Checklist
- Apple Developer 个人账号有效($99 已付)
- Bundle ID 已注册且与工程一致
- App Store Connect 已新建 App 记录
- Version / Build 号已设置
- Personal Team 自动签名通过
- 1024 图标(无 alpha)与启动屏就绪
- 所有 Info.plist 权限文案完整
- PrivacyInfo.xcprivacy 已添加
- 隐私政策 URL 可公开访问
- App 隐私问卷如实填写
- ATT 弹窗(如涉及 IDFA)
- 国区 ICP 备案号已回填(如售国区)
- Sign in with Apple(如有第三方登录)
- 账号注销入口(如有账号体系)
- IAP 沙盒/TestFlight 验证 + 恢复购买
- 付费协议、W-8BEN、银行信息已完成
- 1320×2868 截图与商店文案就绪
- 演示账号与审核备注已填写