# iOS14-widgets-for-scriptable
**Repository Path**: nineo/iOS14-widgets-for-scriptable
## Basic Information
- **Project Name**: iOS14-widgets-for-scriptable
- **Description**: 个人开发的ios桌面小组件
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 2
- **Created**: 2023-03-21
- **Last Updated**: 2023-03-21
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
> 如果本项目对你有帮助,欢迎在[:link:Github](https://github.com/zkytech/iOS14-widgets-for-scriptable)点个star表示支持。
>
> 联系邮箱:zhangkunyuan@hotmail.com ,PR请提交到[:link:Github](https://github.com/zkytech/iOS14-widgets-for-scriptable)
# iOS 14小组件
- [iOS 14小组件](#ios-14小组件)
- [使用方法](#使用方法)
- [安装scriptable](#安装scriptable)
- [安装脚本](#安装脚本)
- [使用](#使用)
- [ 小组件:bilibili最近更新番剧列表](#-小组件bilibili最近更新番剧列表)
- [效果预览](#效果预览)
- [安装](#安装)
- [参数](#参数)
- [小组件:LOL近期赛事列表](#小组件lol近期赛事列表)
- [效果预览](#效果预览-1)
- [安装](#安装-1)
- [小组件:深蓝SL03车辆状态](#小组件深蓝sl03车辆状态)
- [效果预览](#效果预览-2)
- [安装](#安装-2)
- [参数](#参数-1)
- [主题设置、自定义车辆图片、LOGO、型号文本...](#主题设置自定义车辆图片logo型号文本)
## 使用方法
### 安装scriptable
安装App Store中的[:link:Scriptable](https://apps.apple.com/cn/app/scriptable/id1405459188)
### 安装脚本
下方各组件的章节内有对应脚本的安装链接,点击下载后用`Scriptable APP`打开。选择`Add to my scripts`即可。

### 使用
1. 安装scriptable后会自动创建几个Demo脚本,其中有一个脚本是`Random Scriptable API`,先点击运行一次这个脚本。
2. 在桌面创建小组件 选择 `scriptable`
3. 编辑 小组件,点击`选取 script` 并选择前面导入的脚本。
## 小组件:bilibili最近更新番剧列表
### 效果预览

### 安装
下载[:link:安装脚本](https://gitee.com/zkytech/iOS14-widgets-for-scriptable/releases/download/1.0.1/bilibili.scriptable)后,用`scriptable`打开
### 参数
小组件的parameter可以设置以下几个值
| 参数 | 必填 | 值/示例 | 说明 |
| type | 否 | 番剧/global/进口 | 进口番剧 |
| 国创/cn/国产 | 国产动画 |
| all/全部 | 进口+国产 |
| onlyFollowed | 否 | 追番/true | 仅显示已追 |
| 全部/false | 未追番 + 已追番 |
| uid | 当onlyFollowed为追番/true时 必填 | 8165988 | Bilibili账号的UID,如果要设置仅显示追番,必须同时设定这个值。同时要设置空间公开显示番剧订阅 |
> 获取uid:B站APP - 我的 - 点击头像 - 详情
在小组件的编辑界面,按照以下格式进行配置
```javascript
// 配置格式
type,onlyFollowed,uid //注意必须用英文逗号
// 示例
示例1: 国创,追番,8165988
示例2: cn,true,8165988
示例3: ,追番,8165988
示例4: ,true,8165988
示例5: 番剧,追番,8165988
示例6: global,true,8165988
示例7: 全部,追番,8165988
示例8: all,true,8165988
```
配置示例


## 小组件:LOL近期赛事列表
### 效果预览

### 安装
下载[:link:安装脚本](https://gitee.com/zkytech/iOS14-widgets-for-scriptable/releases/download/1.0.1/lol.scriptable)后,用`scriptable`打开
## 小组件:深蓝SL03车辆状态
声明:
- 脚本所展示的信息不保证准确无误,锁车、充电、电量、油量等所有信息仅供参考,请勿将桌面组件展示的数据作为决策依据,由于脚本展示数据错误/误差造成的任何后果,本人概不负责。
- 脚本需要使用深蓝APP的登录信息来获取数据,安装即代表您同意脚本使用您的登录信息。
- 所有数据只会存储在您的iCloud云盘或者手机本地,不会上传到任何第三方服务器。
### 效果预览
特性:
- 桌面小组件展示车辆数据: 电池续航、油箱续航、总里程、车内温度(仅纯电车型)、车辆位置、车辆锁定状态、车辆充电状态、车牌号
- 主题支持自动跟随系统黑暗模式切换
- 锁屏组件展示车辆数据: 电量、油量
- 点击桌面/锁屏组件跳转到深蓝APP控车界面

### 安装
为了节省你的时间,请认真阅读下面的操作步骤,并依照文档进行操作,跳过任何一个字都只会成倍地浪费你的时间。为了帮助小白理解,最下面有抓包操作流程图。
操作过程对小白来说有一定的难度,但是文档写这么长就是为了让更多的人能顺利装上,只要跟着文档一步步操作就能成功。新手大概需要5~10分钟。
认真阅读文档!不要跳过任何一步!
认真阅读文档!不要跳过任何一步!
认真阅读文档!不要跳过任何一步!
为了顺利打开下面的链接,**请在safari浏览器中打开本页面**。
1. 安装[:link:Scriptable APP](https://apps.apple.com/cn/app/scriptable/id1405459188)
2. 下载[:link:桌面组件安装脚本](https://gitee.com/zkytech/iOS14-widgets-for-scriptable/releases/download/1.0.1/SL03Widget.scriptable)后,用`Scriptable`打开
3. 安装scriptable后会自动创建几个Demo脚本,其中有一个脚本是`Random Scriptable API`,先点击运行一次这个脚本。
> 增程车型的油、电续航数据可能会变成-1、0,这种情况是深蓝APP的API问题,我无法解决,请知悉。
> 车型颜色需要收集比对各种颜色车子的抓包数据来判断是哪个字段,目前没有足够的数据支撑,所以统一白色,当然,小组件提供了部分[自定义选项](#43-主题设置自定义车辆图片logo型号文本),你可以自己替换车辆图片。
### 参数
- 桌面组件参数: `refresh_token`
- 锁屏组件参数: `模式`
- 非必填,可以填写:`电`、`油`,默认显示电量
- 请先设置好桌面组件再使用锁屏组件,否则锁屏组件无法获取到`refresh_token`
本组件需要获取`refresh_token`,操作过程涉及抓包,幸运的是,IOS是抓包操作最简单的平台,抓包方法我会讲,如果看不懂,请自行百度。以桌面组件为例,`refresh_token`获取及使用方法如下:
1. 请开启手机上的iCloud云盘。
2. 安装[:link:Stream APP](https://apps.apple.com/cn/app/stream/id1312141691),并开启HTTPS抓包功能,必须要显示“设置成功:CA证书已经安装且信任”。

3. 点击`开始抓包`
4. 打开`深蓝`APP,进入控车页面,下拉刷新车辆状态,为了确保请求能被抓到,建议多刷几次。
5. 回到`Stream` APP,停止抓包
6. 进入抓包历史,查看刚刚生成的抓包记录,搜索`refresh`(注意搜索框里不要输入空格),可以看到URI为`/appapi/v1/member/ms/refreshCacToken`的请求
7. 点击查看请求详情,查看`响应-响应主体-查看json`
8. 将`refresh_token`的值复制下来。比如你看到的是`"refresh_token":"ajj1f73b21DSUbias"`这里要复制保存的就是`ajj1f73b21DSUbias`,不要带引号。
9. 回到桌面,新增桌面组件,创建Scriptable**中等大小**组件。
10. 在桌面**长按**上一步添加的小组件,在弹出菜单中选择**编辑小组件**,此时会出现小组件的设置界面,修改下面两项设置:
- `Script`:点击选择前面安装的脚本`SL03Widget`,
- `Parameter`:将前面复制的`refresh_token`值粘贴到这里面
11. 点击空白处回到桌面,等待小组件完成加载。
12. 打开`Scriptable APP`,点击组件列表中的`SL03Widget`查看高级功能,在这里你可以修改主题、车辆颜色、车辆图片、车辆型号、LOGO等。
> 锁屏组件目前只支持小号电量/油量圆环,锁屏组件的添加方法请参考[:link:视频教程](https://www.bilibili.com/video/BV19d4y1q7vi/?spm_id_from=333.337.search-card.all.click&vd_source=5b7cf4daa7d98506767a0757e0b64d77)进行操作。

### 主题设置、自定义车辆图片、LOGO、型号文本...
目前支持自定义的内容:
- `型号`
- `LOGO`
- `车辆图片`
> `车辆名称`和`车牌号`是通过API获取的,如果你没有在`深蓝APP`中设置车牌号,小组件就拉不到车牌数据。所以这两个需要你自己在`深蓝APP`中修改,修改后等待系统刷新小组件即可。

