Open Radar

 
Summary:
UIDocumentPickerViewController is dismissed before its delegate documentPicker:didPickDocumentAtURL: is called. This is a breaking change in iOS 8.2 and is inconsistent with the UIImagePickerController.

- Breaking change breaking existing code
- Breaks the ability to select multiple files in UIDocumentPickerViewController 
- Inconsistent with the UIImagePickerController: the UIImagePickerController lets the user of this API dismiss the view controller when needed

Expected Results:
UIDocumentPickerViewController should not be dismissed when its delegate documentPicker:didPickDocumentAtURL: is called. The developer should be responsible for dismissing it with code such as:

- (void)documentPicker:(UIDocumentPickerViewController *)controller didPickDocumentAtURL:(NSURL *)url {
    [controller.presentingViewController dismissViewControllerAnimated:YES completion:^{
        [self didPickLocalURL:url];
    }];
}

Actual Results:
When the delegate method is called, the controller has been dismissed.

Regression:
This is a breaking change because old code that would properly dismiss the controller such as above is now calling dismissViewControllerAnimated:completion: on nil => no result.

- (void)documentPicker:(UIDocumentPickerViewController *)controller didPickDocumentAtURL:(NSURL *)url {
    [controller.presentingViewController dismissViewControllerAnimated:YES completion:^{
        [self didPickLocalURL:url];
    }];
}