diff options
Diffstat (limited to 'nebula-sample-hw-interfaces.spec')
| -rw-r--r-- | nebula-sample-hw-interfaces.spec | 132 |
1 files changed, 70 insertions, 62 deletions
diff --git a/nebula-sample-hw-interfaces.spec b/nebula-sample-hw-interfaces.spec index 80486ac..b2a36b7 100644 --- a/nebula-sample-hw-interfaces.spec +++ b/nebula-sample-hw-interfaces.spec @@ -1,77 +1,89 @@ -# 禁止硬编码 distro/包名/版本——一律走宏（spec-rules-ros.md §2） +# SPDX spec: nebula-sample-hw-interfaces (ROS 2 humble) +# 依据 /app/.claude/skills/build-rpm/spec-rules-ros.md 生成 +# 关键决策记录（便于后续构建诊断循环回溯）： +# 1. 包名纪律：package.xml name=nebula_sample_hw_interfaces，RPM 名经 _→- 归一化为 +# ros-humble-nebula-sample-hw-interfaces（与 siblings/ros-upstream.list/SIG 惯例三方一致）。 +# 2. Version：manifest target_version=1.3.1-1，剥离发布号 -1 -> 1.3.1。 +# 3. ref_type 为空=默认 branch main 拉取。为可追溯性，用 HEAD commit 归档： +# commit 宏=8be1ed77...（ros_fetch shallow clone HEAD，commitdate 2026-10-20）。 +# 4. Source0 归档根目录名【实测】：GitHub archive sha.tar.gz 在本仓库解压为 +# nebula-full-sha（非纯 SHA，§2 已警告不可一概而论）。用 hash-slash 强制 rpm 内部文件名 + +# autosetup 的 -n 取 nebula-commit 双保险。 +# 5. 构建：ament_cmake 形态，monorepo 子包路径 src/nebula_sample/nebula_sample_hw_interfaces， +# 显式 out-of-source（§5：禁止顶层 cmake 宏位置参数坑）。 +# 6. 依赖（manifest 依赖字段全空，从 package.xml 推导 + ros-upstream.list 实证）： +# - autoware_cmake (buildtool_depend)：ros-upstream.list 有据（autowarefoundation/ +# autoware_cmake.git 1.4.0-1），SIG 未移植 -> registered_deps 空 -> 照写 BuildRequires， +# 由 verify_spec_requires.py --register-missing 递归引入（§6 处置①，不静默丢弃）。 +# - nebula_core_common / nebula_core_hw_interfaces / nebula_sample_common (depend)： +# ros-upstream.list 有据（同 monorepo tier4/nebula），且为 siblings 同 COPR 同源解析。 +# 7. 运行时 Requires 三件套（§6，/opt/ros 被 autodeps 豁免必须手写）+ exec_depend。 + %define ros_distro humble %define RosPkgName nebula-sample-hw-interfaces -# 源码取自 tier4/nebula 仓库 main 分支 HEAD，记录 commit 以保证产物可追溯 -%global commit 8ce64073f41c2ec1166334ce7f8fb2edc13c86e5 +%global commit 8be1ed775b02985eadafe39b00e0e4fc944114e2 -Name: ros-%{ros_distro}-%{RosPkgName} -Version: 1.2.0 -Release: 1%{?dist} -Summary: Nebula Sample HW Interfaces -License: Apache-2.0 -URL: https://github.com/tier4/nebula -# 实测 GitHub commit 归档解压根目录为 nebula-<完整SHA>，autosetup -n 须匹配 -# （spec-rules-ros.md §2 Source0 归档解压目录名：实测优先，消除猜测） -Source0: https://github.com/tier4/nebula/archive/%{commit}.tar.gz +Name: ros-%{ros_distro}-%{RosPkgName} +Version: 1.3.1 +Release: 1%{?dist} +Summary: Nebula Sample HW Interfaces +License: Apache-2.0 +URL: https://github.com/tier4/nebula +# commit 归档；hash-slash 强制 rpm 内部文件名，autosetup 的 -n 匹配实测根目录 nebula-sha +Source0: https://github.com/tier4/nebula/archive/%{commit}.tar.gz#/nebula-%{commit}.tar.gz -# /opt 前缀下 debug 子包无意义，统一关闭（§2） +# /opt 前缀下 debug 子包无意义，SIG 模板统一关闭 %global debug_package %{nil} -# 摘掉 brp-python-bytecompile，避免 /opt 下 Python 字节码写入标准 sitelib（§2） +# /opt 下 python 字节码会写标准 sitelib 路径，摘掉 brp-python-bytecompile %global __os_install_post %(echo '%{__os_install_post}' | sed -e 's!/usr/lib[^[:space:]]*/brp-python-bytecompile[[:space:]].*$!!g') -# ROS 包不做自动依赖扫描，由 ament 间接依赖模型替代（§2） +# .so 全在 /opt/ros 下，由 ament 间接依赖模型替代自动扫描 %global __provides_exclude_from ^/opt/ros/%{ros_distro}/.*$ %global __requires_exclude_from ^/opt/ros/%{ros_distro}/.*$ -# 构建工具依赖（buildtool_depend: autoware_cmake + ament_cmake 形态基座，§5/§6） -BuildRequires: cmake -BuildRequires: gcc-c++ -BuildRequires: ros-%{ros_distro}-ament-cmake -# autoware_cmake 提供 autoware_package() 宏（ros-upstream.list:186，同 COPR 递归构建） -BuildRequires: ros-%{ros_distro}-autoware-cmake -# buildtool 链：ros_environment 提供 ROS_DISTRO 环境变量（ros-projects.list:748） -BuildRequires: ros-%{ros_distro}-ros-environment -# package.xml <depend>：同仓 sibling 包，同 COPR 递归构建（§6 反幻觉铁律： -# 均可在 ros-upstream.list 中找到依据） -BuildRequires: ros-%{ros_distro}-nebula-core-common -BuildRequires: ros-%{ros_distro}-nebula-core-hw-interfaces -BuildRequires: ros-%{ros_distro}-nebula-sample-common +BuildRequires: cmake +BuildRequires: gcc-c++ +BuildRequires: make +# ament_cmake 形态构建工具（§6），ros-projects.list 有据 +BuildRequires: ros-%{ros_distro}-ament-cmake +# package.xml <buildtool_depend> autoware_cmake；ros-upstream.list 有据，SIG 未移植， +# 照写让 register-missing 递归引入（§6 处置①，不静默丢弃） +BuildRequires: ros-%{ros_distro}-autoware-cmake +# package.xml <depend>：同 monorepo sibling，ros-upstream.list 有据，同 COPR 同源解析 +BuildRequires: ros-%{ros_distro}-nebula-core-common +BuildRequires: ros-%{ros_distro}-nebula-core-hw-interfaces +BuildRequires: ros-%{ros_distro}-nebula-sample-common -# 运行时 Requires：/opt/ros 被 __requires_exclude_from 豁免、autodeps 扫不到，必须手写（§6） -# 弱依赖禁令：不得降级为 Recommends/Suggests（§6） -Requires: ros-%{ros_distro}-ros-workspace -Requires: ros-%{ros_distro}-ament-cmake -# package.xml <depend>（build+exec 双态）映射为运行时依赖 -Requires: ros-%{ros_distro}-nebula-core-common -Requires: ros-%{ros_distro}-nebula-core-hw-interfaces -Requires: ros-%{ros_distro}-nebula-sample-common +# 运行时 Requires 三件套（§6，/opt/ros 被豁免 autodeps 扫不到必须手写） +Requires: ros-%{ros_distro}-ros-workspace +Requires: ros-%{ros_distro}-ament-cmake +# package.xml <depend> 的 exec 语义 -> Requires +Requires: ros-%{ros_distro}-nebula-core-common +Requires: ros-%{ros_distro}-nebula-core-hw-interfaces +Requires: ros-%{ros_distro}-nebula-sample-common -# 单包策略：禁止拆实体子包，改用虚拟别名兼容依赖方（§7） -Provides: %{name}-devel = %{version}-%{release} -Provides: %{name}-doc = %{version}-%{release} -Provides: %{name}-runtime = %{version}-%{release} +# 虚拟别名兼容依赖方（§7 单包策略，禁拆实体 devel 子包避免路径重叠） +Provides: %{name}-devel = %{version}-%{release} +Provides: %{name}-doc = %{version}-%{release} +Provides: %{name}-runtime = %{version}-%{release} %description -Nebula Sample HW Interfaces — TIER IV Nebula 激光雷达驱动栈中 Sample 传感器的 -硬件接口库。提供 nebula_sample_hw_interfaces 共享库，封装 Sample 驱动的硬件 -交互层，依赖 nebula_core_common、nebula_core_hw_interfaces 与 nebula_sample_common。 -构建自 tier4/nebula monorepo（package.xml 名称：nebula_sample_hw_interfaces）。 +Nebula Sample HW Interfaces — the sample hardware interface package from the +TIER IV nebula LiDAR driver monorepo (ROS 2 %{ros_distro}). %prep -# 实测确认 GitHub commit 归档解压根目录为 nebula-<完整SHA>，autosetup -n 须匹配（§2） %autosetup -n nebula-%{commit} %build -# ROS 基座环境引导：setup.sh 可能不存在，须用 [ -f ] 守卫（§4） +# monorepo 子包路径（相对归档根 nebula-<commit>/） +cd src/nebula_sample/nebula_sample_hw_interfaces +# ROS 基座环境（chroot 已配 ROS SIG repo；无 ROS 依赖的 buildroot 可能无 setup.sh，用 [ -f ] 守卫） [ -f /opt/ros/%{ros_distro}/setup.sh ] && source /opt/ros/%{ros_distro}/setup.sh || true export PYTHONPATH=/opt/ros/%{ros_distro}/lib/python%{python3_version}/site-packages${PYTHONPATH:+:$PYTHONPATH} export PKG_CONFIG_PATH=/opt/ros/%{ros_distro}/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH} - -# monorepo 子包目录：src/nebula_sample/nebula_sample_hw_interfaces -cd src/nebula_sample/nebula_sample_hw_interfaces -# ament_cmake 形态：显式 out-of-source 构建，避免 openEuler %cmake 宏位置参数坑（§3/§5/§9） -# 禁用测试优先转构建参数：-DBUILD_TESTING=OFF（§5） -mkdir -p .obj && cd .obj -cmake \ +# 显式 out-of-source（§5：openEuler 顶层 cmake 宏带位置参数会错误解析源码目录，build 444 实踩） +mkdir -p .obj +cd .obj +%cmake3 \ -DCMAKE_INSTALL_PREFIX="/opt/ros/%{ros_distro}" \ -DAMENT_PREFIX_PATH="/opt/ros/%{ros_distro}" \ -DCMAKE_PREFIX_PATH="/opt/ros/%{ros_distro}" \ @@ -82,19 +94,15 @@ cmake \ %make_build %install -# ROS 基座环境：ament install hooks 需要（§4） -[ -f /opt/ros/%{ros_distro}/setup.sh ] && source /opt/ros/%{ros_distro}/setup.sh || true -export PYTHONPATH=/opt/ros/%{ros_distro}/lib/python%{python3_version}/site-packages${PYTHONPATH:+:$PYTHONPATH} -export PKG_CONFIG_PATH=/opt/ros/%{ros_distro}/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH} - cd src/nebula_sample/nebula_sample_hw_interfaces/.obj %make_install DESTDIR=%{buildroot} +# §7：整树拥有 /opt/ros/<distro>，对"装了没打包"类错误免疫；不逐目录精确列避免重叠 %files -# 整树拥有 /opt/ros/<distro>，对"装了没打包"类错误免疫（§7） /opt/ros/%{ros_distro} %changelog -* Thu Oct 08 2026 AI Importer <ai-importer@openeuler.org> - 1.2.0-1 -- 初始引入 ros-humble-nebula-sample-hw-interfaces -- Version 取自 manifest target_version 1.2.0；源码为 tier4/nebula main 分支 HEAD（commit 8ce6407） +* Wed Oct 21 2026 ROS AI Importer <ros-sig@openeuler.org> - 1.3.1-1 +- Initial packaging of ros-humble-nebula-sample-hw-interfaces (autoref 8be1ed77). +- Source: https://github.com/tier4/nebula (monorepo, subpath src/nebula_sample/nebula_sample_hw_interfaces). +- Build deps: autoware-cmake + nebula core/sample siblings (ros-upstream.list verified). |