iOS平台.NET MAUI项目中如何将文件上传至iCloud？

一、开发者账号与后台配置 #

• 登录苹果开发者后台，找到你的App ID，开启iCloud服务
• 创建唯一的iCloud容器（格式示例：iCloud.com.yourcompany.yourapp），确保容器ID与后续项目配置一致

二、项目权限与配置修改 #

1. 配置Info.plist #

添加iCloud容器定义和权限说明：

<key>NSUbiquitousContainers</key>
<dict>
    <key>iCloud.com.yourcompany.yourapp</key>
    <dict>
        <key>NSUbiquitousContainerIsDocumentScopePublic</key>
        <true/>
        <key>NSUbiquitousContainerName</key>
        <string>你的应用名称</string>
        <key>NSUbiquitousContainerSupportedFolderLevels</key>
        <string>Any</string>
    </dict>
</dict>
<!-- 向用户说明iCloud使用目的 -->
<key>NSUbiquitousStorageUsageDescription</key>
<string>同步PDF文件需要访问iCloud存储</string>

2. 启用iCloud能力 #

在Visual Studio的MAUI项目属性中，进入iOS的Capabilities面板，勾选iCloud并选择你创建的容器ID；也可手动修改Entitlements.plist：

<key>com.apple.developer.icloud-container-identifiers</key>
<array>
    <string>iCloud.com.yourcompany.yourapp</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.yourcompany.yourapp</string>
</array>

三、修改代码存储路径到iCloud #

替换原本地存储逻辑，将文件保存到iCloud容器目录：

string fileName = nombreFile + ".pdf";

// 方式1：通过FileSystem获取并替换路径（需替换容器ID）
var iCloudContainerPath = FileSystem.AppDataDirectory.Replace(
    "Documents", 
    "Library/Mobile Documents/iCloud~com~yourcompany~yourapp/Documents"
);

// 方式2：更可靠的原生API获取（需引用ObjCRuntime和Foundation）
// using ObjCRuntime;
// using Foundation;
// var fileManager = NSFileManager.DefaultManager;
// var containerUrl = fileManager.GetUrlForUbiquityContainer(null);
// var iCloudDocsUrl = containerUrl.Append("Documents", true);
// string iCloudContainerPath = iCloudDocsUrl.Path;

// 确保目标目录存在
Directory.CreateDirectory(Path.GetDirectoryName(iCloudContainerPath));

string path = Path.Combine(iCloudContainerPath, fileName);

using (FileStream fileStream = new FileStream(path, FileMode.Create, FileAccess.Write))
{
    await documentStream.CopyToAsync(fileStream);
}

注意：将代码中的iCloud~com~yourcompany~yourapp替换为你的实际容器ID（把原容器ID的.替换为~），推荐用原生API方式获取路径，避免硬编码导致的兼容性问题。

四、验证同步效果 #

• 确保测试设备登录同一Apple ID且开启iCloud Drive
• 保存PDF后，可通过iOS“文件”App查看iCloud容器内的文件，或在同ID的其他设备打开应用验证同步结果

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