前言

基于 Scriptable App 开发的一个桌面小组件脚本。使用iOS 小组件快速开发框架「小件件」作为开发框架而搭建。主要从APP API中获取车辆相关信息并以桌面小组件的形式展示到iOS设备上。

该教程为转载自用，为保护作者隐私，不展示来源出处，本教程为个人自用：

1. 出行小组件需要使用到您的相关app账号登录获取相关权限，这也是为了帮您获取相关车联网信息显示。

2. 出行小组件不会收集您的个人账户信息，所有账号信息将存在iCloud或者iPhone上，不会上传，我不会获取到你的账号，但也请您妥善保管自己的账号！

3. 小组件使用免费，由车主自由开发，所有责任与相关汽车所属公司无关；小组件非官方人员开发，由作者个人开发者提供。使用本组件，如果导致部分APP端踢下线。这是正常现象，请勿担心！

4. 使用本组件造成的所有损失、后果，由使用者自行负责，组件仅作为快捷辅助工具，请勿私自用于商业行为，如果私自使用该组件倒卖，恶意推广造成的一切法律后果，将追究个人、组织相应法律责任！组件作者不承担任何后果。作者保留最终解释权！

5. 若官方推出相应组件或禁止传播，则停止组件开发与更新，并下架相关代码。

作者简称：NK·W

效果展示

前期准备

1.MZD手机控车（需在车上安装控车模块，不过多介绍，APP图标会放在下面）

2.IOS系统（iPhone）

3.Scriptable

4.Stream

安装教程

1.打开 Scriptable，点击 ➕，粘贴代码，运行 ▶️

代码下载：mzd.js

2. 然后点击 「小件件」长马出行 设置账号 - 长安马自达账号必填，长安马自达密钥必填，其他可不填。

3.回桌面空白处长按，左上角「 + 」添加小组件 搜 Scriptable，添加完在图标抖动编辑状态下，单击刚添加的组件，或长按组件选择编辑小组件。Script 选择你刚新建的 「小件件」长马出行。完成。

提取密钥抓包教程：长马出行小组件获取授权教程（由于官方限制，密钥不定时会过期，显示未授权，重新抓包导入数据，再刷新数据即可）

设置账号与设置组件

点击 「小件件」长马出行 或 其他出行组件 选择 设置账号 进行账号设置，账号、密码必填（其他车辆请看各自文档说明），选择 设置组件 进行组件自定义设置，部分数据可不填，默认读取车辆数据

• 小组件设置支持自定义车辆名称、自定义LOGO图片、自定义车辆图片、自定义背景颜色 等自定义配置

• 自定义图片可选择本地图片或自行上传图片到相关图床网站，获取图片地址再填写到在指定配置项内，透明背景图片显示效果更佳，可以在下方获取在线抠图工具。

• 自定义背景可选图片和颜色背景，颜色背景也可以自定义，根据需求调整三项分别是顶部颜色（如#FFFFFF），底部颜色与文字颜色。

• 自定义小组件设置栏中一项为 高德地图API Key，为正常使用显示车辆地址，请勿随意改动！！

为方便上传车辆、logo图片，提供一个在线抠图和图床地址：

在线抠图地址： 点击此处

图床地址： 点击此处

添加组件到桌面

• 返回桌面空白处长按，左上角 「 + 」 添加小组件

• 搜 Scriptable，添加完组件后，在图标抖动编辑状态下单击刚添加的组件，或 长按组件 选择 编辑小组件。

• Script 选择你刚新建的 「小件件」xx出行 或其他出行组件，其他无需设置 。操作完成等待组件刷新即可。

如果没刷新 就再走一下 设置账号与设置组件重新设置。

常见问题

Q: 小组件车辆图片出现红色方块图片

A: 重新设置等待刷新小组件，删除脚本重新添加小组件脚本。

Q: 获取车辆信息失败，请检查授权

A: 根据不同车型的登录需求，重新输入账号密码或密钥，确保账号正确。

Q: 如何更换组件背景颜色

A: 选择自定义背景颜色下面自定义，输入色值即可更换颜色。三项分别是顶部颜色（如#FFFFFF），底部颜色与文字颜色。

Q: 账号下多辆车如何选择

A: 在输入账号密码的下一步输入车架号绑定你要显示的车辆

Q: 如何更新小组件

收到新版本推送后打开 Scriptable 点击检查更新 - 开始下载。

Q: 设置项出现空白

A: 设置项空白，建议不要随便修改设置，等待稍后重试，出现相关设置后再修改。

Q: 快捷操作提示令牌失效

A: 首先，点击检查更新，将脚本更新到最新版本，然后菜单选择刷新数据，重新设置账号登录即可。

Q: 数据不更新不及时

A: 目前车辆数据3-5分钟缓存一次，获取最新数据，菜单选择刷新数据或者更改数据刷新间隔即可。

Q: 老版本无法自动更新

A: 若有安装老版本无法自动更新的朋友，可重新复制代码，全部代码重新设置即可。建议重新安装一次。

Q: 脚本莫名丢失

A: 文件脚本默认存储在iCloud云盘上的，请先检查iCloud登录是否失效、 或者同步设备误删脚本文件，以上操作都会导致文件脚本丢失。

Q: 关于组件刷新不及时、不准确问题 A：

• 运行时间限制

在iOS系统上，小组件是由iOS系统自动刷新的，桌面上的每个小组件的刷新次数都受iOS系统限制。iOS系统为了保护电池的使用寿命，所有的刷新都受到限制，所以小组件的内容会造成延迟，一旦添加到桌面上，它就不会改变，直到它下一次运行它才会有所变化，和我们想要的效果可能不一样。

• 交互操作限制

  小组件一旦添加到桌面上，它就不会改变，限制了它的独立可操作性，所以无法有更多的交互操作。

• 尺寸限制

在iOS14.x系统中小组件的尺寸是固定的，分小号，中号，大号三种样式，形状只能是圆角矩形，我们无法改变他的原始外观，只能在这三种样式内做修改。

Q: 新建桌面组件，无法找到Scriptable APP

在升级到ios14.5 及以上系统之后，手机长时间开机之会出现找不到应用无法添加组件的情况，针对苹果系统存在的这个问题，我们建议您可以采取以下方法：

方法1：重启手机后->再打开一次【Scriptable】->前往桌面再次尝试添加

方法2：打开手机设置->通用->还原->还原主屏幕布局->前往桌面再次尝试添加

提供一个思路：先用另一个号注册一个MZD手机控车，在使用主号登录MZDAPP，然后借车给第二个号，记得时间借久一点，之后登录第二个号，抓包，确认成功后，下线，登录第一个号！非常完美！