diff --git a/README.md b/README.md index d2dfd4d..eded046 100644 --- a/README.md +++ b/README.md @@ -358,7 +358,22 @@ monkeydo bin/Fenix8V3_fenix847mm.prg fenix847mm # 载入表盘 非 release 编译会同时产出 `bin/*-settings.json`,可在模拟器 `View → Settings` 载入以实时切换主题与指标。注意模拟器会**持久化**已保存的设置,改 `properties.xml` 的默认值对已运行过的实例不生效,需先重置应用数据。 -真机侧载:用 Garmin Express 或 Connect 手机 App 导入对应机型的 `bin/Fenix8V3_.prg`,或把 `.prg` 拷入手表 `/GARMIN/Apps/`。 +### 侧载到真机 + +```bash +tools/install.sh # 默认 enduro3 +tools/install.sh fenix847mm # 指定机型,id 见 manifest.xml +``` + +脚本会编译 release 版并自动找已挂载的 GARMIN 卷复制过去。找不到卷时会打印 +`.prg` 的路径和排查提示。 + +手动做的话就是:编译出 `bin/Fenix8V3_<机型>.prg`,拷进手表的 `GARMIN/APPS/`, +推出后拔线,表上长按 UP/MENU → 表盘 → 选 Fenix 8 V3。再长按 MENU 进表盘设置。 + +> macOS 上 fenix 7 之后的机型多数走 MTP,Finder 看不到这个盘。装 +> [OpenMTP](https://openmtp.ganeshrvel.com)(免费)或 Android File Transfer +> 就能拖文件了。 --- diff --git a/tools/install.sh b/tools/install.sh new file mode 100755 index 0000000..fd0b4ca --- /dev/null +++ b/tools/install.sh @@ -0,0 +1,61 @@ +#!/bin/bash +# 编译并侧载到通过 USB 接入的 Garmin 手表。 +# +# tools/install.sh # 默认 enduro3 +# tools/install.sh fenix847mm # 指定机型 +# +# 机型 id 见 manifest.xml 的 。 +# +# 前提:手表用数据线接到电脑,并且在 Finder 里能看到名为 GARMIN 的卷。 +# 看不到的话见本文件末尾的说明。 +set -e + +DEV="${1:-enduro3}" +ROOT="$(cd "$(dirname "$0")/.." && pwd)" +SDK="$HOME/Library/Application Support/Garmin/ConnectIQ/Sdks" +MONKEYC="$(ls -d "$SDK"/*/bin/monkeyc 2>/dev/null | sort | tail -1)" + +[ -z "$MONKEYC" ] && { echo "找不到 monkeyc,请先装 Connect IQ SDK"; exit 1; } +[ -f "$ROOT/developer_key.der" ] || { echo "缺 developer_key.der"; exit 1; } +grep -q "\"$DEV\"\|id=\"$DEV\"" "$ROOT/manifest.xml" || { + echo "manifest.xml 里没有机型 '$DEV'"; exit 1; } + +PRG="$ROOT/bin/Fenix8V3_${DEV}.prg" +echo "==> 编译 $DEV(release)" +mkdir -p "$ROOT/bin" +"$MONKEYC" -o "$PRG" -f "$ROOT/monkey.jungle" -y "$ROOT/developer_key.der" \ + -d "$DEV" -r 2>&1 | tail -1 + +# Garmin 卷的名字通常就是 GARMIN,个别机型会带型号后缀 +VOL="" +for v in /Volumes/*; do + [ -d "$v/GARMIN" ] && VOL="$v" && break +done + +if [ -z "$VOL" ]; then + cat <<'EOS' + +==> 没找到手表。 + +在 Finder 里看不到 GARMIN 卷,通常是这两种情况之一: + + 1. 表没解锁 —— 部分机型插上后要在表上确认一次 + 2. 走的是 MTP 协议 —— macOS 的 Finder 不支持 MTP。fenix 7 之后的机型 + 多半是这种。装一个 OpenMTP(免费,https://openmtp.ganeshrvel.com) + 或 Android File Transfer,就能像普通盘一样浏览手表了。 + +用 MTP 工具时,把下面这个文件拖到手表的 GARMIN/APPS/ 目录即可: +EOS + echo " $PRG" + exit 0 +fi + +DEST="$VOL/GARMIN/APPS" +mkdir -p "$DEST" +cp "$PRG" "$DEST/" +echo "==> 已复制到 $DEST/$(basename "$PRG")" +echo +echo "接下来:" +echo " 1. 在 Finder 里推出(Eject)手表这个卷,再拔线" +echo " 2. 表上长按 UP/MENU -> 表盘 -> 找到 Fenix 8 V3" +echo " 3. 再长按 MENU 可以进这个表盘自己的设置,改主题和四个数据位"