1 看一下效果

2 主要流程

1、无边记

3、codex

4、一个苹果开发者账号

3 Codex 生成苹果 App 到上架教程

现用 codex 在本地验证，codex 会处理完之后进行测试，保证能跑通，然后到 xcode 实验，、真机测试，使用自己的开发者账号，然后好了就开始提交上传到 App Store Connect，并提交 Apple 审核。

3.1 当前项目关键信息

• 项目文件：HVACTools.xcodeproj
• Scheme：HVACTools
• App 名称：暖通专业公式换算速查
• Bundle Identifier：com.gkgy.hvactools2026
• 版本号：1.0
• Build 号：1
• 最低系统：iOS 17.0
• App 图标：HVACTools/Resources/Assets.xcassets/AppIcon.appiconset/AppIcon-1024.png
• 工程配置源文件：project.yml

如果修改 project.yml 后重新生成 Xcode 工程，执行：

1
xcodegen generate

注意：当前 project.yml 没有写 DEVELOPMENT_TEAM，但 HVACTools.xcodeproj 里已有 Team ID XXXXXX。如果以后每次 xcodegen generate 后签名配置丢失，可以把 Team ID 补进 project.yml 的 target settings。

3.2 准备 Apple 开发者账号

上架 App Store 需要加入 Apple Developer Program。Apple 官方当前说明是年费 99 USD，地区可用时会按本地货币计费。

准备项：

• Apple Account 已开启双重认证。
• 个人开发者：使用真实法定姓名注册，App Store 上会显示个人姓名作为销售方。
• 公司开发者：通常需要公司资料、公开可访问的网站和 D-U-N-S Number。
• 能登录 App Store Connect。

官方入口：

• Apple Developer Program 注册
• Apple Developer Program 会员说明

3.3 准备本机 Xcode 环境

先安装完整 Xcode，不要只装 Command Line Tools。当前机器执行 xcodebuild 时提示 active developer directory 是 /Library/Developer/CommandLineTools，所以需要切到完整 Xcode：

1
2
sudo xcode-select -s /Applications/Xcode.app/Contents/Developerxcodebuild -version

打开项目：

1
open HVACTools.xcodeproj

首次打开 Xcode 后，检查：

• Xcode 登录 Apple Developer 账号：Xcode > Settings > Accounts
• 选择左侧 HVACTools target。
• 打开 Signing & Capabilities。
• Team 选择你的开发者团队。
• Bundle Identifier 保持 com.gkgy.hvactools2026，除非 App Store Connect 提示已被占用。

3.4 本地运行和真机测试

模拟器运行：

1. 打开 HVACTools.xcodeproj。
2. 顶部 Scheme 选择 HVACTools。
3. 设备选择一个 iPhone Simulator。
4. 点击 Run。

真机运行：

1. 用数据线连接 iPhone，并在手机上点“信任此电脑”。
2. iPhone 打开开发者模式：设置 > 隐私与安全性 > 开发者模式。
3. Xcode 顶部设备选择你的 iPhone。
4. Signing & Capabilities 里确认 Team 已选择。
5. 点击 Run。

命令行测试可用下面命令，模拟器名称按你本机实际设备替换：

1
2
3
4
5
6
xcrun simctl list devices availablexcodebuild \  -project HVACTools.xcodeproj \  -scheme HVACTools \  -destination 'platform=iOS Simulator,name=iPhone 16 Pro' \  test

如果只想确认 Release 构建：

1
2
3
4
5
6
xcodebuild \  -project HVACTools.xcodeproj \  -scheme HVACTools \  -configuration Release \  -destination 'generic/platform=iOS' \  build

3.5 上架前自查清单

功能和内容：

• 主要计算功能能正常使用，没有明显崩溃。
• 单位、公式、结果文案准确。
• 没有测试文字、占位图、调试按钮。
• App 名称和图标与实际功能一致。

版本信息：

• MARKETING_VERSION 是用户看到的版本，例如 1.0
  。
• CURRENT_PROJECT_VERSION 是构建号，例如 1
  。
• 每次重新上传同一个版本时，Build 号必须递增，例如 2、3。

隐私和权限：

• 当前项目看起来是本地计算工具，没有登录、定位、相机、通讯录、广告 SDK 等功能。
• 如果确实不收集用户数据，App Store Connect 的 App Privacy 可以选择不收集数据。
• 如果以后加入统计、广告、登录、云同步、第三方 SDK，要重新填写隐私标签。
• 如果代码或第三方 SDK 使用 Apple 定义的 Required Reason API，需要添加 Privacy Manifest。

官方参考：

• App Privacy Details
• Required Reason API 说明

3.6 在 App Store Connect 创建 App 记录

在上传构建前，先创建 App 记录：

1. 打开 App Store Connect。
2. 进入 Apps。
3. 点击左上角 +。
4. 选择 New App。
5. 平台选择 iOS。
6. 填写 App 名称，例如 暖通专业公式换算速查。
7. Primary Language 选择中文或你计划首发的主要语言。
8. Bundle ID 选择 com.gkgy.hvactools2026。
9. SKU 填一个你自己内部识别用的唯一编号，例如 hvac-tools-ios-2026。
10. 创建 App。

官方说明：Add a new app

3.7 准备 App Store 页面资料

建议先准备这些内容：

• App 名称：暖通专业公式换算速查
• 副标题：例如 暖通计算、单位换算与常用参数速查
• 分类：工具、效率或参考，按实际定位选择。
• 关键词：暖通， HVAC， 公式， 单位换算， 风量， 冷量， 水流量， 风管
• 描述：说明它是面向暖通工程场景的计算和速查工具。
• 技术支持 URL：一个可访问网页，可用 GitHub Pages、个人网站或产品说明页。
• 隐私政策 URL：即使不收集数据，也建议提供一页简短隐私政策。
• 截图：至少准备 iPhone 截图。由于项目支持 iPad，也建议准备 iPad 截图。

截图获取方式：

1. 用模拟器运行 App。
2. 打开每个核心页面：计算、单位换算、参考速查。
3. 使用模拟器菜单 File > Save Screen 保存截图。
4. 在 App Store Connect 对应设备尺寸处上传。

3.8 Archive 并上传构建

推荐先用 Xcode 图形界面上传：

1. Xcode 顶部设备选择 Any iOS Device (arm64) 或 Any iOS Device。
2. 菜单选择 Product > Archive。
3. Archive 完成后会打开 Organizer。
4. 选中最新 archive。
5. 点击 Distribute App。
6. 选择 App Store Connect。
7. 选择 Upload。
8. Signing 选择自动管理签名。
9. 确认内容后点击 Upload。

官方说明：

• Upload an app to App Store Connect
• Distributing your app for beta testing and releases
• Upload builds

命令行 Archive：

1
2
3
4
5
6
7
xcodebuild \  -project HVACTools.xcodeproj \  -scheme HVACTools \  -configuration Release \  -destination 'generic/platform=iOS' \  -archivePath "$PWD/build/HVACTools.xcarchive" \  archive

命令行上传通常还需要 ExportOptions.plist、App Store Connect API Key 或 Xcode 登录态。首次上架建议先用 Xcode Organizer，排错成本更低。

3.9 TestFlight 测试

上传成功后，构建不会立刻出现，需要等待 Apple 处理。处理完成后：

1. App Store Connect 进入你的 App。
2. 打开 TestFlight。
3. 选择刚上传的 build。
4. 添加内部测试员。
5. 安装 TestFlight App，在真机上测试。

内部测试通过后，再考虑外部测试或直接提交 App Review。

3.10 填写隐私、价格和审核信息

App Store Connect 里至少需要完成：

• App Information： 分类、年龄分级等。
• Pricing and Availability： 价格和上架地区。
• App Privacy： 是否收集数据。
• App Review Information： 审核联系人、登录账号说明。如果 App 不需要登录，就写明无需登录。
• Version Information： 截图、描述、关键词、支持 URL、隐私政策 URL。

这个项目如果保持纯本地工具形态，审核备注可以写：

1
This app is a local HVAC calculation and unit conversion tool. It does not require login and does not collect user data.

中文说明可以写：

1
本 App 是本地暖通公式计算、单位换算和常用工程参数速查工具，不需要登录，不收集用户数据。

3.11 提交审核

完成资料后：

1. App Store Connect 进入当前版本页面。
2. 在 Build 区域选择已处理完成的构建。
3. 确认所有必填项没有红色错误。
4. 点击 Add for Review 或 Submit for Review。
5. 回答出口合规、广告标识符、内容权限等问题。
6. 提交后等待 Apple 审核。

常见被拒原因：

• 截图和实际 App 不一致。
• App 仍有崩溃或明显 bug。
• 隐私声明与实际 SDK 行为不一致。
• App 功能太少，像 demo 或空壳。
• 元数据夸大宣传、关键词堆砌。
• Support URL 或 Privacy Policy URL 无法访问。

审核规则官方入口：App Review Guidelines

3.12 通过审核后发布

提交审核时可以选择：

• 审核通过后自动发布。
• 手动发布。
• 定时发布。

第一次上架建议选择手动发布。审核通过后，再检查一次 App Store 页面、价格、地区和截图，然后手动发布。

3.13 后续版本更新流程

每次更新：

1. 修改代码。
2. 本地测试和真机测试。
3. 更新 MARKETING_VERSION 或只递增 CURRENT_PROJECT_VERSION。
4. Archive。
5. 上传新 build。
6. App Store Connect 创建新版本或选择当前版本的新 build。
7. 更新版本说明。
8. 提交审核。

只修 bug 时示例：

• MARKETING_VERSION: 1.0
• CURRENT_PROJECT_VERSION： 从 1 改成 2

有新功能时示例：

• MARKETING_VERSION： 从 1.0 改成 1.1
• CURRENT_PROJECT_VERSION： 继续递增，例如 3

3.14 本项目建议的首发文案

App 描述草稿：

1
2
3
4
5
6
7
8
暖通专业公式换算速查是一款面向暖通工程场景的本地工具 App，提供常用公式计算、单位换算和工程参考值速查。主要功能：- 显热冷量、所需风量、冷冻水流量、矩形风管风速、风机轴功率等常用计算- 温度、压力、风量、功率、长度、面积等常用单位换算- 常用工程值速查本 App 适合暖通设计、施工、运维和学习场景中的快速核算使用。

关键词草稿：

1
暖通,HVAC,公式,单位换算,风量,冷量,水流量,风管,工程计算,速查

审核备注草稿：

1
This app is a local HVAC calculation and unit conversion tool. It does not require login and does not collect user data.

3.15 一句话流程总览

准备开发者账号 -> 修好 Bundle ID 和签名 -> Xcode 真机测试 -> App Store Connect 创建 App 记录 -> 准备截图、描述、隐私和价格 -> Xcode Archive -> Upload 到 App Store Connect -> TestFlight 测试 -> 选择 build 提交审核 -> 审核通过后发布。

4 提示词和 codex 沟通信息

这下面的都是我的部分提示词，和你说话都差不多！ 忘说了 还有一个就是 app 的名字叫：暖通专业公式换算速查应用

4.1 架构还有点问题

1、最下面的菜单，公式、换算、速查、我的。四块来分类里面的符号备注要有含义说明

4.1.1 公式

按照分类通用 、 蒸汽侧、水侧、空气侧、设备侧通用：能量传递：显热公式蒸汽侧：涵盖饱和蒸汽安托万方程、理想气体公式、全热、显热、潜热

输配（风管、水管）：水侧：流体输配系统： 伯努利方程空气侧（用户端 风冷 风管）：压损公式：达西-威斯巴赫公式 (Darcy-Weisbach Equation)

设备侧：伯努利方程 (Bernoulli’s Equation)、静态平衡阀涉及公式

公式后面留空，可以再添加

4.1.2 换算

要求简单换算留下制冷量的换算能效比压力和扬程之间的换算温度转换 摄氏度和华氏度

4.1.3 速查

速查里面有热焓表（饱和蒸汽或过热蒸汽）冷吨和 kw 的换算不同房间类型的温度设定重要图集的编号

4.1.4 我的

包含登录（微信登录）数据精度：可以设定不同的精度 3 位小数分享应用反馈意见

这版很好我已经 git 了一下作为 version 第一版 ，第二版我想要更好，有几个问题需要你改进一下1、app 的名字和图标没有 名字我想起个利于 seo 的叫：暖通专业公式换算速查应用，如果字太多了，就删掉应用两个字2、里面的公式展示效果不太好，文字方面都很好不用改。公式我希望类似我截图的效果，或者苹果风格的，再次强调文字部分不用动，只改公式展示效果公式的符号旁边可以输入数字，最下面有个计算，点击可以得到结果。当然最好有个默认的符合实际的默认值3、换算页面 里面的符号没有说明，可能别人不懂符号的含义4、速查页面：不要 10 RT 转换为 kw 的，这个类比也知道怎么算。 可以增加 空调匹速查页面也缺少符号的说明，符号代表的含义房间温度里面的 K 代表什么？如果是温度，最好弄成摄氏度 ℃ ，符合国人的5、我的里面有个数据精度，我改为 4 位的时候有的数据不是 4 位数反馈意见里面可以放入我的邮箱 gkgy@qq.com 点击反馈意见就可以切换到邮箱发送的界面，可以弹出其他邮箱 app 或者怎么弄，你再看看我的页面再加入隐私政策 、用户服务协议。

还有两个问题1、图标我想用飞机和冷却塔组合的形式弄！2、我的页面：反馈意见那个不太好，不行就写个内容吧，就说如果有想法或者问题可以反馈我的邮箱： gkgy@qq.com3、计算的那个我希望公式每个参数都可以留空，点击计算可以得到任意留空的结果！这样只要留一个未知数，就可以利用其他参数得到结果

还有几个问题1、我的 微信登录我希望可以使用各自的微信刷二维码登录，同时收集登录人员的账号信息 微信 sdk2、