使用 FSCopyObjectAsync 显示文件复制进度

Question

经过多次搜索后发现，在尝试进行文件复制并显示相对于已复制文件量的进度指示器时，似乎存在一个常见问题。在花了相当多的时间试图解决这个问题之后，我发现自己再次受到 StackOverflow 诸神的摆布:-) - 希望有一天我也能成为那些能够帮助新手的人之一！

我试图获取一个进度条来显示复制过程的状态，一旦复制过程完成，就调用 Cocoa 方法。挑战 - 我需要使用文件管理器 Carbon 调用，因为 NSFileManager 没有提供我所需的全部功能。

我首先尝试利用 Matt Long 网站上的代码 可可是我的女朋友。代码让我有了很好的距离。我设法让文件复制进度正常工作。栏更新并且（在 Apple 文档中进行了一些额外的搜索）我发现了如何判断文件复制过程是否已完成...

if (stage == kFSOperationStageComplete)

但是，我还有最后一个障碍这比我现在的跳跃要大一点。我不知道如何将对象引用传递到回调中，也不知道如何在完成后从回调中调用 Cocoa 方法。这是我Carbon的极限->可可->碳的理解。博客上的一条评论说

“您可以使用 FSFileOperationClientContext 结构的 void *info 字段，并传递 AppDelegate 或进度指示器本身，而不是通过静态指针访问进度指示器。”

听起来是个好主意。不知道该怎么做。为了其他似乎遇到这个问题并且来自非碳背景的人，主要基于马特示例中的代码，这里有一些简化的代码作为问题的示例......

在正常的可可中方法：

CFRunLoopRef runLoop = CFRunLoopGetCurrent();
FSFileOperationRef fileOp = FSFileOperationCreate(kCFAllocatorDefault);

OSStatus status = FSFileOperationScheduleWithRunLoop(fileOp, 
                     runLoop, kCFRunLoopDefaultMode);

if (status) {
    NSLog(@"Failed to schedule operation with run loop: %@", status);
    return NO;
}

// Create a filesystem ref structure for the source and destination and 
// populate them with their respective paths from our NSTextFields.

FSRef source;
FSRef destination;

// Used FSPathMakeRefWithOptions instead of FSPathMakeRef which is in the 
// original example because I needed to use the kFSPathMakeRefDefaultOptions
// to deal with file paths to remote folders via a /Volume reference

FSPathMakeRefWithOptions((const UInt8 *)[aSource fileSystemRepresentation],
    kFSPathMakeRefDefaultOptions, 
    &source, 
    NULL);

Boolean isDir = true;

FSPathMakeRefWithOptions((const UInt8 *)[aDestDir fileSystemRepresentation],
    kFSPathMakeRefDefaultOptions, 
    &destination, 
    &isDir);

// Needed to change from the original to use CFStringRef so I could convert
// from an NSString (aDestFile) to a CFStringRef (targetFilename)

CFStringRef targetFilename = (CFStringRef)aDestFile;

// Start the async copy.

status = FSCopyObjectAsync (fileOp,
             &source,
             &destination, // Full path to destination dir
             targetFilename,
             kFSFileOperationDefaultOptions,
             statusCallback,
             1.0,
             NULL);

CFRelease(fileOp);

if (status) {

    NSString * errMsg = [NSString stringWithFormat:@"%@ - %@", 
                           [self class], status];

        NSLog(@"Failed to begin asynchronous object copy: %@", status);
}

然后是回调（在同一个文件中）

static void statusCallback (FSFileOperationRef fileOp,
           const FSRef *currentItem,
           FSFileOperationStage stage,
           OSStatus error,
           CFDictionaryRef statusDictionary,
           void *info )
{

    NSLog(@"Callback got called.");

    // If the status dictionary is valid, we can grab the current values to 
    // display status changes, or in our case to update the progress indicator.

    if (statusDictionary)
    {

        CFNumberRef bytesCompleted;

        bytesCompleted = (CFNumberRef) CFDictionaryGetValue(statusDictionary,
                 kFSOperationBytesCompleteKey);

        CGFloat floatBytesCompleted;
        CFNumberGetValue (bytesCompleted, kCFNumberMaxType, 
                              &floatBytesCompleted);

        NSLog(@"Copied %d bytes so far.", 
                              (unsigned long long)floatBytesCompleted);

        // fileProgressIndicator is currently declared as a pointer to a 
        // static progress bar - but this needs to change so that it is a 
        // pointer passed in via the controller. Would like to have a 
        // pointer to an instance of a progress bar

        [fileProgressIndicator setDoubleValue:(double)floatBytesCompleted];
        [fileProgressIndicator displayIfNeeded];
     }

if (stage == kFSOperationStageComplete) {

    NSLog(@"Finished copying the file");

    // Would like to call a Cocoa Method here...
}

} 

所以底线是我如何：

1. 将一个指向进度条实例的指针从调用方法传递到回调
2. 完成后，回调到正常的 Cocoa 方法

如下总是，非常感谢您的帮助（希望答案能够解决我在许多线程中看到的许多问题和投诉！！）

Answer 1

您可以通过使用 FSCopyObjectAsync() 的最后一个参数来执行此操作，该参数是 FSFileOperationClientContext 类型的结构。该结构的字段之一是 info，它是一个 void* 参数，您基本上可以根据需要使用它。无论您分配给传递给 FSCopyObjectAsync() 的结构体字段的内容，都将依次传递给您的回调函数，作为最后一个 info 函数参数。 void* 可以是任何东西，包括指向对象的指针，因此您可以使用它来传递要处理回调的对象的实例。

设置代码如下所示：

FSFileOperationClientContext clientContext = {0}; //zero out the struct to begin with

clientContext.info = myProgressIndicator;
//All the other setup code
status = FSCopyObjectAsync (fileOp,
         &source,
         &destination, // Full path to destination dir
         targetFilename,
         kFSFileOperationDefaultOptions,
         statusCallback,
         1.0,
         &clientContext);

然后，在回调函数中：

static void statusCallback (FSFileOperationRef fileOp,
       const FSRef *currentItem,
       FSFileOperationStage stage,
       OSStatus error,
       CFDictionaryRef statusDictionary,
       void *info )
{
    NSProgressIndicator* fileProgressIndicator = (NSProgressIndicator*)info;
    [fileProgressIndicator setDoubleValue:(double)floatBytesCompleted];
    [fileProgressIndicator displayIfNeeded];
}