写一个自己的漫画源:准备什么
源脚本是公开标准:官方仓库附带完整的开发文档与模板,懂 JavaScript 就能照着写。这一页讲开工前要备齐什么。
需要准备的东西
- 一份可运行的调试环境:最顺手的方式是用 Flutter 跑起项目源码来调试,比装好的成品应用更好排错;退一步用正式版应用验证也可以
- 支持 JavaScript 的编辑器:任意代码编辑器都行
- 模板与接口文档:官方维护的源生态仓库(源列表与模板都在里面)提供了带详细注释的源模板和 JavaScript 接口文档,从仓库获取
- 目标站点的结构理解:你要接的站点,它的列表页、搜索接口、图片地址长什么样,得先摸清楚
一个源脚本长什么样
模板里的骨架是一段继承 ComicSource 的类声明,核心块包括:
- 基本信息:源名称、唯一标识、版本号、最低兼容应用版本
- 探索页、分类页、搜索的实现
- 漫画详情与章节图片的加载函数
- 需要的话再加账号登录与收藏对接
每个块的具体字段见漫画源脚本 API 速览:一个源要实现哪些块。
调试思路
- 先实现「搜索 + 详情 + 取图」最小闭环,能看图再补探索页、分类这些锦上添花的
- 模板注释里带示例,对照抄改动最小
- 写完导入正式版验证一遍,发布回社区仓库让更多人用
自写源只用在自己信任的站点上;分发的脚本同样要负起来源责任。