安装指南
Chaterm 提供多种安装选项,以适应不同的开发环境和用户偏好。本指南概述了在您的系统上设置 Chaterm 的所有可用方法,无论您是参与项目的开发者还是希望使用该应用程序的最终用户。
配置要求
在安装 Chaterm 之前,请确保您的系统满足以下要求:
操作系统:
- Windows 10/11
- macOS 10.15(Catalina)或更高版本(支持 Intel 和 Apple Silicon)
- Linux(基于 Debian/Ubuntu 的发行版和其他支持 AppImage 的发行版)
硬件:
- 最低 4GB RAM(推荐 8GB)
- 1GB 可用存储空间
开发要求(仅针对开发者):
- Node.js 16.x 或更高版本
- npm 7.x 或更高版本
下载安装
Chaterm 根据您的操作系统以不同格式分发。请选择以下适当的方法。
Windows 安装
Windows 用户可以使用 NSIS 安装包安装 Chaterm:
- 从官方发布页面下载最新的 Chaterm-[版本]-setup.exe
- 运行安装程序并按照屏幕上的指示操作
- Chaterm 默认会创建桌面快捷方式,以便轻松访问 来源:electron-builder.yml#L37-L41
macOS 安装
macOS 用户有两种安装选项:
- DMG 安装(推荐):
- 为您的架构下载适当的 chaterm-[版本]-[架构].dmg 文件(Intel Macs 使用 x64,Apple Silicon 使用 arm64)
- 打开 DMG 文件
- 将 Chaterm 应用程序拖到您的应用程序文件夹中
- ZIP安装:
- 为您的架构下载 chaterm-[版本]-[架构].zip 文件
- 解压 ZIP 文件
- 将解压后的 Chaterm 应用程序移动到您的应用程序文件夹中
Linux 安装
Linux 用户有两种安装选项:
- AppImage(通用):
- 下载 chaterm-[版本]-[架构].AppImage 文件
- 使用以下命令使其可执行: chmod +x chaterm-[版本]-[架构].AppImage
- 直接运行:./chaterm-[版本]-[架构].AppImage
- Debian/Ubuntu 包:
- 下载 chaterm-[版本]-[架构].deb 文件
- 使用以下命令安装: sudo dpkg -i chaterm-[版本]-[架构].deb 或通过您的包管理器安装
源码安装
设置环境
1. 克隆仓库:
sh
git clone https://github.com/chaterm/Chaterm.git
cd Chaterm
2. 配置 npm :
sh
# 更新 npm 注册表
npm config set registry https://registry.npmmirror.com
# 编辑 npm 配置
npm config edit
# 在文件末尾添加以下行:
electron_mirror=https://cdn.npmmirror.com/binaries/electron/
electron_builder_binaries_mirror=https://npmmirror.com/mirrors/electron-builder-binaries/
3. 安装依赖:
sh
node scripts/patch-package-lock.js
npm install
源码构建
您可以为任何受支持的平台从源代码构建 Chaterm:
sh
# 用于Windows
npm run build:win
# 用于macOS
npm run build:mac
# 用于Linux
npm run build:linux
# 未打包构建(用于测试)
npm run build:unpack
自定义构建
高级开发者可以通过修改 electron-builder.yml 文件来自定义构建过程。此配置控制:
- 文件包含/排除规则
- 应用程序元数据
- 平台特定设置
- 打包格式
- 资源处理
例如,您可以自定义:
- 通过替换 resources/icon.ico 和 resources/icon.icns 来更改图标文件
- 应用程序名称和标识符
- 文件压缩设置
- 每个平台的目标架构