Gearslip：不依赖 Google 的 Android Auto 替代方案

为所有人打造的 Android Auto 替代方案。

有问题或想法？ 加入 Matrix 上的讨论。

哪些车能用

大多数车都能用。大约从 2020 年起，一些车加入了更新的安全标准，会拒绝 Gearslip 的证书，Gearslip 无法在这些车上运行。

Gearslip 是什么

Gearslip 是一款手机端的 Android Auto 客户端。它通过 USB 直接与车机通信，使用 Android Auto 协议，全程没有 Google 软件参与。Gearslip 充当 Car App Library 宿主：一个自带车载界面的应用把模板交给 Gearslip，Gearslip 便在车机屏幕上原生渲染该模板。手机画面不会被镜像过去。对于没有车载界面的应用，Gearslip 提供单独的屏幕共享模式。

应用按类别排列。打勾的表示可用。	Vela Maps 正在导航，旁边是播放器。
ViVi Music 在 Gearslip 的播放器中。	一条新消息，轻点即可朗读，显示在地图上方。
天气、你的下一个日程，以及你错过的内容。	停车时浏览网页。

功能

• 电话。用键盘拨号，或搜索联系人，拨出前先确认。
• 导航。Gearslip 在车机屏幕上托管真正的 Car App Library 地图应用。Organic Maps、OsmAnd 和 Flitsmeister 目前可用。Vela 能运行，但还有些粗糙之处。
• 音乐。从支持车载的媒体应用中浏览、播放和排队曲目，带有正在播放视图、接下来播放队列和歌词。输入搜索词，支持搜索的应用会播放最匹配的结果。
• 网页。一个带自带屏幕键盘的浏览器模板，用于任何没有自带车载界面的内容。
• 天气与日程。仪表盘屏幕会显示本周日历，旁边是当前和即将到来的天气。
• 消息。新消息会以一张小卡片的形式出现在车机屏幕上。Gearslip 会逐条朗读，你可以用语音或快捷回复来回应。Gearslip 说话或聆听时音乐暂停。语音在手机上运行，因此不需要 Google 账号。
• 通知。只有消息、未接来电、闹钟和提醒会打扰你。其余的都留在仪表盘上等待。
• 你的应用，你的排序。启动器按类别分组应用：电话、地图、音乐、消息，以及其他。长按应用即可移动它。
• 车辆控制。方向盘按键、控制旋钮和方向键都能用。
• 主题。可选择扁平按钮，或看起来像真实按键的拟物化按钮。

状态

• 目前仅支持有线连接。将手机插入车机的 USB 端口；Gearslip 尚未提供无线选项。
• 设置会引导你完成。首次启动会请求 Android Auto 证书，然后一次请求一项权限，每项都附有通俗的理由和允许或跳过选项。车内帮助屏幕会解答设置未涵盖的任何问题。
• 模板化应用可用。Gearslip 渲染 Car App Library 定义的全部 16 种模板类型，并为搜索、登录和文本字段绘制自己的键盘。它已针对多款真实导航和媒体应用进行过测试。
• Gearslip 可与 LIVI 配合使用，后者是用于自制车载仪表盘的开源车机。
• 有些应用拒绝 Gearslip。Spotify、Waze 和 Google Messages 使用的 Google 车载库版本只接受 Android Auto 本身。Spotify 仍可通过 Gearslip 自带的播放器播放。
• 通话使用车载蓝牙，与 Android Auto 中的做法相同。将手机与车辆配对，即可通过车载扬声器听到通话。
• 音频通过捕获播放内容而非镜像屏幕传输到车辆。为此，Android 会显示屏幕共享同意对话框，尽管 Gearslip 从不读取屏幕；这是普通应用捕获其他应用音频的唯一方式。该对话框每次驾驶时出现一次。
• Gearslip 无需 adb、root 或 Shizuku。每项功能都依赖于普通的 Android 权限或设备上的同意对话框。设置指南提供了两条可选的 adb 命令：一条可永久移除音频对话框，另一条可在播放音频时保持通知可见。

使用说明

Gearslip 可以发送简短说明，显示它在哪些车辆中可用。除非你在设置或设置中开启，否则它们不会发送。

• 发送时机。当你打开 Gearslip 时，每天最多一次，以及每次驾驶后。后台不会运行任何内容。
• 包含内容。Gearslip 版本，以及你勾选的任何内容：Android 版本及手机是否运行 GrapheneOS、手机型号、当天是否有车辆连接，以及每辆车的车机、型号、年份、屏幕尺寸和连接结果。设置中会显示确切的说明。
• 不包含内容。你的姓名、账户、位置、联系人、消息，以及你输入或播放的任何内容。
• 手机计数方式。一个随机数对每部手机计数一次。服务器仅保留其加盐哈希值。
• 发送目的地。发送至 Cloudflare Worker，其代码位于 stats-worker/。Cloudflare 在传递说明时会看到你的 IP 地址，就像任何网站一样；Worker 不会存储它。

关闭说明后，它们会立即停止。

Gearslip 是如何制作的

Gearslip 是我心爱的孩子。我决定它的功能和外观，AI 编码工具帮助我编写代码。每个更改在发布前我都会亲自测试：在真实的车辆中，使用 GrapheneOS 手机和原生 Android 手机，以及在 LIVI（开源车机软件）上测试。如果出现问题，责任在我，请提交 issue。

构建

./gradlew :gearslip:assembleDebug

APK 生成于 build/Gearslip-debug.apk。

发布构建需要签名密钥。将 keystore.properties.example 复制到 keystore.properties，填入你自己的值，然后运行 ./gradlew :gearslip:assembleRelease。Git 会忽略属性文件和密钥库。没有它们，调试构建仍然可以工作。

为 Gearslip 编写应用

docs/BUILDING_APPS.md 规定了如何编写 Gearslip 可以渲染的应用：模板化应用、媒体应用以及 Gearslip 应用协议。

Gearslip 如何与车辆通信

Gearslip 是一个独立程序，旨在与车机配合使用。它对协议的了解来自公开开源项目，如 aasdk 和 open-android-auto，并且不包含任何 Google 的 Android Auto 代码。

Gearslip 发布时不附带证书。首次启动时，你选择证书来源：下载 aasdk 项目发布的证书，或导入你自己的文件。证书保留在你的手机上。Gearslip 从不上传、备份或记录它。

商标

Android、Android Auto、Google Messages 和 Waze 是 Google LLC 的商标。Spotify 是 Spotify AB 的商标。Gearslip 与这些公司无关联、未获其认可或赞助。所有其他名称归其所有者所有。

许可证

Gearslip 采用 AGPL-3.0 许可；参见 LICENSE。作者另外提供商业许可，供在 AGPL 条款之外进行私人使用；参见 NOTICE.md。