Installing ProtoViewer on Android¶
ProtoViewer is the standalone app for opening, switching between and sharing saved prototypes.
See the design doc. prototype save on Android routes to it when
it is installed, so install it once per device or emulator you use.
Every GitHub release carries two ProtoViewer assets next to the CtrlProxy APK:
automobile-protoviewer-<version>.apkautomobile-protoviewer-<version>.apk.sha256
The APK is signed with the release key.
Install¶
VERSION=0.0.89 # the release you want
BASE="https://github.com/kaeawc/auto-mobile/releases/download/${VERSION}"
curl -fsSLO "${BASE}/automobile-protoviewer-${VERSION}.apk"
curl -fsSLO "${BASE}/automobile-protoviewer-${VERSION}.apk.sha256"
# Verify the checksum (macOS: shasum -a 256 -c ...)
sha256sum -c "automobile-protoviewer-${VERSION}.apk.sha256"
adb install -r "automobile-protoviewer-${VERSION}.apk"
The checksum is also published with the release notes.
To check which key signed the APK (it must not be the debug certificate):
apksigner verify --print-certs "automobile-protoviewer-${VERSION}.apk"
Updating¶
adb install -r replaces an installed ProtoViewer in place and keeps its saved prototypes. The new
APK must be signed with the same key and have an equal or higher versionCode.
When a spec needs something the installed ProtoViewer cannot show, prototype save refuses it
before copying anything to the device. The result has errorCode: "unsupported_capability" and an
update object with missingCapabilities, installedVersion and a url for a newer build.
Update ProtoViewer as above and save again. AutoMobile supports the three most recent ProtoViewer
releases.
iOS¶
The iOS simulator template viewer (AutoMobilePrototypeViewer.zip) is a separate artifact and is
downloaded automatically. A ProtoViewer build for physical iPhones is not part of the release yet.