萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> iOS 開發

解決 AssetsLibrary 枚舉相冊遺漏「照片圖庫」的根因與修復

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/設計缺陷。

修復方案:顯式 OR 包含 Library

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);
}];

遷移到 Photos 框架(iOS 8+ 強烈推薦)

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 獲取圖片/視頻資源
        }];
    }
}

總結

  • AssetsLibrary 遺漏照片圖庫 → 手動 | ALAssetsGroupLibrary 修復。
  • 新項目/維護項目 → **直接遷移 Photos 框架**,API 更現代、功能更全、官方長期維護。
  • Photos 框架核心類:PHAsset(資源)、PHAssetCollection(相冊/智能相冊)、PHFetchResult(查詢結果)、PHImageManager(異步圖片請求)。

不要在 2024 年繼續為 AssetsLibrary 的坑填坑,拥抱 Photos 框架才是正道。

copyright © 萬盛學電腦網 all rights reserved