Extendables 技术文档

1. 安装指南

Extendables 是一个为 Adobe ExtendScript 开发的 MIT 许可开发者框架。尽管目前该项目处于未维护状态，且不能保证其与最新版本的 Creative Suite 和 ExtendScript 兼容，但它仍然可以为需要编写复杂自动化脚本的用户提供帮助。

1.1 环境要求

• Adobe Creative Suite 应用程序（如 InDesign）
• ExtendScript 工具

1.2 安装步骤

1. 下载 Extendables 项目文件。
2. 将项目文件放置在您的 ExtendScript 项目目录中。
3. 在您的 ExtendScript 脚本中引入 Extendables 库：

   #include "Extendables.jsx"
   

2. 项目的使用说明

Extendables 提供了三大功能模块，帮助开发者更高效地编写 ExtendScript 脚本。

2.1 内置对象扩展

Extendables 为 JavaScript 的内置对象（如 String 和 Array）添加了额外的功能，包括：

• JavaScript 1.8 特性（如 forEach）
• 函数式编程的便捷方法（如 map、reduce、filter）
• JSON 和 base64 序列化功能

2.2 InDesign DOM 对象扩展

Extendables 为 InDesign 的 DOM 对象提供了额外的功能，使得在 InDesign 中编写代码更加简洁。

2.3 功能包

Extendables 还提供了多个功能包，包括：

• 日志记录
• 单元测试
• HTTP 请求
• 用户界面开发

3. 项目API使用文档

3.1 内置对象扩展 API

• String.prototype.forEach(callback)：对字符串的每个字符执行回调函数。
• Array.prototype.map(callback)：返回一个新数组，其中每个元素都是回调函数的返回值。
• Array.prototype.reduce(callback, initialValue)：将数组缩减为一个值。

3.2 InDesign DOM 对象扩展 API

• Document.prototype.createPage(options)：在文档中创建新页面。
• TextFrame.prototype.getText()：获取文本框中的文本内容。

3.3 功能包 API

• Logger.log(message)：记录日志信息。
• TestRunner.run(tests)：运行单元测试。
• HTTP.get(url)：发送 GET 请求。

4. 项目安装方式

Extendables 的安装方式非常简单，只需将项目文件引入到您的 ExtendScript 项目中即可。具体步骤如下：

1. 下载 Extendables 项目文件。
2. 将项目文件放置在您的 ExtendScript 项目目录中。
3. 在您的 ExtendScript 脚本中引入 Extendables 库：

   #include "Extendables.jsx"
   

通过以上步骤，您就可以开始使用 Extendables 提供的丰富功能，简化您的 ExtendScript 开发流程。