You need to enable JavaScript to run this app. Swift中如何以编程方式在iOS图库内创建文件夹
优惠活动
大模型
产品
解决方案
定价
更多

Swift中如何以编程方式在iOS图库内创建文件夹

核心认知纠正

你之前已掌握的相册创建逻辑仅操作了 PHAssetCollection 类,但iOS图库的文件夹和相册属于完全不同的实体模型:

  • 文件夹:属于集合列表(PHCollectionList),本身不存储任何媒体资产,仅作为层级容器嵌套其他子文件夹、相册
  • 普通相册/共享相册:属于资产集合(PHAssetCollection),直接关联存储具体照片、视频
    三类系统操作选项对应的实体和API完全独立,用相册的创建方法永远没法生成文件夹。
带层级结构的实现步骤

前置准备

确认已在Info.plist中配置 NSPhotoLibraryAddUsageDescription、NSPhotoLibraryUsageDescription 权限声明,且已获取用户的图库读写授权。

1. 创建根级自定义文件夹(对应需求路径的 AppName 层)

通过 PHCollectionListChangeRequest 实现文件夹创建,核心代码如下:

func createRootFolder(named name: String, completion: @escaping (Result<PHCollectionList, Error>) -> Void) {
    var createdPlaceholder: PHObjectPlaceholder?
    PHPhotoLibrary.shared().performChanges {
        let createRequest = PHCollectionListChangeRequest.creationRequestForCollectionList(withTitle: name)
        createdPlaceholder = createRequest.placeholderForCreatedCollectionList
    } completionHandler: { success, error in
        guard success, let placeholder = createdPlaceholder else {
            completion(.failure(error ?? NSError(domain: "CreateFolderError", code: -1)))
            return
        }
        // 从图库中拉取已创建的文件夹实例
        let fetchResult = PHCollectionList.fetchCollectionLists(
            withLocalIdentifiers: [placeholder.localIdentifier],
            options: nil
        )
        guard let rootFolder = fetchResult.firstObject else {
            completion(.failure(NSError(domain: "FetchFolderError", code: -2)))
            return
        }
        DispatchQueue.main.async {
            completion(.success(rootFolder))
        }
    }
}

2. 在父文件夹下创建子文件夹(对应需求路径的 Some_grp 层)

创建子文件夹时,需要把新建的子集合作为子项挂载到对应父文件夹的子列表中:

func createSubFolder(named name: String, in parentFolder: PHCollectionList, completion: @escaping (Result<PHCollectionList, Error>) -> Void) {
    var createdPlaceholder: PHObjectPlaceholder?
    PHPhotoLibrary.shared().performChanges {
        // 获取父文件夹对应的变更请求
        guard let parentRequest = PHCollectionListChangeRequest(for: parentFolder) else { return }
        let subCreateRequest = PHCollectionListChangeRequest.creationRequestForCollectionList(withTitle: name)
        createdPlaceholder = subCreateRequest.placeholderForCreatedCollectionList
        // 将新建的子文件夹添加到父容器的子集合列表
        parentRequest.addChildCollections([subCreateRequest.placeholderForCreatedCollectionList])
    } completionHandler: { success, error in
        guard success, let placeholder = createdPlaceholder else {
            completion(.failure(error ?? NSError(domain: "CreateSubFolderError", code: -3)))
            return
        }
        let fetchResult = PHCollectionList.fetchCollectionLists(
            withLocalIdentifiers: [placeholder.localIdentifier],
            options: nil
        )
        guard let subFolder = fetchResult.firstObject else {
            completion(.failure(NSError(domain: "FetchSubFolderError", code: -4)))
            return
        }
        DispatchQueue.main.async {
            completion(.success(subFolder))
        }
    }
}

3. 在最内层文件夹下创建存储照片的相册(对应需求路径的 Some_grp2 层)

复用你已有的相册创建逻辑,只需额外把新建的相册挂载到目标父文件夹下:

func createAssetAlbum(named name: String, in parentFolder: PHCollectionList, completion: @escaping (Result<PHAssetCollection, Error>) -> Void) {
    var createdPlaceholder: PHObjectPlaceholder?
    PHPhotoLibrary.shared().performChanges {
        guard let parentRequest = PHCollectionListChangeRequest(for: parentFolder) else { return }
        // 普通相册创建逻辑
        let albumCreateRequest = PHAssetCollectionChangeRequest.creationRequestForAssetCollection(withTitle: name)
        createdPlaceholder = albumCreateRequest.placeholderForCreatedAssetCollection
        // 将新建的相册作为子项挂载到目标文件夹
        parentRequest.addChildCollections([albumCreateRequest.placeholderForCreatedAssetCollection])
    } completionHandler: { success, error in
        guard success, let placeholder = createdPlaceholder else {
            completion(.failure(error ?? NSError(domain: "CreateAlbumError", code: -5)))
            return
        }
        let fetchResult = PHAssetCollection.fetchAssetCollections(
            withLocalIdentifiers: [placeholder.localIdentifier],
            options: nil
        )
        guard let album = fetchResult.firstObject else {
            completion(.failure(NSError(domain: "FetchAlbumError", code: -6)))
            return
        }
        DispatchQueue.main.async {
            completion(.success(album))
        }
    }
}
核心注意事项
  • 自定义层级仅允许在应用自身创建的根文件夹下嵌套,系统自带的根级文件夹(如「最近项目」「我的收藏」)不支持写入自定义子层级
  • 文件夹本身不关联任何媒体资产,拍摄的照片写入时依然需要关联到最内层的PHAssetCollection(即相册)上,匹配你设计的层级路径逻辑
  • 拉取已有层级结构时,需要通过 PHCollection.fetchTopLevelUserCollections(with:) 遍历根层级集合,逐层展开每个PHCollectionList的子项定位目标相册,无法通过普通相册查询接口直接带路径获取
  • 系统强制将共享相册归类到独立的共享相册根目录,不支持将共享相册嵌套到自定义文件夹层级下

内容的提问来源于stack exchange,提问作者Ellyn_Philip

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 12:24:04