'''BeeWare 走的是和 Flet 不一样的路子：它的 Toga 用的是各平台的原生控件，iOS 上就是真的 UIKit，不套 Flutter 或者 WebView。打包工具叫 Briefcase，briefcase create iOS 会生成一个 Xcode 工程，briefcase build iOS 编译，briefcase package iOS 出包。
因为最终还是 Xcode 在干活，这几条命令都得在 macOS 上跑。Windows 上 Briefcase 只能处理 Windows/Android 那些目标。这一步没有变通。
我的分工是：Python 代码在 Windows 上写，iOS 出包丢给 macOS 机器；证书、描述文件、IPA 上传用开心上架（AppUploader）在 Windows 上处理。
先说结论：哪一步真绕不开 Mac
| 环节 | 我实际怎么做的 |
|---|---|
| 注册 Bundle ID、签发证书、生成描述文件 | Windows 上做完 |
| 写 Python 代码 | Windows |
briefcase create / build / package iOS |
要 macOS + Xcode |
| 提交 App Store | Windows 上传 |
| 装到 iPhone 测试 | 扫码注册 UDID，再扫码装 |
说明一下：我用的签证书工具本身在 macOS 上也能用（网页版不挑系统，桌面客户端有 macOS 版）。表里"不需要 Mac"是指这一步不再需要 Xcode、钥匙串访问或 Transporter。
第一步：在 pyproject.toml 里定好 bundle
Briefcase 的配置全在 pyproject.toml 里。iOS 的包标识由 bundle 加 app 名拼出来：
[tool.briefcase]
project_name = "My App"
bundle = "com.yourcompany"
version = "1.0.0"
[tool.briefcase.app.myapp]
formal_name = "My App"这样最终的 Bundle Identifier 就是 com.yourcompany.myapp。拼出来的这个值要和 Apple 注册的 Bundle ID、描述文件绑定的 App ID 完全一致——注意是拼出来的结果，不是 bundle 字段本身，这点第一次配的时候容易搞错。
第二步：在 Windows 上签出证书和描述文件
注册 Bundle ID：开心上架的「Bundle ID」页面点「新建 Bundle ID」，Identifier 填拼出来的那个完整标识。创建后改不了，所以先把 bundle 和 app 名定下来再注册。
签发证书：「证书」页面点「新建证书」，上架选发布签名证书，真机调试选开发签名证书。绑定上面的 Bundle ID，填名称邮箱，设一个 .p12 保护密码——导入 Mac 钥匙串时要输，服务器不保存它，忘了只能吊销重签。勾上「使用开心上架服务同步证书」的话，出包用的那台 Mac 直接登录下载就行。
生成描述文件：「描述文件」页面点「新建描述文件」，上架选 App Store 类型，内测选 Ad Hoc 并勾上测试设备，关联上面的 Bundle ID 和证书，提交后下载 .mobileprovision。
私钥和 CSR 都在你本机生成后封进 .p12，不用在 Mac 上走「钥匙串访问 → 从证书颁发机构请求证书」那一套——对只写 Python、平时压根不碰 Xcode 的人来说，这一步省下来挺值的。
第三步：在 macOS 上导入签名材料
security import dist.p12 -k ~/Library/Keychains/login.keychain-db -P "你的p12密码" -T /usr/bin/codesign
mkdir -p ~/Library/MobileDevice/Provisioning\ Profiles
cp AppStore.mobileprovision ~/Library/MobileDevice/Provisioning\ Profiles/第四步：生成工程、编译、出包
在 macOS 上依次跑：
briefcase create iOS
briefcase build iOS
briefcase package iOSbriefcase create iOS 会在 build/ 下生成一个 Xcode 工程。package 这一步会做签名，Briefcase 会让你选用哪个签名身份（identity），也可以用参数直接指定，具体参数名以 briefcase package iOS --help 输出的为准——Briefcase 各版本的命令行选项变动比较频繁。
签名这块有个实操建议：别让 Xcode 自动管理签名。生成的工程里如果开着 Automatically manage signing，Xcode 会跑去 Apple 那边替你申请新证书，而同类型证书一共就 3 个名额，几轮下来会占满。用 Xcode 打开生成的工程，把它关掉，手动选第二步那套证书和描述文件，再回来跑 briefcase package iOS。
改了 pyproject.toml 里跟原生工程相关的配置之后，记得重新 briefcase create iOS（或者带 -r 更新），不然生成的工程里还是旧配置。
第五步：把 IPA 传上去
拿到包之后就跟 Mac 无关了。我一般先在开心上架的「文件&提交」页面把 IPA 打开看一眼签名信息——Bundle ID 是不是拼出来的那个、描述文件类型对不对、证书有没有过期，确认了再点「提交 App Store」。
命令行版本，在 Windows 上直接跑：
appuploader-cli upload -f MyApp.ipa -u dev@example.com -p abcd-efgh-ijkl-mnop-p 是 Apple 生成的 App 专用密码（xxxx-xxxx-xxxx-xxxx），不是 Apple ID 登录密码。也可以用 API 密钥：
appuploader-cli upload -f MyApp.ipa --api-key <KeyID> --api-issuer <IssuerID> --private-key Auth_Key.p8密钥方式只收 .ipa，且 App 要先在 App Store Connect 里建好。
第六步：发内测包
「设备」页面点「注册设备」，二维码发出去让人扫上报 UDID（一年 100 台，免费账号 3 台）。回描述文件那边点「重建」，生成一份包含这些设备的 Ad Hoc 描述文件，拷到 Mac 上替换掉旧的。
重新 package 一次，然后在「文件&提交」页面生成二维码让人扫码装。
写在最后
BeeWare 这条路对纯 Python 背景的人最友好的地方，是你几乎不用学 Objective-C 或 Swift。但签名这一环是躲不掉的 Apple 规则，和你用什么语言无关——把证书和描述文件在 Windows 上准备好，Mac 那边就只剩三条 briefcase 命令。'''
