使用Scons编译Swift构建Godot iOS插件时桥接头文件报错排查

核心问题分析 #

你遇到的'arithematic-Swift.h' file not found错误，本质是Scons默认不处理Swift代码编译流程：Xcode会自动生成这个头文件，但Scons需要手动配置Swift编译规则、桥接头参数，以及确保生成的头文件能被Objective-C++代码找到。

正确的SConstruct配置方案 #

以下是适配Godot iOS插件构建的完整SConstruct配置，包含Swift编译、桥接头配置、头文件路径关联等逻辑：

import os
import sys

env = Environment()

# 基础配置（根据你的Godot版本和需求调整）
target = ARGUMENTS.get('target', 'release_debug')
arch = ARGUMENTS.get('arch', 'arm64')
plugin_name = ARGUMENTS.get('plugin', 'arithematic')
godot_version = ARGUMENTS.get('version', '4.0')

# iOS SDK配置（需确保Xcode命令行工具已安装）
ios_sdk_path = os.popen('xcrun --sdk iphoneos --show-sdk-path').read().strip()
ios_sdk_version = os.popen('xcrun --sdk iphoneos --show-sdk-version').read().strip()
min_ios_version = '14.0'  # 适配Godot 4的最低iOS版本

# 1. 自定义Swift编译Builder
swift_builder = Builder(
    action='xcrun swiftc -target %s-apple-ios%s -sdk %s -O%s -c $SOURCE -o $TARGET -import-objc-header $BRIDGING_HEADER -emit-objc-header -emit-objc-header-path $SWIFT_HEADER_PATH' % (
        arch,
        min_ios_version,
        ios_sdk_path,
        '0' if target == 'release' else ''  # release模式开启优化，debug模式关闭
    ),
    suffix='.o',
    src_suffix='.swift'
)
env.Append(BUILDERS={'Swift': swift_builder})

# 2. 配置源文件和路径
swift_sources = ['arithematic/Calculator.swift']
objcpp_sources = ['arithematic/arithematic.mm']
bridging_header = 'arithematic/arithematic-Bridging-Header.h'
swift_header_path = 'arithematic/arithematic-Swift.h'  # 指定生成头文件的输出位置

# 3. 编译Swift代码，生成目标文件和头文件
swift_objs = env.Swift(
    [os.path.splitext(src)[0] + '.o' for src in swift_sources],
    swift_sources,
    BRIDGING_HEADER=bridging_header,
    SWIFT_HEADER_PATH=swift_header_path
)

# 4. 编译Objective-C++代码，添加Swift头文件搜索路径
env.Append(CXXFLAGS=[
    '-target', f'{arch}-apple-ios{min_ios_version}',
    '-isysroot', ios_sdk_path,
    '-fobjc-arc',
    '-I', 'arithematic',  # 让编译器找到生成的arithematic-Swift.h
])
objcpp_objs = env.Object(objcpp_sources)

# 5. 合并所有目标文件为静态库
static_lib = env.Library(f'lib{plugin_name}.a', swift_objs + objcpp_objs)

# 6. 设定默认构建目标
Default(static_lib)

关键配置说明 #

• Swift编译Builder：直接调用xcrun swiftc执行Swift编译，指定目标架构、iOS版本、SDK路径，通过-emit-objc-header强制生成Objective-C兼容头文件，并指定输出路径。
• 桥接头配置：通过-import-objc-header指定桥接文件，确保Swift能调用Objective-C代码（若有需求）。
• 头文件搜索路径：在Objective-C++编译参数中添加-I arithematic，让编译器能定位到生成的Swift头文件。
• 动态SDK获取：用xcrun自动获取iOS SDK路径和版本，避免硬编码路径导致的环境适配问题。

构建验证 #

执行原构建命令：

scons target=release_debug arch=arm64 plugin=arithematic version=4.0

编译成功后，当前目录会生成libarithematic.a静态库，arithematic目录下也会生成arithematic-Swift.h文件。

注意事项 #

• 桥接头文件arithematic-Bridging-Header.h路径需准确，且仅包含需要暴露给Swift的Objective-C声明。
• Swift代码中需要被Objective-C++调用的类和方法，必须添加@objc修饰符，且类需继承自NSObject。
• 若遇Swift编译错误，可单独执行xcrun swiftc命令调试参数是否正确。

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