出包操作指南(全中文 · 照着点)

说明:iOS 和鸿蒙都强制要求用你本人的开发者账号签名才能装进真机, 签名的私钥在你的账号里,任何人都无法替你代签。所以"出包"的最后一步 必须在【你的设备 + 你的账号】上完成。下面把这一步压到最短、且全中文。

一、鸿蒙 hap(推荐先做,你自己的 Windows 就能走通,不需要 Mac)

第 0 步:准备华为开发者账号(免费)

  1. 打开 developer.huawei.com/consumer/cn/,点右上角「注册」,用手机号/邮箱注册。
  2. 登录后做实名认证(设置 → 实名认证,填身份证,免费)。这一步是为了让 DevEco 能给你生成调试证书。

第 1 步:安装 DevEco Studio(Windows 版,全中文)

  1. 下载:华为官网搜「DevEco Studio 下载」,选 Windows 版。
  2. 双击安装,一路「下一步」;语言选「中文(简体)」。装完首次启动也会提示选中文。

第 2 步:打开工程

第 3 步:登录你的华为账号

第 4 步:首次运行(自动签名)

  1. 手机:设置 → 关于手机 → 连点「版本号」7 下开启开发者模式; 再进 设置 → 系统和更新 → 开发人员选项 → 打开 USB 调试;USB 连上电脑。
  2. DevEco 右上角设备下拉里选你的手机;点绿色 ▶「运行」。
  3. 第一次会弹「签名」对话框 → 勾选 自动生成签名(Automatically generate signature) → 确定。 DevEco 会用你的账号自动生成调试证书,之后不再弹
  4. 稍等编译完成,手机桌面出现「公文流转」图标,直接用。
想拿到 .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 里点鼠标)

  1. 打开 GitHub Desktop(已登录)。
  2. 顶部菜单「File(文件)」→「Add Local Repository…(添加本地仓库)」。
  3. 点「Choose…(选择…)」选文件夹 FlowOA-iOS(路径 D:\OA\oa\wenjianliuzhuan\backups\FlowOA-iOS)。
    若提示"这不是 Git 仓库",点 「Create a Repository(创建仓库)」去掉"Initialize with a README"勾选,点 Create。
  4. 左下角 Summary 填 FlowOA iOS shell,点 「Commit to main」
  5. 点顶部 「Publish repository(发布仓库)」:Name 填 FlowOA-iOS,保持默认(私有也可),点 Publish
  6. 推送完成后,云端自动开始编译(约 3 分钟,无需任何操作)。

第 2 步:下载 ipa(只进一次网页)

  1. 浏览器打开 github.com → 进你的 FlowOA-iOS 仓库 → 点 「Actions」 标签。
  2. 看一条记录:黄色圆点 → 变绿色对勾 = 编译成功(约 3 分钟)。
  3. 点进那条记录 → 拉到底部 「Artifacts」 区 → 点 FlowOA-unsigned-ipa 下载(是个 zip)。
  4. 解压得到 FlowOA-unsigned.ipa

第 3 步:用爱思助手(全中文,需你自己的 Apple ID)装到 iPhone

  1. 电脑装「爱思助手」(官网,全中文)→ 连上 iPhone(先点「信任」)。
  2. 爱思助手 →「工具箱」→「IPA 签名/安装」→ 导入刚解压的 FlowOA-unsigned.ipa → 用你自己的 Apple ID 做签名(免费)→ 安装到手机。
  3. 手机:设置 → 通用 → VPN与设备管理 → 信任你的 Apple ID 证书 → 桌面出「公文流转」。
说明:免费 Apple ID 签名有效期 7 天,过期在爱思助手里重新签名一次即可。 若借到 Mac,用 Xcode(可切简体中文)连手机点「运行」一键装,更省事。

三、为什么我不能"直接发你装好的包"