安装说明

两端能走的路不一样,先认清自己手上是哪台设备:Android 可以直接从网页装; iPhone 装不了「点开就装」的包,要么用数据线连一次 Mac,要么这台设备的 UDID 已经注册进分发渠道。

Android(家长手机 / 孩子平板)

  1. 扫下面的码,或在本页顶部的「本站备用包」里选最新的 .apk 下载。
  2. 点开下载好的文件,系统问「是否允许安装未知来源应用」时选允许(只对这一次)。
  3. 装完从桌面打开「嘉禾成长」。家长端用手机号登录,孩子端等家长签配对码。
扫描下载嘉禾成长最新 Android 安装包

本站直连的码,地址 https://xpa1.cn/android —— 它总是指向目录里最新的那个 apk。

开发环境的验证码固定是 123456(短信网关钉死的), 但手机号、发码限流、连错锁定都还是服务端真校验。正式包走蒲公英分发,见官网首页的二维码。

iPhone / iPad

iOS 只允许四种途径装上 App Store 之外的应用,本站能提供的是安装包本体, 不是「点开即装」的链接 —— 谁要说网页能直接装 iOS,那是企业证书签名,我们不那么干。

路线一:数据线 + Mac(内测用这条)

① 在这台 Mac 上跑 ./scripts/dev-ios-install.sh,它自己编 profile 包并装上, 装完在手机桌面点开就能用。

② 想先拿包再手工装:下载本站的 .zip,解压出 Runner.app,然后

unzip jiahe-ios-profile-*.zip
xcrun devicectl device install app \
  --device <UDID> Runner.app

UDID 用 xcrun devicectl list devices 看(真机是「8 位-16 位」那一串)。

路线二:已注册设备 / 分发平台

个人免费 Apple ID 签的包描述文件只保 7 天,且设备 UDID 必须先登记进证书; 超过就得重签重装。

蒲公英这类第三方分发能给出扫码安装的入口,但同样要求 UDID 已注册,且要开发者账号; TestFlight 则要归档上传。这两条本仓库还没接,接之前 iOS 内测只走路线一。

装完第一次打开,会撞两扇系统窗

  1. 「不受信任的开发者」:设置 → 通用 → VPN 与设备管理 → 开发者 App → 信任。 只有用数据线新装的那台机器上会出现。
  2. 「允许查找本地网络中的设备」:连开发机/NAS 上的服务端与 Casdoor 时必须点允许。 点了「不允许」就只会看到一句「网络不太顺」,而且这个授权活不过重装 —— 每次重装都要重新点一次。

两个小提示:从桌面点开 debug 包只会看到一句 「debug mode Flutter apps can only be launched from Flutter tooling」,这是 iOS 14+ 的限制, 不是包装坏了 —— 人肉走查请装 profile 包(左下角带 PROFILE 水印条,属正常)。

profile 包和 flutter run 的 debug 包是同一个 bundle id,真机上后装的覆盖先装的。

本站现有安装包

文件名类型大小打包时间
jiahe-android-debug-394ec66-202610280028.apk Android 233.0 MB 2026-10-28 08:33
jiahe-android-debug-3ba45eb-202610270105.apk Android 165.2 MB 2026-10-27 09:08
jiahe-android-debug-2f58b33-202610261331.apk Android 165.2 MB 2026-10-26 21:34
jiahe-ios-profile-02128e8-202610220103.zip iOS 压缩包 13.7 MB 2026-10-22 09:09
jiahe-android-debug-02128e8-202610220103.apk Android 199.4 MB 2026-10-22 09:07

包是手工放进服务器目录的备用件,正式分发仍以蒲公英为准。要一次性产出这两个包: bash scripts/dev-site-packages.sh