Sozi项目技术文档

1. 安装指南

获取源文件

首先，您需要克隆项目仓库：

git clone git://github.com/sozi-projects/Sozi.git

安装构建工具和依赖

以下指导在Ubuntu 22.04中测试成功。

安装Node.js和Gulp。Sozi的构建脚本已知与Nodesource提供的Node.js 14兼容。

sudo apt install nodejs
sudo npm install --global gulp-cli

在源代码树的根目录下，运行：

npm install

如果您计划构建Windows可执行文件，还需要安装wine。在Debian/Ubuntu及其衍生版本中，可以执行以下命令：

dpkg --add-architecture i386
sudo apt update
sudo apt install wine wine32

如果您计划构建Debian包，需要安装以下附加包：

sudo apt install devscripts debhelper

如果您计划构建Redhat包，需要安装以下附加包：

sudo apt install rpm

如果您计划构建Archlinux包，需要安装以下附加包：

sudo apt install libarchive-tools

还必须安装zip压缩工具：

sudo apt install zip

获取ffmpeg的二进制文件（可选，但如果没有，视频导出功能将无法使用）。下载并解压ffmpeg可执行文件到以下文件夹：

• Linux 32位: resources/ffmpeg/linux-ia32
• Linux 64位: resources/ffmpeg/linux-x64
• Windows 32位: resources/ffmpeg/win32-ia32
• Windows 64位: resources/ffmpeg/win32-x64
• MacOS X 64位: resources/ffmpeg/darwin-x64

构建

要构建并运行不打包的桌面应用程序，请在源代码树的根目录下运行以下命令。启动时，Sozi会显示一个错误通知，可以忽略。

gulp
npm start

要构建并打包桌面应用程序以供所有平台使用，请执行：

gulp all

成功构建后，您将得到一个build/dist文件夹，其中包含了为每个平台生成的应用程序存档。

2. 项目使用说明

运行构建后的应用程序，可以通过以下命令启动Sozi并打开SVG文档：

sozi my-presentation.svg

在Sozi运行期间，按下F12键可以打开开发者工具，检查“控制台”选项卡中的错误消息。

3. 项目API使用文档

目前Sozi项目主要作为桌面应用程序使用，不提供独立的API接口。若需与Sozi交互，请参考项目的源代码或通过开发者工具在运行时进行调试。

4. 项目安装方式

请参考上述“安装指南”部分进行项目安装。根据您的操作系统和需求选择适当的安装步骤和依赖。