个人开发者使用 Flutter 开发 App
并上架 App Store 完整流程指南

面向独立开发者:环境准备 → 账号注册 → 项目配置 → 证书签名 → 打包上传 → TestFlight → 审核上架 → 后续运营,全链路 20 章。

Flutter 3.3x+ Xcode 16 iOS 13+ 隐私清单 ICP 备案 2026-10 更新
$99/年
个人开发者账号
1~3 天
典型审核时长
20 章
全流程章节

一、全流程总览(一张图看懂)

0
硬件/软件准备
Mac(macOS)+ Xcode 16 + Flutter SDK(stable)+ 开启双重认证的 Apple ID
1
注册 Apple Developer Program 个人账号(US$99/年)
通常即时 ~ 3 个工作日,可能要求线上人脸核验
2
Flutter 开发
flutter create → 编码 → 真机调试
3
开发者后台注册 Bundle ID(App ID)
并按实际开启 Capabilities(推送、Sign in with Apple 等)
4
App Store Connect 新建 App 记录
填写名称、语言、Bundle ID、SKU 等基础信息
5
Xcode 工程配置
Display Name / 版本号 / Personal Team 自动签名 / 权限文案 / 图标 / 启动屏 / Deployment Target / 隐私清单
6
准备合规材料
隐私政策 URL、App 隐私问卷;上架国区还需 ICP 备案号
7
打包
flutter build ipa --release
8
上传
Xcode Organizer / Transporter / altool 三选一
9
等待苹果处理构建
留意邮件(隐私清单等合规警告)→ 构建版本出现在 TestFlight
10
TestFlight 测试(强烈建议)
内部自测 + 外部邀请测试,提前暴露内购、权限、崩溃问题
11
填写商店资料并提交审核
截图 / 描述 / 关键词 / 分级 / 审核账号 → Submit for Review
12
等待审核(通常 1~3 天)
通过 → 发布;被拒 → 按解决方案中心意见修改重提
13
自动或手动发布上架 🎉
建议首次选手动发布,审核通过后自己控制上线时间

关键时间预期(首次上架)

事项耗时(典型)
个人开发者账号注册审核即时 ~ 3 个工作日(可能人脸核验)
ICP 备案(中国大陆,个人主体)约 1~3 周(依托云厂商免费办理)
上传后构建处理5~30 分钟(邮件通知结果)
TestFlight 外部测试首版审核通常 1 天内(首次较严)
App 审核 Waiting for Review1~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 个人账号要点与可上架范围

三、第一步:注册 Apple Developer Program 账号

1
登录开发者网站
用开启双重认证的 Apple ID 登录 developer.apple.com
2
进入报名入口
Account → 加入 Apple Developer Program;更推荐直接在 Apple Developer App 内报名,通常更快、支持人脸核验
3
实体类型选择「个人 / Individual / Sole Proprietor」
姓氏、名字必须填写身份证上的法定姓名(拼音),切勿使用昵称、英文名或公司名,姓名不一致会延误审核
4
支付 US$99 年费
支持 Visa/MasterCard 等双币/外币信用卡
5
等待审核
通常即时 ~ 1~3 个工作日,期间可能要求完成线上人脸核验
6
开通两个后台
developer.apple.com/account(证书、App ID、设备)与 appstoreconnect.apple.com(App 管理、TestFlight、审核提交)
个人账号的注册人即 App 的唯一负责人和收款人,证书、协议、税务、收款都与你的身份绑定,务必使用自己长期使用、不会废弃的 Apple ID。

四、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

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 完全一致。

2
新建标识
点 + → 选择 App IDs → App 类型选 App
3
填写名称与 ID
Description 填英文描述(如 My Productivity App,不能带 * 等特殊字符);Bundle ID 选 Explicit 填 com.yourname.myapp,不要用通配符 Wildcard(内购/推送不支持)
4
勾选 Capabilities
Push Notifications、Sign In with Apple(用了第三方登录就必须开)、Associated Domains、App Groups、iCloud、In-App Purchase(默认含)等——只勾真正使用的,多勾可能触发额外审核
5
Continue → Register 完成
之后在 Xcode 自动签名时会自动同步这些能力

六、在 App Store Connect 创建应用记录

  1. 打开 App Store Connect → 我的 App(My Apps) → 左上角 + → 新建 App(New App)。
  2. 填写表单:
    • 平台:勾选 iOS(Flutter 不支持 tvOS,不勾)。
    • 名称:App Store 显示名,全店唯一,后期可改(每次改需随版本审核)。
    • 主要语言:简体中文 / English。
    • Bundle ID:下拉选择上一步注册的 ID。
    • SKU:内部管理用任意唯一字符串,如 myapp001,用户不可见。
    • 用户访问权限:全权限。
  3. 创建后进入 App 页面,在 App 信息 / App Information 中确认 Bundle ID、副标题、类别等。
个人账号下所有 App 都归你本人管理,没有团队成员概念;SKU 仅自己可见,随便填一个稳定的内部编号即可。

七、配置 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 自动签名(推荐)

  1. Signing & Capabilities → 勾选 Automatically manage signing。
  2. Team 选择你本人的 Personal Team(你的名字)。
  3. Xcode 会自动创建/维护 Development 证书、Provisioning Profile。
  4. Capabilities 点 + Capability,与开发者后台保持一致(Push、Sign in with Apple 等)。

7.3 手动签名(CI 自动打包才需要,本地开发可跳过)

证书私钥务必备份:导出 .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 IDNSFaceIDUsageDescription用于快速解锁应用

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 其他配置

八、配置应用图标与启动屏

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:

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
启动屏只能放品牌 Logo/底色,禁止放广告、活动文案、"跳过"按钮(审核 4.2 / 2.3.1 高概率被拒);也不要做成长时间假启动页。

九、隐私清单与 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)

  1. Xcode 菜单 File → New → File… 搜索 Property List,命名为 PrivacyInfo.xcprivacy,Target 勾选 Runner。
  2. 按上表填写四项键;常用的 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>
Reason 代码(如 C617.1、CA92.1、E174.1、35F9.1 等)必须从 Apple 官方文档 Describing use of required reason API 按真实用途选取,不要照抄。Flutter/插件读取 UserDefaults、文件时间戳很常见。

9.3 第三方 SDK 缺失隐私清单怎么办

十、完善隐私政策与「App 隐私」标签

10.1 隐私政策

没有隐私政策 URL 无法提审(Guideline 5.1.1)。需要一个公开可访问的 HTTPS 网页链接(托管在 GitHub Pages、自己的博客、Vercel、腾讯云 COS 等均可)。内容至少包含:

"三方一致"原则:隐私政策、App 隐私问卷、App 内实际行为三者必须一致——问卷里说不收集,代码却偷偷取位置/IDFA,会被 5.1.1/2.1 拒绝甚至下架。

10.2 App 隐私(App Store Connect 问卷)

  1. App Store Connect → 对应 App → App 隐私。
  2. 按真实情况声明收集的数据类型与用途(Analytics、App Functionality 等)。
  3. 声明是否用于追踪(Tracking):若用了 IDFA/广告归因必须选 Yes,并集成 ATT 弹窗。
  4. 数据是否与用户身份关联(Linked to User)、是否用于追踪。

10.3 建议的首次启动合规弹窗

十一、中国大陆 ICP 备案(仅国区上架需要)

2023 年 9 月起,工信部《工业和信息化部关于开展移动互联网应用程序备案工作的通知》要求:面向中国大陆用户提供信息服务的 App 必须完成 ICP 备案,Apple 已在 App Store Connect 中国区强制校验备案号。仅上架美区/其他海外区可跳过本章。

11.1 个人主体能不能备案?

可以。个人凭身份证即可办理,无需营业执照。但部分类目(新闻、出版、广播、网络文化、游戏等)个人主体不予备案,纯工具/效率类一般可行。

11.2 办理路径(以云厂商为例,免费)

1
准备材料
身份证(本人)、手机号、一个已实名认证的域名、一台该云厂商的中国大陆服务器(最低配即可,或支持备案授权码的轻量产品)
2
提交 App 备案
在云厂商备案系统选择 App 备案(阿里云/腾讯云控制台均有入口),填写软件名称、服务类型、Bundle ID、平台(iOS/安卓)、个人身份信息,完成 App 负责人人脸核验
3
管局审核
云厂商初审(1~3 天)→ 通信管理局审核(通常 3~20 个工作日,各省不同)
4
取得备案号并回填
获取格式如 沪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

成功后产物:

若未配置 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(新手推荐)

  1. open ios/Runner.xcworkspace
  2. 菜单 Product → Archive(设备选 Any iOS Device,模拟器时菜单不可用)。
  3. Archive 完成自动打开 Organizer → Distribute App → App Store Connect → Upload,默认选项一路 Next。

14.2 方式二:Transporter(最稳,推荐大文件/弱网)

  1. Mac App Store 安装 Transporter。
  2. 用 App Store Connect 账号登录(或生成 App 专用密码/API Key)。
  3. 把 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 上传之后

上传方式适用场景特点
Xcode Organizer本地手动打包上传图形化、自动签名友好
Transporter已有 IPA / 网络不稳支持断点续传、日志清晰,官方推荐
altool / API KeyCI/CD 自动化可脚本化,新版推荐 App Store Connect API

十五、TestFlight 测试

15.1 内部测试(App Store Connect 用户)

个人账号只有你自己(账号持有人即全部内部成员,无法在后台添加其他团队成员):构建处理完成后你本人在 TestFlight App 里即可安装,无需 Beta 审核,构建最多保留 90 天。

15.2 外部测试(朋友、公测用户,最多 1 万人)

  1. TestFlight → 外部测试群组 → 新建测试员:填邮箱邀请,或开启公开链接(Public Link),任何人点链接即可加入(可设人数上限)。
  2. 首个外部构建版本必须经过 Beta App Review(通常几小时~1 天,标准接近正式审核);后续小版本若未大改常可免审。
  3. 必须填写测试信息(测试说明、演示账号),以及 Beta 版隐私信息。
  4. 测试员通过 Apple 官方 TestFlight App 安装,每个构建版本有效期 90 天。
  5. 崩溃与反馈可在 TestFlight → 反馈、Xcode Organizer → Crashes 中查看。
建议至少让 2~3 位"小白用户"用外部测试跑一遍:权限弹窗、内购、弱网、首次安装流程的问题,在这一步暴露比正式审核被拒成本低得多。

十六、填写商店资料(截图/描述/分级等)

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 文本信息

字段字符限制建议
名称 Name30 字符品牌词+核心功能,不可堆砌竞品词
副标题 Subtitle30 字符一句话卖点,可随版本改
推广文本 Promotional Text170 字符可随时更新无需审核
描述 Description4000 字符分功能点、更新日志、联系方式;避免提到安卓/其他平台
关键词 Keywords100 字符英文逗号分隔,不要重复 App 名、不要用竞品商标
支持网址 / 营销网址URL支持网址必填且必须能正常访问
版权如 2026 Your Name个人开发者填本人姓名或自己持有的品牌

16.3 分级、审核信息与协议

16.4 定价与内购(IAP)

16.5 税务、收款与协议(重要,否则无法上架/收款)

  1. 协议、税务和银行业务(Agreements, Tax, and Banking):接受 Paid Apps Schedule 协议(即使只做免费 App + 内购也要签)。
  2. 填写收款银行账户(支持境内银行卡结汇,苹果按月打款,满最低起付额)。
  3. 税务表单:中国区 App 销售主要涉及美国区税务,个人填写 W-8BEN(非美国居民个人税收优惠表,线上问卷形式完成);按中美协定,App Store 销售版税通常可享受优惠预扣税率,按问卷如实填写即可。
未签署付费协议或税务/银行信息缺失,App 状态会停在"无法提交"或内购无法审核,务必在提审前处理完。

十七、提交审核与审核流程

17.1 提交步骤

  1. 版本页关联处理完成的构建版本。
  2. 确认出口合规(已加 Info.plist 键则自动跳过询问)、广告标识符(IDFA)声明:用了就选 Yes 并说明用途(只能选广告/归因/App 内功能对应的合法选项)。
  3. 发布方式二选一:
    • 自动发布(Automatically release):审核通过立即上架。
    • 手动发布(Manually release):推荐首次使用,审核通过后自己在后台点发布。
    • 还可选分阶段发布(通过后按 7 天灰度比例推送)。
  4. 点 添加以供审核 → 提交审核(Submit for Review)。

17.2 状态流转

准备提交 Prepare for Submission→ 等待审核 Waiting for Review→ 正在审核 In Review→ Pending Developer Release / 上架 Ready for Sale

异常分支:

被拒 Rejected→ 解决方案中心 Resolution Center 看原因→ 回复说明 / 修改后重新上传构建→ 再次提交(回到 Waiting)
可以通过 App Store Connect App(iPhone 上的官方应用)接收审核推送、回复拒审,响应速度直接影响过审时间。

十八、常见审核被拒原因与对策

条款典型原因对策
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)

被拒后怎么做

  1. 在 Resolution Center 完整阅读拒审原文(含设备、截图、操作步骤)。
  2. 判定类型:能解释清楚的(如审核员漏看了功能)→ 礼貌回复说明并标注入口位置;确实有问题 → 修复后递增 Build 号重新上传。
  3. 回复时附上新版本号、修改点清单、演示视频链接,必要时请求电话沟通。
  4. 同一问题反复被拒且认为误判,可在 Resolution Center 请求 Expedited Review(加急审核)(理由充分时,如线上严重 Bug)或走申诉(App Review Appeal)。

十九、发布后的版本迭代与运营

19.1 发新版本

  1. pubspec.yaml 提升 version(如 1.0.0 → 1.0.1),Xcode Version 同步;Build 号递增。
  2. flutter build ipa → 上传 → App Store Connect 新建版本号(或自动出现该版本)→ 关联构建 → 写"新功能"日志 → 提交审核。
  3. 修复审核期间,线上旧版不受影响。

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 合规跟进

二十、附录:自动化打包(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
构建可测试的 .appflutter build ios --release
构建 IPAflutter 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

20.5 参考资料