安装说明
两端能走的路不一样,先认清自己手上是哪台设备:Android 可以直接从网页装;
iPhone 装不了「点开就装」的包,要么用数据线连一次 Mac,要么这台设备的 UDID 已经注册进分发渠道。
Android(家长手机 / 孩子平板)
- 扫下面的码,或在本页顶部的「本站备用包」里选最新的
.apk 下载。
- 点开下载好的文件,系统问「是否允许安装未知来源应用」时选允许(只对这一次)。
- 装完从桌面打开「嘉禾成长」。家长端用手机号登录,孩子端等家长签配对码。
本站直连的码,地址 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 内测只走路线一。
装完第一次打开,会撞两扇系统窗
- 「不受信任的开发者」:设置 → 通用 → VPN 与设备管理 → 开发者 App → 信任。
只有用数据线新装的那台机器上会出现。
- 「允许查找本地网络中的设备」:连开发机/NAS 上的服务端与 Casdoor 时必须点允许。
点了「不允许」就只会看到一句「网络不太顺」,而且这个授权活不过重装 —— 每次重装都要重新点一次。
两个小提示:从桌面点开 debug 包只会看到一句
「debug mode Flutter apps can only be launched from Flutter tooling」,这是 iOS 14+ 的限制,
不是包装坏了 —— 人肉走查请装 profile 包(左下角带 PROFILE 水印条,属正常)。
profile 包和 flutter run 的 debug 包是同一个 bundle id,真机上后装的覆盖先装的。
本站现有安装包
包是手工放进服务器目录的备用件,正式分发仍以蒲公英为准。要一次性产出这两个包:
bash scripts/dev-site-packages.sh