Glazier 项目技术文档

1. 安装指南

1.1 系统要求

• 64位 Windows 7 及以上版本（推荐 Windows 10）。
• 建议使用专用的构建机器或虚拟机（VM）。
• 确保系统已安装所有 Windows 更新，并重启直到没有更多更新。

1.2 安装依赖

1. 打开管理员权限的 PowerShell 控制台。
2. 执行以下命令安装依赖：

   mkdir C:\relax\
   cd C:\relax\
   Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
   choco feature enable -n allowGlobalConfirmation
   choco install git
   git config --global core.autocrlf false
   git clone https://github.com/apache/couchdb-glazier
   &.\couchdb-glazier\bin\install_dependencies.ps1
   

3. 安装过程可能需要超过一小时，建议在此期间进行其他活动。

1.3 安装完成后的检查

• 确保以下软件已安装：
  • Visual Studio 2022（Build Tools、Visual C++ 工作负载、本地桌面工作负载）
  • Windows 10 SDK
  • NodeJS（LTS 版本）
  • WiX Toolset 3.14
  • Python 3
  • NSSM
  • GNU make
  • NuGet
  • VSSetup
  • VSWhere
  • GNU CoreUtils
  • MSYS2
  • Java
  • VCPkg（已安装 ICU 和 OpenSSL 3）
  • SpiderMonkey 91

2. 项目的使用说明

2.1 构建 CouchDB

1. 打开新的 PowerShell 窗口。
2. 设置 shell 环境：

   &c:\relax\couchdb-glazier\bin\shell.ps1
   

3. 开始构建 CouchDB：

   cd c:\relax
   git clone https://github.com/apache/couchdb
   cd couchdb
   git checkout <tag or branch of interest goes here>
   &.\configure.ps1 -SpiderMonkeyVersion 91
   make -f Makefile.win
   

4. 构建完成后，可以运行测试：

   make -f Makefile.win check
   

5. 构建 CouchDB 安装程序：

   make -f Makefile.win release
   cd c:\relax
   &couchdb-glazier\bin\build_installer.ps1
   

2.2 下载和提取 CouchDB 源码包

• 使用 download_extract_rc.ps1 脚本下载和提取 CouchDB 源码包：

  C:\relax\couchdb-glazier\bin\download_extract_rc.ps1 -CouchDBVersion <版本号> -ReleaseCandidate <RC版本号> -Path <存储路径>
  

3. 项目API使用文档

3.1 下载和提取 CouchDB 源码包

• 语法:

  C:\relax\couchdb-glazier\bin\download_extract_rc.ps1 [[-CouchDBVersion] <String>] [[-ReleaseCandidate] <String>] [[-Path] <String>] [<CommonParameters>]
  

• 描述:
  • 该命令用于下载、校验和提取 CouchDB 源码包。
  • -CouchDBVersion: CouchDB 版本号（例如 3.4.2）。
  • -ReleaseCandidate: 发布候选版本号（例如 rc1）。
  • -Path: 存储工件的目录（例如 C:\relax\releases）。

3.2 校验源码包

• 使用以下命令校验源码包：

  checksum -t sha256 apache-couchdb.#.#.#-RC#.tar.gz
  checksum -t sha512 apache-couchdb.#.#.#-RC#.tar.gz
  gpg --verify apache-couchdb.#.#.#-RC#.tar.gz.asc
  

4. 项目安装方式

4.1 静默安装 CouchDB

• 安装 CouchDB 但不作为服务运行，并设置管理员用户和密码：

  msiexec /i apache-couchdb-3.0.0.msi /quiet ADMINUSER=admin ADMINPASSWORD=hunter2 /norestart
  

• 安装 CouchDB 并作为服务运行：

  msiexec /i apache-couchdb-3.0.0.msi /quiet INSTALLSERVICE=1 ADMINUSER=admin ADMINPASSWORD=hunter2 /norestart
  

4.2 静默卸载 CouchDB

• 卸载 CouchDB：

  msiexec /x apache-couchdb-3.0.0.msi /quiet /norestart
  

• 如果安装程序文件不可用，使用 GUID 卸载：

  msiexec /x {4CD776E0-FADF-4831-AF56-E80E39F34CFC} /quiet /norestart
  

4.3 生成日志文件

• 在任何安装或卸载命令后添加 /l* log.txt 以生成调试日志文件。

---

通过以上步骤，您可以顺利安装、构建和使用 Glazier 项目来简化 CouchDB 在 Windows 上的构建过程。