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
相关产品推荐
相关产品推荐

