Skip to content
This repository has been archived by the owner on Oct 27, 2023. It is now read-only.

别针扩展简单模板(轻量级)

Notifications You must be signed in to change notification settings

bddjr/clipcc-extension_simple_template

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

clipcc extension simple template

If you want to read the English document, click here.

别针扩展简单模板(轻量级)

该作者与 ClipTeam 无关。
使用这个轻量级的方法,无需 nodejs 就能编写并打包扩展。
这种轻量级的打包方式不是标准的,但仍然可以被采纳,例如 https://github.com/bddjr/clipcc-extension-restart_project
仅用于单个 javascript 文件的场景。


实现原理

将 code 文件夹压缩为 zip 文件。


编写扩展

编辑文件 ./code/main.js 即可。
因为使用的是轻量级的打包方式,所以引入clipcc扩展api时必须使用这个方法:

const {api, type, Extension} = self["ClipCCExtension"];

有关clipcc扩展api的使用方式请参考 https://doc.codingclip.com/zh-cn/category/for-developers
若有扩展api使用的疑问,请自行参考其它扩展,或者到clipcc官方群聊询问。


在 Windows 操作系统打包扩展

请预先安装 bandizip
再在这个文件夹下使用 powershell 运行如下命令:

./packaging.ps1

如果你因为系统禁止运行此脚本而无法使用,请以管理员权限打开 powershell ,然后运行这个命令以允许执行ps1脚本:

set-ExecutionPolicy RemoteSigned

如果你已经安装了 python 与 bandizip ,那么也可以使用这个命令打包:

python packaging.py

在 Linux 操作系统打包扩展

(待验证可行性)
请预先安装 zip 和 python3 ,
再在这个文件夹下运行如下命令:

python3 packaging.py

测试扩展

在预览站上传自己的扩展(不提交扩展审核),以测试自己的扩展:
https://codingclip.com/editor/stable/


修改扩展ID与版本号

假设我要

将扩展的ID修改为 anonymous.example (如果你要提交审核,按照官方标准,扩展ID应当通过这个正则表达式验证 ^([a-z_0-9] )\.([a-z_0-9] )$
版本修改为 1.0.0
作者修改为 anonymous

那么我需要修改以下文件:

这个文件会在扩展上传至编辑器时用于识别扩展信息,是很关键的一步。
./code/info.json

{
    "id": "anonymous.example",
    "author": "anonymous",
    "version": "1.0.0",
    "icon": "assets/icon.webp",
    "inset_icon": "assets/inset_icon.svg",
    "api": 1
}

这个文件是 javascript 程序,也是很关键的一步。
./code/main.js

// 此处填写扩展ID
const extension_id = 'anonymous.example';
// 此处填写扩展的积木栏ID
const category_id = extension_id   '.category';

这个文件是用于英语的语言文件,当编辑器找不到对应语言的文件时,会在这个文件里查找。
./code/locales/en.json

{
"anonymous.example.name": "anonymous example extension",
"anonymous.example.description": "Just a example extension.",

"anonymous.example.category": "anonymous example extension",
"anonymous.example.category.string": "String [VALUE]"
}

这个文件是用于简体中文的语言文件。
./code/locales/zh-cn.json

{
"anonymous.example.name": "匿名示范扩展",
"anonymous.example.description": "只是一个示范扩展。",

"anonymous.example.category": "匿名示范扩展",
"anonymous.example.category.string": "字符串 [VALUE]"
}