iOS14桌面组件神器(Scriptable)原创框架,脚本开发教程、精美作品分享!
本项目的框架和插件代码,都是本人手机上一个一个字符屏幕敲出来,一行一行代码调试的用心作品
如果能得到您的喜欢,欢迎点个 ★ Star ★ 给予小支持,感谢您的使用,也同时欢迎大家一起参与改进完善 ❤️
- iPhone 上下载 Scriptable App(确保你的系统已更新为 iOS14+)
- Safari点击下载:国内Gitee源,推荐、GitHub版源,然后点击下载的文件,用
Scriptable
App打开 - 手动版:打开App,点击右上角 + 号,复制项目中对应的 loader.github.js 或 loader.gitee.js 代码
- 长按桌面,添加组件,选择
Scriptable
,然后点击组件配置,选择刚刚保存的脚本,下方的参数格式为:插件名@版本号:自定义参数
例如,我要显示one
每日图文组件,配置下方输入one
或one@latest
即可(显示昨天的文章输入配置one:1
,依此类推)。
更多插件的配置参数,请查阅插件目录的README.md
说明
参数的意思,就是添加桌面组件时,选择加载器,然后下方参数中输入的内容
更多参数配置,可以进入项目代码库中组件的目录,有更详细说明
名称 | 说明 | 示例参数 |
---|---|---|
one | 韩寒ONE·一个图文 | one |
v2ex | V2EX 最新、最热文章 | v2ex@api |
bing | Bing 每日必应壁纸 | bing |
zhihu | 知乎热榜等 | zhihu |
微博热搜榜 | weibo |
|
一言 | 随机更新一句话 | 一言 |
毒鸡汤 | 随机更新一条毒鸡汤 | 毒鸡汤 |
彩云天气 | 显示当前位置的天气预报情况 | 彩云天气 |
彩票开奖 | 展示最近一起开奖内容 | 彩票开奖 |
支付宝盒子 | 展示、打开支付宝常用功能 | 支付宝盒子 |
微信扫一扫 | 展示、打开微信扫一扫功能 | 微信扫一扫 |
知乎日报 | 显示知乎日报文章信息 | 知乎日报 |
网易云音乐 | 网易云音乐热评等 | 网易云音乐@热评 |
bilibili | 哔哩哔哩粉丝数 | bilibili@fans:446791792 |
- 简单方便,无需像其他组件一样,一个个复制代码编辑保存添加。框架直接添加一个加载器,后续全靠灵活的配置
- 灵活更新,插件有新功能,直接在线更新最新版本,而无需再手动复制代码保存等操作
- 功能强劲,经过多次的代码重构,解决了无数个坑的经验,保证了插件的更稳定运行环境
- 开发速度,直接套用模板,获取数据、展示数据,非常的简单, 插件代码还可以直接单独脱离框架执行
每一个项目,都创建一个文件夹,可以是中英文,最好不要有其他特殊符号。
文件夹中存放该项目的版本号等文件,比如:
latest.js
最新版本代码文件README.md
插件说明使用文档v2.0.0.js
其他版本或功能区分文件
测试的时候,添加桌面组件,选择加载器,然后参数输入格式:项目文件夹名@版本号:参数
,比如v2ex
项目中有个api.js
代码文件,传递:v2ex@api:hot
类似格式的配置,也可以直接输入项目名即可(版本号默认latest,参数默认脚本定义)
插件代码,请直接复制项目中的template.sample.js
模板编辑
2020/10/13 17:00更新:加载器支持输入第三方开发者的插件配置
比如开发者 user-a
, fork 了本项目到自己的仓库,编辑了 welcome/latest.js
组件脚本,那么用户在添加桌面组件时,输入参数:user-a/welcome@latest
即可加载第三方开发者仓库的组件代码。
注意:由于用户可能使用的是
Gitee
源加载器,所以你应该也需要前往 Gitee,创建同名用户+仓库,同步 github 仓库项目
(和之前的参数区别就是前边多了 用户名/
格式)
开发者可以直接复制 template.sample.js 代码,打开 Scriptable 应用,添加粘贴代码,然后根据底部的注释取消注释相关代码,即可进行测试、独立运行操作。
待测试完毕,可直接上传到自己的仓库项目中,然后根据上边方法进行远程加载测试。
如果测试都没问题,可以直接向本项目PR更改,谢谢每一位参与研究的开发者!
公众号集合文章:#scriptable
- Scriptable 神器试玩,创建一个显示自定义标题内容的 iOS14桌面组件
- Scriptable 神器实战2 —— 给桌面组件添加自定义背景图片
- Scriptable 神器实战3 —— 夜间模式动态展示
- Scriptable 神器实战4 —— 获取桌面组件的大小以自动展示内容
- Scriptable 神器实战5 —— 给桌面组件添加一个渐变色背景
- Scriptable神器实战6 —— 给背景图片加上半透明遮罩
- Scriptable神器实战7 —— 获取用户添加组件时的自定义参数
- Scriptable 实战之 —— 桌面组件交互之王.
- Scriptable神器实战 8 —— 本地存储 Keychain 用法
- Scriptable神器实战 9 —— Base64 数据编码/解码操作