.NET MAUI Mac端iCloud操作异常：删除文件夹时权限被拒

问题背景 #

已完成Apple开发者后台App ID的iCloud文档配置，同步更新了info.plist和Entitlement.plist（配置内容见下文），但执行iCloud文件夹删除代码时抛出异常：

System.IO.IOException: Access to the path '/Users/USERABC/Library/Mobile Documents/iCloud_comabc~MyApp/' is denied

配置文件内容

info.plist #

<key>NSUbiquitousContainers</key>
<dict>
    <key>iCloud.com.abc.MyApp</key>
    <dict>
        <key>NSUbiquitousContainerIsDocumentScopePublic</key>
        <true/>
        <key>NSUbiquitousContainerName</key>
        <string>MyApp</string>
        <key>NSUbiquitousContainerSupportedFolderLevels</key>
        <string>Any</string>
    </dict>
</dict>

<key>UIFileSharingEnabled</key>
<true/>

<key>LSSupportsOpeningDocumentsInPlace</key>
<true/>

<key>UIBackgroundModes</key>
<array>
    <string>fetch</string>
    <string>remote-notification</string>
</array>

<key>NSUbiquitousContainersUsageDescription</key>
<string>This app uses iCloud containers to store and sync documents.</string>

Entitlement.plist #

<key>com.apple.developer.icloud-container-identifiers</key>
<array>
    <string>iCloud.com.abc.MyApp</string>
</array>
<key>com.apple.developer.icloud-services</key>
<array>
    <string>CloudDocuments</string>
</array>
<key>com.apple.developer.ubiquity-container-identifiers</key>
<array>
    <string>iCloud.com.abc.MyApp</string>
</array>

原删除代码

private void DeleteFolderFromICloud()
{
    try {
        var iCloudDocumentsURL = NSFileManager.DefaultManager.GetUrlForUbiquityContainer(null);
        if (iCloudDocumentsURL != null)
        {
            var path = iCloudDocumentsURL.ToString().Replace("%C3%97", "x");
            var filepath = path.Replace("file://", string.Empty).Replace("%20", " ");
            var destinationdirectoryPath = filepath;
            if (Directory.Exists(destinationdirectoryPath))
            {
                Directory.Delete(destinationdirectoryPath, recursive: true);
            }
        }
    }catch(Exception ex) {
        LogHandler.LogError(ex);
    }
}

问题原因 #

1. 根目录权限限制：iCloud容器的顶级根目录是系统保护目录，应用没有权限直接删除它。
2. API使用错误：使用.NET的System.IO.Directory类直接操作iCloud路径，无法正确处理iCloud文件系统的特殊权限和同步机制，应该使用苹果原生的NSFileManager API来操作。

解决方案 #

1. 避免直接删除iCloud容器根目录 #

如果需要清理iCloud内容，应删除根目录下的子文件夹/文件，而非根目录本身。

2. 使用原生NSFileManager API执行删除操作 #

修改代码，用苹果原生API处理文件删除，确保权限和同步逻辑正确：

private void DeleteFolderFromICloud()
{
    try {
        var fileManager = NSFileManager.DefaultManager;
        var iCloudContainerURL = fileManager.GetUrlForUbiquityContainer(null);
        
        if (iCloudContainerURL == null)
        {
            LogHandler.LogError("无法获取iCloud容器URL");
            return;
        }

        // 方案1：删除根目录下的所有子项
        var contents = fileManager.ContentsOfDirectory(iCloudContainerURL, null, NSFileManager.DirectoryEnumerationSkipsHiddenFiles, out var dirError);
        if (dirError != null)
        {
            LogHandler.LogError(dirError);
            return;
        }

        foreach (var itemURL in contents)
        {
            fileManager.Remove(itemURL, out var removeError);
            if (removeError != null)
            {
                LogHandler.LogError($"删除{itemURL}失败: {removeError}");
            }
        }

        // 方案2：删除指定子文件夹（示例：删除名为"MyData"的文件夹）
        // var targetFolderURL = iCloudContainerURL.Append("MyData", true);
        // if (fileManager.FileExists(targetFolderURL))
        // {
        //     fileManager.Remove(targetFolderURL, out var removeError);
        //     if (removeError != null)
        //     {
        //         LogHandler.LogError(removeError);
        //     }
        // }
    }
    catch(Exception ex) {
        LogHandler.LogError(ex);
    }
}

关键注意事项 #

• 永远不要尝试删除iCloud容器的根目录，这是系统严格保护的路径。
• 操作iCloud文件时，必须使用苹果原生文件API（如NSFileManager），避免用System.IO类直接处理路径，否则会触发权限问题或同步异常。
• 确保应用已获得用户授权访问iCloud，可通过检查GetUrlForUbiquityContainer的返回值判断是否有权限。

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