Yocto Dunfell环境下Pybind11封装编译优化问题咨询

我已在Yocto Dunfell环境中完成example.so的编译部署，针对你提出的两个问题，给出以下优化方案：

问题1：优化Python头文件的查找方式 #

当前通过find_path硬编码python3.8路径后缀的方式缺乏灵活性，一旦Python版本变更就会失效，推荐两种更可靠的实现方式：

方式1：使用CMake官方FindPython3模块 #

CMake 3.12+自带的FindPython3模块可自动适配目标环境的Python配置，无需硬编码版本：

cmake_minimum_required(VERSION 3.12)
project(example LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 14)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall")

include(GNUInstallDirs)
# 查找Python开发组件
find_package(Python3 REQUIRED COMPONENTS Development)

add_library(${PROJECT_NAME} SHARED example.cpp)
# 直接使用模块提供的包含目录与链接库
target_include_directories(${PROJECT_NAME} PRIVATE ${Python3_INCLUDE_DIRS})
target_link_libraries(${PROJECT_NAME} PRIVATE Python3::Python)

install(TARGETS ${PROJECT_NAME} LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR})

方式2：利用pybind11内置配置 #

pybind11已封装Python依赖的查找逻辑，导入模块后可自动处理头文件、链接库及模块后缀：

cmake_minimum_required(VERSION 3.9.1)
project(example LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 14)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall")

include(GNUInstallDirs)
# 导入pybind11模块
find_package(pybind11 REQUIRED)

# 使用pybind11专用宏创建模块，自动处理前缀、后缀等配置
pybind11_add_module(example SHARED example.cpp)

install(TARGETS example LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR})

该方式无需手动设置CMAKE_SHARED_LIBRARY_PREFIX与后缀，pybind11会自动匹配目标环境的Python模块规范。

问题2：获取目标环境的PYTHON_MODULE_EXTENSION并设置为CMake后缀 #

execute_process会读取本地环境信息，不适用于Yocto交叉编译场景，推荐两种解决方案：

方式1：在Yocto配方中传递目标变量 #

Yocto交叉编译时会自动设置PYTHON_MODULE_EXTENSION变量，可将其传递给CMake：

SRC_URI = "git://git@...;protocol=ssh;branch=master"

PV = "1.0+git${SRCPV}"
SRCREV = "..."

S = "${WORKDIR}/git"

inherit cmake

DEPENDS = "python3 python3-pybind11"

# 将目标环境的模块扩展名传递给CMake
EXTRA_OECMAKE += "-DPYTHON_MODULE_EXTENSION=${PYTHON_MODULE_EXTENSION}"

FILES:${PN} = "/usr/lib/*.so"
FILES:${PN}-dev = ""

随后在CMakeLists.txt中接收并应用：

cmake_minimum_required(VERSION 3.9.1)
project(example LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 14)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall")

include(GNUInstallDirs)

# 接收Yocto传递的目标环境变量
if(DEFINED PYTHON_MODULE_EXTENSION)
    set(CMAKE_SHARED_LIBRARY_SUFFIX "${PYTHON_MODULE_EXTENSION}")
endif()
set(CMAKE_SHARED_LIBRARY_PREFIX "")

find_path(PYTHON_INCLUDE_DIR
    NAMES Python.h
    PATH_SUFFIXES python3.8
    DOC "Path to Python header files"
)

add_library(${PROJECT_NAME} SHARED example.cpp)
target_include_directories(${PROJECT_NAME} PRIVATE ${PYTHON_INCLUDE_DIR})

install(TARGETS ${PROJECT_NAME} LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR})

方式2：使用pybind11自动处理 #

若采用问题1中推荐的pybind11_add_module宏，该宏会自动读取目标Python环境的模块扩展名，无需手动配置，这是最简洁可靠的方案。

内容的提问来源于stack exchange，提问作者Youngmin Kim