/Scriptables

iOS14桌面组件神器(Scriptable)开发框架、教程、精美脚本分享

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

Scriptables

iOS14桌面组件神器(Scriptable)原创框架,脚本开发教程、精美作品分享!
本项目的框架和插件代码,都是本人手机上一个一个字符屏幕敲出来,一行一行代码调试的用心作品
如果能得到您的喜欢,欢迎点个 ★ Star ★ 给予小支持,感谢您的使用,也同时欢迎大家一起参与改进完善 ❤️

👉 点击查看 5 分钟演示视频

screenshot.jpg

快速使用

  1. iPhone 上下载 Scriptable App(确保你的系统已更新为 iOS14+)
  2. Safari点击下载:国内Gitee源,推荐GitHub版源,然后点击下载的文件,用Scriptable App打开
  3. 手动版:打开App,点击右上角 + 号,复制项目中对应的 loader.github.jsloader.gitee.js 代码
  4. 长按桌面,添加组件,选择 Scriptable,然后点击组件配置,选择刚刚保存的脚本,下方的参数格式为:插件名@版本号:自定义参数
    例如,我要显示one每日图文组件,配置下方输入oneone@latest即可(显示昨天的文章输入配置one:1,依此类推)。

更多插件的配置参数,请查阅插件目录的README.md说明

组件列表

参数的意思,就是添加桌面组件时,选择加载器,然后下方参数中输入的内容
更多参数配置,可以进入项目代码库中组件的目录,有更详细说明

名称 说明 示例参数
one 韩寒ONE·一个图文 one
v2ex V2EX 最新、最热文章 v2ex@api
bing Bing 每日必应壁纸 bing
zhihu 知乎热榜等 zhihu
weibo 微博热搜榜 weibo
一言 随机更新一句话 一言
毒鸡汤 随机更新一条毒鸡汤 毒鸡汤
彩云天气 显示当前位置的天气预报情况 彩云天气
彩票开奖 展示最近一起开奖内容 彩票开奖
支付宝盒子 展示、打开支付宝常用功能 支付宝盒子
微信扫一扫 展示、打开微信扫一扫功能 微信扫一扫
知乎日报 显示知乎日报文章信息 知乎日报
网易云音乐 网易云音乐热评等 网易云音乐@热评
bilibili 哔哩哔哩粉丝数 bilibili@fans:446791792

框架优势

  1. 简单方便,无需像其他组件一样,一个个复制代码编辑保存添加。框架直接添加一个加载器,后续全靠灵活的配置
  2. 灵活更新,插件有新功能,直接在线更新最新版本,而无需再手动复制代码保存等操作
  3. 功能强劲,经过多次的代码重构,解决了无数个坑的经验,保证了插件的更稳定运行环境
  4. 开发速度,直接套用模板,获取数据、展示数据,非常的简单, 插件代码还可以直接单独脱离框架执行

插件开发

每一个项目,都创建一个文件夹,可以是中英文,最好不要有其他特殊符号。
文件夹中存放该项目的版本号等文件,比如:

  1. latest.js 最新版本代码文件
  2. README.md 插件说明使用文档
  3. 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

  1. Scriptable 神器试玩,创建一个显示自定义标题内容的 iOS14桌面组件
  2. Scriptable 神器实战2 —— 给桌面组件添加自定义背景图片
  3. Scriptable 神器实战3 —— 夜间模式动态展示
  4. Scriptable 神器实战4 —— 获取桌面组件的大小以自动展示内容
  5. Scriptable 神器实战5 —— 给桌面组件添加一个渐变色背景
  6. Scriptable神器实战6 —— 给背景图片加上半透明遮罩
  7. Scriptable神器实战7 —— 获取用户添加组件时的自定义参数
  8. Scriptable 实战之 —— 桌面组件交互之王.
  9. Scriptable神器实战 8 —— 本地存储 Keychain 用法
  10. Scriptable神器实战 9 —— Base64 数据编码/解码操作

更多文章连载更新中,扫一扫关注【古人云】公众号,第一时间获取更新: