# 禁止硬编码 distro/包名/版本——一律走宏（spec-rules-ros.md §2）
%define ros_distro humble
%define RosPkgName nebula-sample-hw-interfaces
# 源码取自 tier4/nebula 仓库 main 分支 HEAD，记录 commit 以保证产物可追溯
%global commit 8ce64073f41c2ec1166334ce7f8fb2edc13c86e5

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

# /opt 前缀下 debug 子包无意义，统一关闭（§2）
%global debug_package %{nil}
# 摘掉 brp-python-bytecompile，避免 /opt 下 Python 字节码写入标准 sitelib（§2）
%global __os_install_post %(echo '%{__os_install_post}' | sed -e 's!/usr/lib[^[:space:]]*/brp-python-bytecompile[[:space:]].*$!!g')
# ROS 包不做自动依赖扫描，由 ament 间接依赖模型替代（§2）
%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

# 运行时 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

# 单包策略：禁止拆实体子包，改用虚拟别名兼容依赖方（§7）
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）。

%prep
# 实测确认 GitHub commit 归档解压根目录为 nebula-<完整SHA>，autosetup -n 须匹配（§2）
%autosetup -n nebula-%{commit}

%build
# ROS 基座环境引导：setup.sh 可能不存在，须用 [ -f ] 守卫（§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}

# 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 \
  -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

%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}

%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）