Flutter macOS应用嵌入Unix可执行文件及.dylib的签名方案咨询

1. 嵌入文件到Flutter项目 #

• 将Hugin的Unix可执行文件（如enfuse）和关联.dylib文件复制到Flutter项目的macos/Resources目录（无此目录则手动创建）。
• 打开Xcode（执行open macos/Runner.xcworkspace），选中左侧导航栏的Runner项目，进入Build Phases标签页：
  • 在Copy Bundle Resources中点击+，添加macos/Resources下的所有文件，确保它们会被打包到最终.app bundle的Contents/Resources目录。

2. 修复动态库依赖路径 #

嵌入式文件可能依赖外部路径的库，需修改为相对bundle的路径以避免运行时错误：

• 用otool检查依赖关系：

  otool -L macos/Resources/enfuse
  otool -L macos/Resources/libexample.dylib
  

• 用install_name_tool修改可执行文件的依赖路径，将外部dylib路径替换为@rpath/xxx.dylib：

  install_name_tool -change /原路径/libexample.dylib @rpath/libexample.dylib macos/Resources/enfuse
  

• 若需要，修改.dylib自身的ID：

  install_name_tool -id @rpath/libexample.dylib macos/Resources/libexample.dylib
  

• 在Xcode的Runner项目设置中，进入Build Settings，搜索Runpath Search Paths，添加@executable_path/../Resources（主可执行文件位于Contents/MacOS，Resources在同级Contents目录下，此相对路径可让程序找到嵌入的库）。

3. 签名嵌入式文件与主应用 #

macOS要求所有嵌入的二进制文件必须使用与主应用相同的开发者ID签名：

• 先单独签名每个.dylib和可执行文件：

  codesign --force --sign "Developer ID Application: 你的名称 (团队ID)" --timestamp macos/Resources/enfuse
  codesign --force --sign "Developer ID Application: 你的名称 (团队ID)" --timestamp macos/Resources/libexample.dylib
  

• 再通过Xcode签名主应用：在Signing & Capabilities标签页选择正确的签名身份，执行Product > Archive，后续通过Xcode分发流程完成签名。
  • 注意：不要使用--deep参数签名主应用，手动逐个签嵌入文件后再签主应用更可靠。

4. 在Flutter中调用嵌入式可执行文件 #

在Dart代码中获取bundle内的可执行文件路径并调用：

import 'dart:io';

Future<String> getEnfusePath() async {
  // 计算应用Contents目录路径
  final appExecutableDir = Directory.fromUri(Uri.file(Platform.resolvedExecutable)).parent;
  final contentsDir = appExecutableDir.parent;
  return '${contentsDir.path}/Resources/enfuse';
}

// 调用enfuse示例
Future<void> runEnfuse() async {
  final enfusePath = await getEnfusePath();
  final result = await Process.run(enfusePath, ['--help']);
  print(result.stdout);
}

5. 完成应用公证 #

签名后需提交苹果公证，否则用户打开时会被Gatekeeper拦截：

• 通过Xcode的Distribute App流程选择Developer ID，按提示完成公证；
• 或使用命令行工具：

  # 先将.app打包为zip
  ditto -c -k --sequesterRsrc --keepParent YourApp.app YourApp.app.zip
  # 提交公证
  xcrun notarytool submit YourApp.app.zip --keychain-profile "你的公证配置文件" --wait
  # 加盖公证印章
  xcrun stapler staple YourApp.app
  

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