解锁Legado阅读器潜能：3步打造专属阅读插件

你是否曾因找不到心仪的阅读功能而遗憾？Legado阅读器的插件系统让一切成为可能。本文将带你从零开始，通过书源扩展、UI定制和功能整合三大步骤，打造属于自己的个性化阅读工具。完成后，你将掌握插件开发全流程，让阅读体验焕然一新。

插件开发入门：环境与基础

Legado插件开发无需复杂环境配置，只需基础的JSON和JavaScript知识。官方提供完整的API接口和示例，帮助开发者快速上手。

开发准备

1. 启用Web服务：在应用设置中开启"Web服务"，默认端口1234，用于本地调试。
2. 获取开发资源：
   • 官方文档：README.md
   • API参考：api.md
   • 书源规则示例：app/src/main/assets/defaultData/bookSources.json

核心概念

Legado插件通过JSON配置和JavaScript脚本扩展功能，主要包括：

• 书源规则：定义内容抓取方式
• 替换净化：处理文本内容
• UI主题：自定义界面样式
• 事件钩子：响应阅读行为

书源扩展：打造个性化内容库

书源是Legado的核心，通过自定义书源可以获取各类网络内容。以下是创建听书书源的完整示例。

书源配置结构

书源配置采用JSON格式，包含基本信息、请求规则和解析规则三部分。以"消消乐听书"为例：

{
  "bookSourceName": "消消乐听书",
  "bookSourceGroup": "听书",
  "bookSourceType": 1,
  "bookSourceUrl": "https://www.kaixin7days.com",
  "enabled": true,
  "exploreUrl": "@js:var header = JSON.parse(source.getLoginHeader())...",
  "ruleSearch": {
    "bookList": "$.content.content",
    "name": "$.title",
    "author": "$.author",
    "coverUrl": "$.cover@js:var cover = JSON.parse(result);'https://www.shuidi.online/fileMgt/getPicture?filePath='+cover.storeFilePath",
    "bookUrl": "$.id@js:java.put('bookId', result);'https://www.kaixin7days.com/book-service/bookMgt/getAllChapterByBookId,{ \"method\": \"POST\",\"body\": {\"bookId\": \"'+result+'\",\"pageNum\": \"1\",\"pageSize\": \"10000\"} }'"
  },
  "ruleToc": {
    "chapterList": "$.content.content",
    "chapterName": "$.chapterTitle",
    "chapterUrl": "$.id@js:java.put('chapterId', result);'https://www.shuidi.online/fileMgt/getAudioByChapterId?bookId=' + java.get('bookId') + '&chapterId=' + result + \"&pageNum=1&pageSize=50&keyId={{var header = JSON.parse(source.getLoginHeader());var keyId = '1632746188011002';var ks = java.md5Encode(keyId + java.get('chapterId') + header.Authorization);keyId + '&keySecret=' + ks}\" + '}'"
  }
}

关键配置说明

1. 基础信息：bookSourceName（名称）、bookSourceGroup（分组）、bookSourceType（类型：1为音频）
2. 探索规则：exploreUrl定义发现页内容，使用JavaScript处理登录和动态内容
3. 搜索规则：ruleSearch指定搜索结果的解析方式，支持JSONPath和JavaScript
4. 目录规则：ruleToc解析章节列表，通过JavaScript处理音频链接生成

导入与测试

1. 使用API导入书源：

POST http://127.0.0.1:1234/saveBookSource
Body: 书源JSON内容

2. 在应用内测试：
   • 搜索功能验证
   • 章节列表加载
   • 音频播放测试

UI自定义：打造专属阅读空间

Legado支持深度UI定制，从背景主题到字体样式，全方位打造个性化阅读环境。

主题配置

1. 内置主题：应用提供多种预设主题，位于modules/web/src/assets/imgs/themes/
2. 自定义主题：
   • 创建主题图片：尺寸建议1080x1920
   • 放置路径：Android/data/io.legado.app/files/background/
   • 应用主题：设置 → 阅读设置 → 背景 → 自定义

阅读界面定制

通过修改CSS自定义阅读样式：

1. 创建custom.css文件：

/* 自定义字体 */
body {
    font-family: "思源黑体", sans-serif;
    font-size: 18px;
    line-height: 1.8;
}

/* 夜间模式调整 */
.night-mode {
    background-color: #1a1a1a;
    color: #e0e0e0;
}

2. 放置路径：Android/data/io.legado.app/files/css/
3. 在设置中启用自定义CSS

交互优化

通过JavaScript脚本添加交互功能：

• 双击高亮
• 手势操作
• 语音控制

脚本放置路径：Android/data/io.legado.app/files/scripts/

功能整合：插件高级应用

将多个功能模块组合，实现复杂应用场景。以下是"智能阅读助手"插件的实现方案。

功能规划

1. 内容摘要：自动生成章节摘要
2. 生词本：收集阅读中遇到的生词
3. 进度同步：跨设备同步阅读进度

技术实现

1. 内容摘要：使用replaceRule调用第三方API处理文本：

{
  "name": "章节摘要",
  "group": "智能助手",
  "pattern": "(.*)",
  "replacement": "@js:fetch('https://api.example.com/summary', {method: 'POST', body: JSON.stringify({text: '$1'})}).then(r => r.json()).then(data => data.summary)",
  "scope": "content"
}

2. 生词本功能：

   • 使用onSelect事件钩子捕获选中文本
   • 调用词典API查询释义
   • 保存到本地数据库app/src/main/java/io/legado/app/data/entities/Book.kt

3. 进度同步：通过WebDAV实现跨设备同步：

// 保存进度
function saveProgress(bookId, position) {
    const header = JSON.parse(source.getLoginHeader());
    return java.connect('https://dav.example.com/legado/progress.json', {
        method: 'PUT',
        body: JSON.stringify({bookId, position, time: new Date().getTime()}),
        headers: header
    });
}

测试与部署

1. 本地测试：

   • 使用Web服务API调试：http://127.0.0.1:1234/testReplaceRule
   • 验证各功能模块交互

2. 打包发布：

   • 压缩插件文件为ZIP
   • 通过"本地导入"功能分享

总结与进阶

通过本文介绍的方法，你已掌握Legado插件开发的核心技能。进一步学习建议：

1. 深入API：探索Content Provider接口，实现应用间数据共享
2. 性能优化：学习书源缓存策略和异步加载技术
3. 社区交流：加入Telegram群组https://t.me/yueduguanfang分享作品

Legado的插件生态持续成长，期待你的创意为阅读体验带来更多可能！