出包操作指南(全中文 · 照着点)
说明:iOS 和鸿蒙都强制要求用你本人的开发者账号签名 才能装进真机,
签名的私钥在你的账号里,任何人都无法替你代签。所以"出包"的最后一步
必须在【你的设备 + 你的账号】上完成。下面把这一步压到最短、且全中文。
一、鸿蒙 hap(推荐先做,你自己的 Windows 就能走通,不需要 Mac)
第 0 步:准备华为开发者账号(免费)
打开 developer.huawei.com/consumer/cn/,点右上角「注册」,用手机号/邮箱注册。
登录后做实名认证 (设置 → 实名认证,填身份证,免费)。这一步是为了让 DevEco 能给你生成调试证书。
第 1 步:安装 DevEco Studio(Windows 版,全中文)
下载:华为官网搜「DevEco Studio 下载」,选 Windows 版。
双击安装,一路「下一步」;语言选「中文(简体)」。装完首次启动也会提示选中文。
第 2 步:打开工程
启动 DevEco → 点「Open」(打开)→ 选文件夹 FlowOA-Harmony → 确定。
第 3 步:登录你的华为账号
DevEco 右上角点头像 / 或「设置 → Huawei Account」→ 登录(就是你第 0 步注册的账号)。
第 4 步:首次运行(自动签名)
手机:设置 → 关于手机 → 连点「版本号」7 下开启开发者模式 ;
再进 设置 → 系统和更新 → 开发人员选项 → 打开 USB 调试 ;USB 连上电脑。
DevEco 右上角设备下拉里选你的手机;点绿色 ▶「运行」。
第一次会弹「签名」对话框 → 勾选 自动生成签名(Automatically generate signature) → 确定。
DevEco 会用你的账号自动生成调试证书,之后不再弹 。
稍等编译完成,手机桌面出现「公文流转」图标,直接用。
想拿到 .hap 文件(不是直接装):菜单「Build → Build Hap(s)/APP(s) → Build Hap(s)」,
编译完在 entry/build/outputs/default/ 下拿到 FlowOA-default-signed.hap。
二、iOS ipa(无 Mac → GitHub Desktop 全中文 + 云端自动编译)
你已装 GitHub Desktop 并登录,这条路几乎不用看英文网页 。
代码推上去后云端自动开始编译 (不用点任何绿色按钮),约 3 分钟出包。
第 1 步:把工程发布到 GitHub(全在 Desktop 里点鼠标)
打开 GitHub Desktop(已登录)。
顶部菜单「File(文件)」→「Add Local Repository…(添加本地仓库)」。
点「Choose…(选择…)」选文件夹 FlowOA-iOS(路径 D:\OA\oa\wenjianliuzhuan\backups\FlowOA-iOS)。
若提示"这不是 Git 仓库",点 「Create a Repository(创建仓库)」 ,去掉 "Initialize with a README"勾选,点 Create。
左下角 Summary 填 FlowOA iOS shell,点 「Commit to main」 。
点顶部 「Publish repository(发布仓库)」 :Name 填 FlowOA-iOS,保持默认(私有也可),点 Publish 。
推送完成后,云端自动开始编译 (约 3 分钟,无需任何操作)。
第 2 步:下载 ipa(只进一次网页)
浏览器打开 github.com → 进你的 FlowOA-iOS 仓库 → 点 「Actions」 标签。
看一条记录:黄色圆点 → 变绿色对勾 = 编译成功(约 3 分钟)。
点进那条记录 → 拉到底部 「Artifacts」 区 → 点 FlowOA-unsigned-ipa 下载(是个 zip)。
解压得到 FlowOA-unsigned.ipa。
第 3 步:用爱思助手(全中文,需你自己的 Apple ID)装到 iPhone
电脑装「爱思助手」(官网,全中文)→ 连上 iPhone(先点「信任」)。
爱思助手 →「工具箱」→「IPA 签名/安装」→ 导入刚解压的 FlowOA-unsigned.ipa
→ 用你自己的 Apple ID 做签名(免费)→ 安装到手机。
手机:设置 → 通用 → VPN与设备管理 → 信任你的 Apple ID 证书 → 桌面出「公文流转」。
说明:免费 Apple ID 签名有效期 7 天 ,过期在爱思助手里重新签名一次即可。
若借到 Mac,用 Xcode(可切简体中文)连手机点「运行」一键装,更省事。
三、为什么我不能"直接发你装好的包"
真机安装 = 包里必须含你的账号签名 ;签名私钥只在你账号里,我无法获取,也无法代签。
安卓当初能直接出 apk,是因为沙箱自带 Android 工具链且签名用通用 keystore;
iOS/鸿蒙的工具链与厂商签名都不在我的环境里,所以最后一步必须你来。
以上两步,鸿蒙纯 Windows 中文即可;iOS 无 Mac 时需走上面的云端一键。
本指南对应的工程源码:FlowOA-Harmony(鸿蒙)、FlowOA-iOS(iOS)