# fastdds-repo

**Repository Path**: codepee/fastdds-repo

## Basic Information

- **Project Name**: fastdds-repo
- **Description**: REPO FOR FASTDDS
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-17
- **Last Updated**: 2026-01-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Fast DDS 仓库构建脚本

本仓库包含用于构建和配置 Fast DDS（Fast Data Distribution Service）的脚本集合。Fast DDS 是一个高性能的 DDS（Data Distribution Service）实现，广泛应用于机器人系统和实时分布式系统。

参考[官方链接](https://fast-dds.docs.eprosima.com/en/latest/installation/sources/sources_linux.html)

## 项目结构

```shell

Fastdds-repo/
    fastdds.repos   # fastdds相关数据源，提供给vcs获取使用
    script/         # 构建脚本
    src/            # 存放代码目录
```

### 脚本说明

可按脚本介绍顺序运行相应脚本。部分脚本可能需要`sudo`权限

#### `script/replace-apt-source.sh`
APT 源替换脚本，用于配置系统软件源。支持`Ubuntu`大部分版本自动识别与替换，需要 `sudo` 权限，修改 `/etc/apt` 目录中文件内容或创建新文件。

#### `script/install-depencies.sh`
依赖安装脚本，负责安装 Fast DDS 构建所需的系统依赖包。支持使用 SUDO 权限运行。

#### `script/pull-source-code.sh`
使用vcs工具克隆`fastdds`、`fastcdr`等源代码以及依赖库源代码，存放入 `src` 目录。

#### `script/build-with-colcon.sh`
使用 `colcon` 构建 Fast DDS 的脚本。Colcon 是 ROS 2 的构建工具，支持多种构建类型和测试选项。

#### `script/build-with-cmake.sh`
使用 `cmake` 构建 Fast DDS 的脚本，并自动将 `LD_LIBRARY_PATH`、`PATH` 写入 `~/.bashrc` 环境中。必要时需要手动 `source ~/.bashrc` 进行环境变量更新。支持 `-u` 实现非构建更新，详细查看 `build-with-cmake.sh -h`。


## 快速开始

### 环境要求
- Ubuntu 24.04 或兼容的 Linux 发行版
- Git
- CMake
- Python 3

### 安装步骤

1. **克隆仓库**
```bash
git clone https://gitee.com/codepee/fastdds-repo.git
cd fastdds-repo
```

2. **配置 APT 源（如需要）**
```bash
chmod +x ./script/replace-apt-source.sh
./script/replace-apt-source.sh
```

3. **安装系统依赖**
```bash
chmod +x ./script/install-depencies.sh
./script/install-depencies.sh
```

4. **拉取代码**
```bash
chmod +x ./script/pull-source-code.sh
./script/pull-source-code.sh
```

5. **构建项目**
```bash
chmod +x ./script/build-with-cmake.sh
./script/build-with-cmake.sh
```

## 主要功能

- **自动化构建**: 使用 colcon 自动化 Fast DDS 的编译过程
- **依赖管理**: 自动安装所有必要的构建依赖
- **源配置优化**: 提供 APT 源配置优化选项
- **仓库版本管理**: 通过 `.repos` 文件管理依赖仓库版本

## 常见问题

### 构建失败
如果构建过程中遇到问题，请检查：
1. 系统依赖是否完整安装
2. Git 配置是否正确
3. 磁盘空间是否充足

### 权限问题
确保以适当权限运行脚本，必要时使用 `sudo`。

## 许可证

本项目遵循相应的开源许可证协议。

## 贡献指南

欢迎通过 Issue 或 Pull Request 贡献代码。

## 参考资料

- [Fast DDS 官方文档](https://fast-dds.docs.eprosima.com/)
- [ROS 2 文档](https://docs.ros.org/)
- [eProsima 官网](https://www.eprosima.com/)