如何使用/测试子 NSProgress 实例的 NSProgress userInfo 更改

Question

我正在库中实现NSProgress 支持，并且我编写了一些单元测试来测试一切是否正常工作。虽然理想情况下我希望能够传递一些额外的元数据（userInfo 本身不被NSProgress 使用的键，但供我的API 的用户使用），现在我只是想获得localizedDescription 和localizedAdditionalDescription 像文档所说的那样工作。由于我正在测试的方法从存档中提取文件，因此我将kind 设置为NSProgressKindFile 并设置与文件操作相关的各种键（例如NSProgressFileCompletedCountKey）。

我希望当我观察到使用 KVO 对 localizedDescription 的更改时，我会看到如下更新：

处理“测试文件 A.txt”

处理“测试文件 B.jpg”

处理“测试文件 C.m4a”

当我停在断点处，polocalizedDescription 在工作人员NSProgress 实例（下面的childProgress）上，这实际上就是我所看到的。但是当我的测试运行时，他们看到的只是以下内容，这意味着它没有看到我设置的任何 userInfo 键：

0% 完成

0% 完成

53% 完成

100% 完成

100% 完成

看起来我在子 NSProgress 实例上设置的 userInfo 键没有传递给它的父实例，尽管 fractionCompleted 确实如此。我做错了吗？

我在下面给出了一些抽象代码sn-ps，但您也可以下载带有这些更改的提交from GitHub。如果您想重现此行为，请运行 -[ProgressReportingTests testProgressReporting_ExtractFiles_Description] 和 -[ProgressReportingTests testProgressReporting_ExtractFiles_AdditionalDescription] 测试用例。

在我的测试用例类中：

static void *ProgressContext = &ProgressContext;

...

- (void)testProgressReporting {
    NSProgress *parentProgress = [NSProgress progressWithTotalUnitCount:1];
    [parentProgress becomeCurrentWithPendingUnitCount:1];

    [parentProgress addObserver:self
                     forKeyPath:NSStringFromSelector(@selector(localizedDescription))
                        options:NSKeyValueObservingOptionInitial
                        context:ProgressContext];

    MyAPIClass *apiObject = // initialize
    [apiObject doLongRunningThing];

    [parentProgress resignCurrent];
    [parentProgress removeObserver:self
                        forKeyPath:NSStringFromSelector(@selector(localizedDescription))];
}


- (void)observeValueForKeyPath:(NSString *)keyPath
                      ofObject:(id)object
                        change:(NSDictionary<NSKeyValueChangeKey,id> *)change
                       context:(void *)context
{
    if (context == ProgressContext) {
        // Should refer to parentProgress from above
        NSProgress *notificationProgress = object;
        
        [self.descriptionArray addObject:notificationProgress.localizedDescription];
    }
}

那么，在我的测试课中：

- (void) doLongRunningThing {
    ...
    NSProgress *childProgress = [NSProgress progressWithTotalUnitCount:/* bytes calculated above */];
    progress.kind = NSProgressKindFile;
    [childProgress setUserInfoObject:@0
                              forKey:NSProgressFileCompletedCountKey];
    [childProgress setUserInfoObject:@(/*array count from above*/)
                              forKey:NSProgressFileTotalCountKey];

    int counter = 0;

    for /* Long-running loop */ {
        [childProgress setUserInfoObject: // a file URL
                                  forKey:NSProgressFileURLKey];

        // Do stuff

        [childProgress setUserInfoObject:@(++counter)
                                  forKey:NSProgressFileCompletedCountKey];
        childProgress.completedUnitCount += myIncrement;
    }
}

当我增加childProgress.completedUnitCount 时，这就是调试器中 userInfo 的样子。我设置的字段都表示出来了：

> po childProgress.userInfo

{
    NSProgressFileCompletedCountKey = 2,
    NSProgressFileTotalCountKey = 3,
    NSProgressFileURLKey = "file:///...Test%20File%20B.jpg"; // chunk elided from URL
}

当每个 KVO 通知返回时，notificationProgress.userInfo 的外观如下：

> po notificationProgress.userInfo

{
}

Answer 1

我想对@clarus 的回答发表评论，但不允许我在评论中进行可读格式设置。 TL;DR - 他们的看法一直是我的理解，当我几年前开始与 NSProgress 合作时，这让我很受打击。

对于这样的东西，我喜欢查看Swift Foundation 代码以获取实现提示。如果事情还没有完成，它可能不是 100% 的权威，但我喜欢看到一般的想法。

如果您查看setUserInfoObject(: forKey:) 的实现，您会发现该实现只是设置了用户信息字典，而没有将任何内容传播到父级。

相反，影响子级分数的更新已完成explicitly call back 到（私有）_parent 属性，以指示其状态应更新以响应子级更改。

那个私人_updateChild(: from: to: portion:) 似乎只关心更新完成的分数，而不是任何与用户信息字典相关的东西。

Answer 2

好的，我有机会再次查看代码，我的系统中有更多的咖啡和更多的时间。我实际上看到它在工作。

在您的 testProgressReporting_ExtractFiles_AdditionalDescription 方法中，我将代码更改为：

NSProgress *extractFilesProgress = [NSProgress progressWithTotalUnitCount:1];
[extractFilesProgress setUserInfoObject:@10 forKey:NSProgressEstimatedTimeRemainingKey];
[extractFilesProgress setUserInfoObject:@"Test" forKey:@"TestKey"];

然后在 observeValueForKeyPath 中，我打印了这些对象：

po progress.userInfo {
NSProgressEstimatedTimeRemainingKey = 10;
TestKey = Test;
}

po progress.localizedAdditionalDescription
0 of 1 — About 10 seconds remaining

您可以看到我添加的键值，并且根据这些条目创建了本地化的AdditionalDescription（注意剩余时间）。所以，这一切看起来都正常工作。

我认为一个混淆点可能在于 NSProgress 属性及其对 userInfo 字典中键值的影响。设置属性不会将键值添加到 userInfo 字典，设置键值不会设置属性。例如，设置进度类型不会将 NSProgressFileOperationKindKey 添加到 userInfo 字典中。 userInfo dict 中的值（如果存在）更多地是对仅在创建localizedAdditionalDescription 时使用的属性的覆盖。

您还可以看到我添加的自定义键值。所以，这一切看起来都正常。你能给我指出一些看起来仍然不正常的东西吗？