为何.tbd指定的libEndpointSecurity.dylib不存在？install-name作用解惑

问题场景 #

我创建了一个新的Objective-C应用项目，并添加了Endpoint-Security目标，Xcode自动将libEndpointSecurity.tbd引入项目。查看该文件时发现了install-name字段，原以为它指向Mac中存储的实际.dylib文件，但在/usr/lib目录中找不到libEndpointSecurity.dylib。以下是该.tbd文件的内容：

--- !tapi-tbd
tbd-version:     4
targets:         [ x86_64-macos, arm64-macos, arm64e-macos ]
uuids:
  - target:          x86_64-macos
    value:           D51DD65F-84EA-3A89-A421-E37A87508A3F
  - target:          arm64-macos
    value:           00000000-0000-0000-0000-000000000000
  - target:          arm64e-macos
    value:           B5561C54-DC5C-3A6E-91B9-92079B3E6F05
install-name:    '/usr/lib/libEndpointSecurity.dylib'
current-version: 271.100.29
exports:
  - targets:         [ arm64e-macos, x86_64-macos, arm64-macos ]
    symbols:         [ _es_authorize_file_provider_materialize, _es_authorize_file_provider_materialize_unsafe, 
                       _es_authorize_file_provider_update, _es_clear_cache, _es_copy_message, 
                       _es_delete_client, _es_exec_arg, _es_exec_arg_count, _es_exec_env, 
                       _es_exec_env_count, _es_exec_fd, _es_exec_fd_count, _es_free_message, 
                       _es_invert_path_match, _es_message_size, _es_mute_path, _es_mute_path_events, 
                       _es_mute_path_literal, _es_mute_path_prefix, _es_mute_process, 
                       _es_mute_process_events, _es_muted_paths_events, _es_muted_processes, 
                       _es_muted_processes_events, _es_new_client, _es_new_client_with_config, 
                       _es_register_early_boot_client, _es_release_message, _es_release_muted_paths, 
                       _es_release_muted_processes, _es_respond_auth_result, _es_respond_flags_result, 
                       _es_retain_message, _es_subscribe, _es_subscriptions, _es_sync_client, 
                       _es_unmute_all_paths, _es_unmute_path, _es_unmute_path_events, 
                       _es_unmute_process, _es_unmute_process_events, _es_unregister_early_boot_client, 
                       _es_unregister_early_boot_clients, _es_unsubscribe, _es_unsubscribe_all, 
                       _sysdiagnoseInformationForEndpointSecurity ]
...

本以为这是个问题，但项目构建无报错且运行正常。是不是误解了install-name字段的作用？它的实际作用是什么？为何Mac中没有/usr/lib/libEndpointSecurity.dylib？

回答 #

你确实误解了install-name的作用，找不到.dylib也是完全正常的，具体原因如下：

1. install-name的实际作用

install-name不是指向开发机器上的本地动态库文件，它是给程序运行时用的标识：当程序启动后，操作系统会根据这个字段的值，去对应路径查找并加载所需的动态库。这个路径是程序运行时的标准查找路径，而非开发阶段本地文件的存储位置。

2. 为什么/usr/lib里找不到libEndpointSecurity.dylib

从macOS Catalina开始，苹果将大部分系统级库迁移到了受System Integrity Protection（SIP，系统完整性保护）保护的只读系统分区，并且调整了系统库的存储结构：

• Endpoint Security本质是系统框架的一部分，它的实际存储路径是/System/Library/Frameworks/EndpointSecurity.framework/Versions/A/EndpointSecurity。
• 你看到的libEndpointSecurity.tbd是苹果提供的文本存根文件，仅在编译阶段向Xcode提供函数符号、支持架构等链接所需的信息，完全不需要本地存在对应的.dylib文件就能完成编译链接。

3. 项目能正常构建运行的原因

• 编译阶段：Xcode通过tbd文件获取链接需要的所有符号和依赖信息，无需访问实际的.dylib文件。
• 运行阶段：系统会自动识别这是系统自带的依赖，直接从系统框架的真实路径加载Endpoint Security库，因此程序可以正常运行。

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