PassiveLogic Swift开发工具链镜像文档

镜像概述和主要用途

PassiveLogic Swift开发工具链镜像是为Swift开发者设计的专用Docker镜像，基于***Swift镜像构建，集成了PassiveLogic开发所需的特定工具和依赖。该镜像旨在提供一致、高效的Swift开发环境，简化项目的环境配置流程，确保开发者能够快速投入开发工作。

核心功能和特性

完整的Swift工具链

包含Swift编译器（swiftc）、Swift包管理器（SwiftPM）、调试工具（lldb）等核心组件，支持Swift项目的编译、打包与调试。

集成PassiveLogic开发依赖

预装PassiveLogic项目开发所需的特定库、工具和配置文件，无需手动安装额外依赖。

多版本支持

提供不同Swift版本的镜像标签（如5.7、5.8、latest），适配不同项目的版本需求。

轻量级设计

基于Alpine或Debian slim基础镜像构建，减少镜像体积，提升容器启动速度。

即开即用

内置标准化开发环境配置，无需额外调整即可快速投入开发，确保团队环境一致性。

使用场景和适用范围

PassiveLogic内部开发

适用于PassiveLogic团队成员进行Swift项目的日常开发、调试和测试。

第三方协作

方便第三方开发者参与PassiveLogic开源或合作项目时快速搭建一致的开发环境。

CI/CD集成

可集成到自动化构建流程中，用于Swift项目的持续集成、测试和部署。

教学与演示

作为标准化的Swift开发环境示例，用于技术培训或项目演示。

使用方法和配置说明

拉取镜像

从Docker仓库拉取指定版本的镜像：

bash
# 拉取最新版本
docker pull passivelogic/swift-toolchain:latest

# 拉取特定版本（如Swift 5.8）
docker pull passivelogic/swift-toolchain:5.8

基本使用（docker run）

以交互模式运行容器，并挂载本地项目目录：

bash
# 运行容器并进入交互终端
docker run -it --rm -v $(pwd):/app passivelogic/swift-toolchain:latest /bin/bash

# 在容器内编译项目
cd /app
swift build

# 运行项目
swift run

参数说明：

• -it：启用交互模式并分配终端
• --rm：容器退出后自动删除
• -v $(pwd):/app：将当前目录挂载到容器内/app目录

Docker Compose配置

创建docker-compose.yml文件集成到项目中：

yaml
version: '3'
services:
  swift-dev:
    image: passivelogic/swift-toolchain:5.8
    volumes:
      - ./:/app  # 挂载项目目录
    working_dir: /app  # 设置工作目录
    command: swift run  # 启动命令（可自定义）

启动服务：

bash
docker-compose up

自定义配置

如需修改工具链配置，可通过挂载自定义配置文件覆盖容器内默认配置：

bash
# 挂载本地配置文件到容器
docker run -it --rm -v $(pwd):/app -v $(pwd)/custom-config:/etc/swift-config passivelogic/swift-toolchain:latest

注意事项

• 确保本地Docker环境已正确安装并运行
• 挂载目录时需注意文件权限，避免容器内无法访问项目文件
• 不同版本镜像的工具链特性可能存在差异，需根据项目需求选择对应标签