在x86-64 Windows主机上用SCons交叉编译ARM64目标程序遇问题求助

问题场景 #

在x86-64架构的Windows主机上，使用Visual Studio 2019的ARM64交叉编译器，通过SCons构建Windows ARM64目标应用时遇到两个配置错误。

问题1：生成Linux风格目标文件与库导致链接失败 #

错误表现 #

手动指定编译器路径后，编译生成了.o后缀的目标文件和libxxx.a格式的静态库，链接时抛出：

LINK : fatal error LNK1181: cannot open input file 'libtest.a'

配置代码 #

初始化环境：

tmpenv = Environment(options = opts, ENV= {'PATH' : os.environ['PATH']}, TARGET_ARCH = 'ARM64', HOST_OS = 'x86_64', MSVC_VERSION = '14.2', MSVC_SDK_VERSION='10.0.18362.0', TARGET_OS='ARM64', MSVS_ARCH = 'arm64')

手动指定工具路径：

env["CXX"] = "\"C:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Professional\\VC\\Tools\\MSVC\\14.29.30133\\bin\\Hostx64\\arm64\\cl.exe\""
env["CC"] = "\"C:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Professional\\VC\\Tools\\MSVC\\14.29.30133\\bin\\Hostx64\\arm64\\cl.exe\""
env["LINK"] = "\"C:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Professional\\VC\\Tools\\MSVC\\14.29.30133\\bin\\Hostx64\\arm64\\link.exe\""
env["LD"] = "\"C:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Professional\\VC\\Tools\\MSVC\\14.29.30133\\bin\\Hostx64\\arm64\\lib.exe\""
env["AR"] = "\"C:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Professional\\VC\\Tools\\MSVC\\14.29.30133\\bin\\Hostx64\\arm64\\lib.exe\""

原因与修复 #

• 原因：手动硬编码工具路径后，SCons未加载MSVC工具链的默认规则， fallback到类UNIX的文件命名格式，但MSVC链接器只识别.obj目标文件和.lib静态库。
• 修复步骤：
  1. 移除手动指定的工具路径，让SCons自动检测VS2019的ARM64交叉编译环境（MSVS_ARCH='arm64'已足够引导SCons找到对应工具）；
  2. 显式设置MSVC兼容的文件后缀规则：

     # 目标文件后缀改为.obj
     tmpenv['OBJSUFFIX'] = '.obj'
     # 静态库去掉lib前缀，后缀改为.lib
     tmpenv['LIBPREFIX'] = ''
     tmpenv['LIBSUFFIX'] = '.lib'
     # 若需生成DLL，设置共享库后缀
     tmpenv['SHLIBPREFIX'] = ''
     tmpenv['SHLIBSUFFIX'] = '.dll'
     

问题2：加载MS工具后触发ranlib命令错误 #

错误表现 #

显式加载MSVC工具后，编译过程正常，但最终抛出：

'ranlib' is not recognized as an internal or external command, operable program or batch file.

触发代码 #

tmpenv.Tool('msvc')
tmpenv.Tool('mslink')
tmpenv.Tool('mslib')

原因与修复 #

• 原因：SCons默认会调用ranlib完成静态库索引，但MSVC的lib.exe已在创建库时完成索引，无需额外调用ranlib。加载mslib工具后未覆盖这一默认行为。
• 修复步骤：
  在加载工具后，显式禁用ranlib命令：

  tmpenv['RANLIB'] = None
  

完整可用配置示例 #

import os
import SCons

opts = SCons.Options.Options()
# 初始化环境：注意HOST_OS和TARGET_OS应设为'windows'，而非架构
tmpenv = Environment(
    options=opts,
    ENV={'PATH': os.environ['PATH']},
    TARGET_ARCH='ARM64',
    HOST_OS='windows',
    MSVC_VERSION='14.2',
    MSVC_SDK_VERSION='10.0.18362.0',
    TARGET_OS='windows',
    MSVS_ARCH='arm64'
)
# 加载MSVC工具链
tmpenv.Tool('msvc')
tmpenv.Tool('mslink')
tmpenv.Tool('mslib')
# 禁用不需要的ranlib
tmpenv['RANLIB'] = None
# 强制使用MSVC兼容的文件后缀
tmpenv['OBJSUFFIX'] = '.obj'
tmpenv['LIBPREFIX'] = ''
tmpenv['LIBSUFFIX'] = '.lib'
tmpenv['SHLIBPREFIX'] = ''
tmpenv['SHLIBSUFFIX'] = '.dll'

# 示例构建规则
# tmpenv.StaticLibrary('test', ['test.cpp'])
# tmpenv.Program('app', ['main.cpp', 'test.lib'])

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