Skip to content

安装指南

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:

  1. 从官方发布页面下载最新的 Chaterm-[版本]-setup.exe
  2. 运行安装程序并按照屏幕上的指示操作
  3. Chaterm 默认会创建桌面快捷方式,以便轻松访问 来源:electron-builder.yml#L37-L41

macOS 安装

macOS 用户有两种安装选项:

  1. DMG 安装(推荐):
  • 为您的架构下载适当的 chaterm-[版本]-[架构].dmg 文件(Intel Macs 使用 x64,Apple Silicon 使用 arm64)
  • 打开 DMG 文件
  • 将 Chaterm 应用程序拖到您的应用程序文件夹中
  1. ZIP安装
  • 为您的架构下载 chaterm-[版本]-[架构].zip 文件
  • 解压 ZIP 文件
  • 将解压后的 Chaterm 应用程序移动到您的应用程序文件夹中

Linux 安装

Linux 用户有两种安装选项:

  1. AppImage(通用):
  • 下载 chaterm-[版本]-[架构].AppImage 文件
  • 使用以下命令使其可执行: chmod +x chaterm-[版本]-[架构].AppImage
  • 直接运行:./chaterm-[版本]-[架构].AppImage
  1. 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 来更改图标文件
  • 应用程序名称和标识符
  • 文件压缩设置
  • 每个平台的目标架构