automatic import of ros-humble-nebula-sample-decoders

3 files changed, 52 insertions, 46 deletions

diff --git a/.gitignore b/.gitignore
index 354f26c..7a05e06 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,2 @@
 /nebula-sample-decoders-1.2.0.tar.gz
+/nebula-sample-decoders-1.3.1-1.tar.gz
diff --git a/nebula-sample-decoders.spec b/nebula-sample-decoders.spec
index c916f96..2d90c5d 100644
--- a/nebula-sample-decoders.spec
+++ b/nebula-sample-decoders.spec
@@ -1,99 +1,104 @@
-# 禁止硬编码 distro/包名/版本——一律走宏（spec-rules-ros.md §2）
 %define ros_distro humble
 %define RosPkgName nebula-sample-decoders
-# 源码取自 tier4/nebula 仓库 main 分支 HEAD，记录 commit 以保证产物可追溯
-%global commit 8ce64073f41c2ec1166334ce7f8fb2edc13c86e5
+%define src_version 1.3.1-1
+# monorepo main 分支快照（无 tag），记录实际 commit 保证产物可追溯（§2）
+%global commit 8be1ed775b02985eadafe39b00e0e4fc944114e2
 
 Name:           ros-%{ros_distro}-%{RosPkgName}
-Version:        1.2.0
+Version:        1.3.1
 Release:        1%{?dist}
 Summary:        Nebula Sample Decoders Library
+# package.xml 声明 "Apache 2"，规范为 SPDX 标识
 License:        Apache-2.0
 URL:            https://github.com/tier4/nebula
-# #/ 强制重定向文件名为 nebula-sample-decoders-<version>.tar.gz，配合 autosetup -n 统一根目录名，
-# 消除 GitHub 归档根目录猜测风险（§2 Source0 归档解压目录名）
-Source0:        https://github.com/tier4/nebula/archive/%{commit}.tar.gz#/nebula-sample-decoders-%{version}.tar.gz
+Source0:        %{RosPkgName}-%{src_version}.tar.gz
 
-# /opt 前缀下 debug 子包无意义，统一关闭（§2）
+# debug 子包无意义（/opt 前缀，strip/debugedit 路径非常规），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）
+# ROS 包不做自动依赖扫描（.so 全在 /opt/ros 下，由 ament 间接依赖模型替代）
 %global __provides_exclude_from ^/opt/ros/%{ros_distro}/.*$
 %global __requires_exclude_from ^/opt/ros/%{ros_distro}/.*$
 
 BuildRequires:  cmake
 BuildRequires:  gcc-c++
-# ament_cmake 形态构建工具依赖（§5/§6）
+BuildRequires:  make
+# ament_cmake 形态构建工具（§6：build_type=ament_cmake，构建工具依赖 ros-humble-ament-cmake）
 BuildRequires:  ros-%{ros_distro}-ament-cmake
-# autoware_cmake 提供 autoware_package() 宏（ros-upstream.list，同 COPR 递归构建）
+# 提供 autoware_package() 宏（package.xml <buildtool_depend>autoware_cmake</buildtool_depend>，ros-upstream.list 真实存在）
 BuildRequires:  ros-%{ros_distro}-autoware-cmake
-# buildtool_depend：ros_environment 提供 ROS_DISTRO 环境变量
+# buildtool_depend ros_environment（ros-projects.list，SIG 已移植）
 BuildRequires:  ros-%{ros_distro}-ros-environment
-# package.xml <depend>：同仓 sibling 包，同 COPR 递归构建（§6 反幻觉铁律：
-# 均可在 siblings 清单或 ros-upstream.list 中找到依据）
+# package.xml <depend> —— nebula monorepo 兄弟子包（ros-upstream.list，batch reused，COPR project / additional_repos 同源解析）
 BuildRequires:  ros-%{ros_distro}-nebula-core-common
 BuildRequires:  ros-%{ros_distro}-nebula-core-decoders
 BuildRequires:  ros-%{ros_distro}-nebula-sample-common
+# 系统库（传递编译期依赖）：nebula_core_common 的 CMakeLists 有
+# ament_export_dependencies(Boost nlohmann_json)，sample_decoders 做
+# find_package(nebula_core_common) 时触发 find_dependency(Boost)；
+# 且 nebula_core_common 公共头 nebula_common.hpp 含 boost/tokenizer.hpp，
+# 经 sample_decoder.hpp -> nebula_core_common/point_types.hpp 头链可达。
+# pkg.remap 映射 boost->boost-devel，Boost::headers 为 header-only。
+# 注：本包 package.xml 未声明 boost（与 hesai/robosense decoders 不同），此处为传递依赖实证补入。
+BuildRequires:  boost-devel
 
-# 运行时 Requires：/opt/ros 被 __requires_exclude_from 豁免、autodeps 扫不到，必须手写（§6）
-# 弱依赖禁令：不得降级为 Recommends/Suggests（§6）
+# 运行时 Requires（§6 三件套：/opt/ros 被 __requires_exclude_from 豁免，autodeps 扫不到）
 Requires:       ros-%{ros_distro}-ros-workspace
 Requires:       ros-%{ros_distro}-ament-cmake
+# package.xml <depend> 的运行时部分（ROS 包提供 /opt/ros 下 .so，运行时须显式声明）
 Requires:       ros-%{ros_distro}-nebula-core-common
 Requires:       ros-%{ros_distro}-nebula-core-decoders
 Requires:       ros-%{ros_distro}-nebula-sample-common
 
-# 单包策略：禁止拆实体子包，改用虚拟别名兼容依赖方（§7）
+# 单包策略（§7）：ROS 包严禁拆实体子包，主包 %files 整树拥有，虚拟别名兼容依赖方
 Provides:       %{name}-devel = %{version}-%{release}
 Provides:       %{name}-doc = %{version}-%{release}
 Provides:       %{name}-runtime = %{version}-%{release}
 
 %description
-Nebula Sample Decoders Library — TIER IV Nebula 激光雷达驱动栈中的示例解码器库。
-提供 sample_decoder 共享库，作为 Nebula 解码器接口的参考实现，依赖 nebula_core_common、
-nebula_core_decoders 与 nebula_sample_common。构建自 tier4/nebula monorepo
-（包名：nebula_sample_decoders）。
+Nebula Sample Decoders Library —— Nebula 多 LiDAR 驱动框架中面向 Sample 平台的
+解码库，提供 Sample 平台点云数据的解码与扫描边界标记（tutorial 实现）。基于
+ament_cmake 构建（autoware_cmake 封装），产物安装至 /opt/ros/%{ros_distro}
+前缀。本包源自 tier4/nebula monorepo（commit 8be1ed77），仅构建其中的
+nebula_sample_decoders colcon 子包；monorepo 其余 colcon 包由各自独立 RPM 提供。
 
 %prep
-# #/ 强制重定向文件名，autosetup -n 统一根目录为 nebula-sample-decoders-<version>（§2）
-%autosetup -n %{RosPkgName}-%{version}
+%autosetup -n %{RosPkgName}-%{src_version}
 
 %build
-# ROS 基座环境引导：setup.sh 可能不存在，须用 [ -f ] 守卫（§4）
+# ROS 基座环境（§4：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_decoders
+# monorepo 子包构建：进入目标 colcon 包目录（§5 ament_cmake 显式 out-of-source，规避 openEuler %cmake 宏位置参数坑）
 cd src/nebula_sample/nebula_sample_decoders
-# ament_cmake 形态：显式 out-of-source 构建，避免 openEuler %cmake 宏位置参数坑（§3/§5/§9）
-# 禁用测试优先转构建参数：-DBUILD_TESTING=OFF（§5）
 mkdir -p .obj && cd .obj
-cmake \
-  -DCMAKE_INSTALL_PREFIX="/opt/ros/%{ros_distro}" \
-  -DAMENT_PREFIX_PATH="/opt/ros/%{ros_distro}" \
-  -DCMAKE_PREFIX_PATH="/opt/ros/%{ros_distro}" \
-  -UINCLUDE_INSTALL_DIR -ULIB_INSTALL_DIR -USYSCONF_INSTALL_DIR -USHARE_INSTALL_PREFIX -ULIB_SUFFIX \
-  -DSETUPTOOLS_DEB_LAYOUT=OFF \
-  -DBUILD_TESTING=OFF \
-  ..
-%make_build
+%cmake3 \
+    -DCMAKE_INSTALL_PREFIX="/opt/ros/%{ros_distro}" \
+    -DAMENT_PREFIX_PATH="/opt/ros/%{ros_distro}" \
+    -DCMAKE_PREFIX_PATH="/opt/ros/%{ros_distro}" \
+    -UINCLUDE_INSTALL_DIR -ULIB_INSTALL_DIR -USYSCONF_INSTALL_DIR -USHARE_INSTALL_PREFIX -ULIB_SUFFIX \
+    -DSETUPTOOLS_DEB_LAYOUT=OFF \
+    -DBUILD_TESTING=OFF -DTESTING=OFF -DCMAKE_SUPPRESS_REGENERATION=ON \
+    ..
+make %{?_smp_mflags}
 
 %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_decoders
+cd .obj
+make install DESTDIR=%{buildroot}
 
-cd src/nebula_sample/nebula_sample_decoders/.obj
-%make_install DESTDIR=%{buildroot}
-
+# 文件清单整树拥有（§7：单包策略，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-decoders
-- Version 取自 manifest target_version 1.2.0；源码为 tier4/nebula main 分支 HEAD（commit 8ce6407）
+* Wed Oct 21 2026 ai-importer <ai-importer@openeuler.org> - 1.3.1-1
+- Initial import (ROS batch)
+- 源自 tier4/nebula monorepo，commit 8be1ed775b02985eadafe39b00e0e4fc944114e2
+- ament_cmake 形态（autoware_cmake 封装），构建至 /opt/ros/humble 前缀
diff --git a/sources b/sources
index 9560224..2697276 100644
--- a/sources
+++ b/sources
@@ -1 +1 @@
-39397b43a9295d5c0f48be6ceb922e04  nebula-sample-decoders-1.2.0.tar.gz
+65676cdca59a22302d0d4dadedb46824  nebula-sample-decoders-1.3.1-1.tar.gz