AssetsLibrary 框架(iOS 9 棄用,現用 Photos 框架)中,ALAssetsGroupAll 理應枚舉所有相冊組,但實際測試中常**遺漏「照片圖庫」(Photo Library,同步相冊)**,僅返回「相機膠卷」。根因在於 ALAssetsGroupLibrary **不包含在** ALAssetsGroupAll 位掩碼中。
[_assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAll
usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
if (group) {
NSLog(@"Found group: %@", [group valueForProperty:ALAssetsGroupPropertyName]);
// 僅輸出 "相機膠卷",缺少 "照片圖庫"
}
} failureBlock:^(NSError *error) {
NSLog(@"Error: %@", error);
}];
查閱 ALAssetsLibrary.h 定義:
typedef enum {
ALAssetsGroupLibrary = 1 << 0, // 1 - 照片圖庫(同步相冊)**不在 All 中**
ALAssetsGroupAlbum = 1 << 1, // 2 - 用戶創建相冊
ALAssetsGroupEvent = 1 << 2, // 4 - 事件相冊
ALAssetsGroupFaces = 1 << 3, // 8 - 人物相冊
ALAssetsGroupSavedPhotos = 1 << 4, // 16 - 相機膠卷
ALAssetsGroupPhotoStream = 1 << 5, // 32 - 照片流
ALAssetsGroupAll = 0xFFFFFFFF // 理應包含所有,但**實際不含 Library**
} ALAssetsGroupType;
**關鍵發現:** ALAssetsGroupAll 定義為 0xFFFFFFFF,但系統實現中**排除了 ALAssetsGroupLibrary**。這是一個長期存在的框架 Bug/設計缺陷。
ALAssetsGroupType allTypes = ALAssetsGroupAll | ALAssetsGroupLibrary; // 關鍵:手動加上 Library
[_assetsLibrary enumerateGroupsWithTypes:allTypes
usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
if (group) {
NSLog(@"Found group: %@", [group valueForProperty:ALAssetsGroupPropertyName]);
// 現在能獲取到 "照片圖庫" + "相機膠卷" + 其他所有
[self.groupArray addObject:group];
[self performSelectorOnMainThread:@selector(reloadTableView) withObject:nil waitUntilDone:YES];
}
} failureBlock:^(NSError *error) {
NSLog(@"Group enumeration failed: %@", error);
}];
AssetsLibrary 已棄用,Photos 框架提供更強大、線程安全、支持 iCloud 照片的 API:
@import Photos;
- (void)fetchAllAlbums {
PHFetchOptions *options = [PHFetchOptions new];
// 獲取所有智能相冊(包含相機膠卷、照片圖庫、自拍、截圖等)
PHFetchResult *smartAlbums = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeSmartAlbum subtype:PHAssetCollectionSubtypeAlbumRegular options:options];
// 獲取用戶創建相冊
PHFetchResult *userAlbums = [PHAssetCollection fetchTopLevelUserCollectionsWithOptions:nil];
// 統一處理
[self processCollections:@[smartAlbums, userAlbums]];
}
- (void)processCollections:(NSArray *> *)collections {
for (PHFetchResult *result in collections) {
[result enumerateObjectsUsingBlock:^(PHAssetCollection *collection, NSUInteger idx, BOOL *stop) {
NSLog(@"Album: %@, Count: %lu", collection.localizedTitle, (unsigned long)[self countAssetsInCollection:collection]);
// 使用 PHAsset 獲取圖片/視頻資源
}];
}
}
| ALAssetsGroupLibrary 修復。PHAsset(資源)、PHAssetCollection(相冊/智能相冊)、PHFetchResult(查詢結果)、PHImageManager(異步圖片請求)。不要在 2024 年繼續為 AssetsLibrary 的坑填坑,拥抱 Photos 框架才是正道。