Cocoa应用与控制台应用NSApplicationSupportDirectory路径不一致原因及解决

开发了一个小工具，需要访问用户层的~/Library/Application Support目录。创建命令行项目时，用URLsForDirectory获取路径一切正常；但创建带GUI的Cocoa项目时，返回的路径位于Containers目录下，且该目录似乎不存在。想知道这种差异的原因是什么，以及如何在Cocoa项目中获取真实的~/Library/Application Support目录。

• Cocoa GUI项目默认启用了App Sandbox（应用沙箱）机制，这是macOS为安全隔离应用引入的特性。沙箱会为应用创建独立的容器目录（~/Library/Containers/你的应用Bundle ID/Data/），所有文件访问都会被限制在这个容器内，因此URLsForDirectory返回的是容器内模拟的Application Support路径。
• 命令行项目默认不会启用沙箱，因此直接访问的是系统真实的用户级Application Support目录。

方法一：关闭App Sandbox（无需沙箱权限时） #

1. 打开Xcode项目，进入Signing & Capabilities标签页
2. 找到App Sandbox选项，点击左上角的-号移除该能力
   移除后，Cocoa项目的URLsForDirectory会和命令行项目一样，返回真实的~/Library/Application Support路径，无需修改代码。

方法二：保留沙箱并添加权限（需上架Mac App Store等场景） #

如果必须保留沙箱，可通过以下方式获取外部目录访问权限：

1. 在Signing & Capabilities的App Sandbox设置中，展开File Access
2. 在User Selected File中勾选Read/Write，此时应用可通过NSSavePanel或NSOpenPanel让用户手动选择Application Support目录进行访问
3. 若需访问特定公共目录，可在File Access中添加对应权限，但Application Support属于用户私有目录，沙箱默认不允许直接访问，这种情况下建议优先使用沙箱容器内的路径。

相关代码与输出 #

Cocoa项目代码 #

#import "ViewController.h"

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    // Do any additional setup after loading the view.
    NSArray* pathes = [[NSFileManager defaultManager] URLsForDirectory:NSApplicationSupportDirectory inDomains:NSUserDomainMask
    ];
    NSString* applicationSupportPath = [pathes firstObject];
    NSLog(@"Application Support:%@\n", applicationSupportPath);
}


- (void)setRepresentedObject:(id)representedObject {
    [super setRepresentedObject:representedObject];

    // Update the view, if already loaded.
}


@end

Cocoa项目输出 #

2022-10-03 22:01:23.230600+0800 TestApplicationSupportPath[49579:213899] Application Support:file:///Users/bodong/Library/Containers/com.bodong.TestApplicationSupportPath/Data/Library/Application%20Support/

控制台项目代码 #

#import <Foundation/Foundation.h>

int main(int argc, const char * argv[]) {
    @autoreleasepool {
        // insert code here...
        NSLog(@"Hello, World!");
    }
    
    NSArray* pathes = [[NSFileManager defaultManager] URLsForDirectory:NSApplicationSupportDirectory inDomains:NSUserDomainMask
    ];
    NSString* applicationSupportPath = [pathes firstObject];
    NSLog(@"Application Support:%@\n", applicationSupportPath);
    
    return 0;
}

控制台项目输出 #

2022-10-03 22:02:09.341780+0800 TestASPCmd[49791:215344] Application Support:file:///Users/bodong/Library/Application%20Support/
Program ended with exit code: 0

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