Skip to content

Photos iOS xcode27.2 b3

Jump to bottom
Alex Soto edited this page Oct 17, 2026 · 1 revision

#Photos.framework

diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResource.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResource.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResource.h	2026-09-19 03:41:21
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResource.h	2026-10-09 02:36:20
@@ -32,14 +32,20 @@
 /// The filename associated with this asset resource (if any)
 @property (nonatomic, copy, readonly, nullable) NSString *filename API_AVAILABLE(macos(27), ios(27), tvos(27), visionos(27));
 
-/// The content type of the data associated with this asset resource (the data can be retrieved via `PHAssetResourceManager`)
+/// The content type of the data associated with this asset resource
+///
+/// This resource's data can be retrieved via ``/Photos/PHAssetResourceManager``
 @property (nonatomic, copy, readonly) UTType *contentType API_AVAILABLE(macos(26.0), ios(26.0), tvos(26.0), visionos(26.0));
+
 @property (nonatomic, copy, readonly) NSString *uniformTypeIdentifier API_DEPRECATED("Use contentType instead", ios(9, API_TO_BE_DEPRECATED), macos(10.15, API_TO_BE_DEPRECATED), tvos(10, API_TO_BE_DEPRECATED), visionos(1, API_TO_BE_DEPRECATED));
 
 @property (nonatomic, assign, readonly) NSInteger pixelWidth API_AVAILABLE(macos(13), ios(16), tvos(16));
 @property (nonatomic, assign, readonly) NSInteger pixelHeight API_AVAILABLE(macos(13), ios(16), tvos(16));
 
-/// The size of the resource in bytes if known, `nil` if unavailable (may not be available until resource download/processing is complete)
+/// The size of the resource in bytes
+///
+/// The size may be unknown until a resource has finished being generated or processed and some resources never report one. `nil` means the size is
+/// unknown, not that it is zero.
 @property (nonatomic, copy, readonly, nullable) NSNumber *dataSize NS_REFINED_FOR_SWIFT API_AVAILABLE(macos(27), ios(27), tvos(27), visionos(27));
 
 #pragma mark - Getting resources
@@ -53,7 +59,7 @@
  Returns the asset resource associated with the given upload job.
 
  - Parameters:
- - job: the upload job whose associated asset resource is returned
+   - job: the upload job whose associated asset resource is returned
 
  - Returns: The asset resource associated with the upload job, or nil if the resource cannot be found.
  */
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResourceUploadJob.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResourceUploadJob.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResourceUploadJob.h	2026-09-19 03:41:21
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResourceUploadJob.h	2026-10-09 02:36:19
@@ -21,7 +21,7 @@
 ///
 /// When the extension's principal class receives a call to ``PHBackgroundResourceUploadExtension/process()`` background uploads, it can create new ``PHAssetResourceUploadJob`` objects using ``PHAssetResourceUploadJobChangeRequest``.
 ///
-/// The maximum number of jobs that can be in flight is limited to the ``jobLimit``. To make space for new jobs, you must call ``PHAssetResourceUploadJobChangeRequest/fetchJobsWithAction:options:`` and retry/acknowledge them with ``PHAssetResourceUploadJobChangeRequest/acknowledge:`` or ``PHAssetResourceUploadJobChangeRequest/retryWithDestination:`` respectively.
+/// The maximum number of jobs that can be in flight is limited to the ``jobLimit``. To make space for new jobs, you must call ``PHAssetResourceUploadJob/fetchJobsWithAction:options:`` and retry/acknowledge them with ``PHAssetResourceUploadJobChangeRequest/acknowledge`` or ``PHAssetResourceUploadJobChangeRequest/retryWithDestination:`` respectively.
 NS_SWIFT_SENDABLE
 API_AVAILABLE(ios(26.1), macCatalyst(27.0), macos(27.0)) API_UNAVAILABLE(tvos, visionos, watchos)
 @interface PHAssetResourceUploadJob : PHObject
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResourceUploadJobChangeRequest.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResourceUploadJobChangeRequest.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResourceUploadJobChangeRequest.h	2026-08-08 19:17:13
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResourceUploadJobChangeRequest.h	2026-10-04 01:34:59
@@ -13,7 +13,7 @@
 
 /// Use within an application's `com.apple.photos.background-upload` extension to create and change ``PHAssetResourceUploadJob`` records.
 ///
-/// When the extension's principal class receives a call to `process` background uploads, it can create new ``PHAssetResourceUploadJob``s through calls to perform changes on a PHPhotoLibrary using ``PHAssetResourceUploadJobChangeRequest`` and any in-flight upload jobs can be handled by updating their state to mark them as acknowledged, or to be retried. The maximum number of jobs that can be in flight is limited to the ``PHAssetResourceUploadJob.jobLimit``.
+/// When the extension's principal class receives a call to `process` background uploads, it can create new ``PHAssetResourceUploadJob``s through calls to perform changes on a PHPhotoLibrary using ``PHAssetResourceUploadJobChangeRequest`` and any in-flight upload jobs can be handled by updating their state to mark them as acknowledged, or to be retried. The maximum number of jobs that can be in flight is limited to the ``PHAssetResourceUploadJob/jobLimit``.
 ///
 /// ``PHAssetResourceUploadJobChangeRequest`` can only be created or used within a photo library change block. For details on change blocks, see ``PHPhotoLibrary``.
 API_AVAILABLE(ios(26.1), macCatalyst(27.0), macos(27.0)) API_UNAVAILABLE(tvos, visionos, watchos)
@@ -21,12 +21,12 @@
 
 /// Creates an asset resource upload job.
 ///
-/// If the number of jobs exceeds ``PHAssetResourceUploadJob/jobLimit`` the photo library ``performChanges`` request will fail with a ``PHPhotosErrorLimitExceeded`` error.
+/// If the number of jobs exceeds ``PHAssetResourceUploadJob/jobLimit`` the photo library ``PHPhotoLibrary/performChanges:completionHandler:`` request will fail with a ``PHPhotosError/PHPhotosErrorLimitExceeded`` error.
 /// To generate jobs after this limit is triggered, you must acknowledge succeeded/failed jobs, and wait for the registered/pending ones to finish uploading, which will make those jobs also succeeded/failed.
 ///
-/// - Parameter:
-///     - destination: the destination <doc://com.apple.documentation/foundation/nsurlrequest> to which this asset resource will be sent.
-///     - resource: the asset resource to be uploaded.
+/// - Parameters:
+///   - destination: the destination <doc://com.apple.documentation/foundation/nsurlrequest> to which this asset resource will be sent.
+///   - resource: the asset resource to be uploaded.
 + (void)createJobWithDestination:(NSURLRequest *)destination resource:(PHAssetResource *)resource NS_SWIFT_NAME(createJob(destination:resource:)) API_DEPRECATED_WITH_REPLACEMENT("creationRequestForJobWithDestination:resource:", ios(26.1, 26.4));
 
 /// Creates an asset resource upload job and returns the change request.
@@ -34,12 +34,12 @@
 /// This method creates an upload job and returns a change request that can be used to access the placeholder
 /// for the created job. Use the placeholder to obtain the local identifier before the change block completes.
 ///
-/// If the number of jobs exceeds ``PHAssetResourceUploadJob/jobLimit`` the photo library ``performChanges`` request will fail with a ``PHPhotosErrorLimitExceeded`` error.
+/// If the number of jobs exceeds ``PHAssetResourceUploadJob/jobLimit`` the photo library ``PHPhotoLibrary/performChanges:completionHandler:`` request will fail with a ``PHPhotosError/PHPhotosErrorLimitExceeded`` error.
 /// To generate jobs after this limit is triggered, you must acknowledge succeeded/failed jobs, and wait for the registered/pending ones to finish uploading, which will make those jobs also succeeded/failed.
 ///
-/// - Parameter:
-///     - destination: the destination <doc://com.apple.documentation/foundation/nsurlrequest> to which this asset resource will be sent.
-///     - resource: the asset resource to be uploaded.
+/// - Parameters:
+///   - destination: the destination <doc://com.apple.documentation/foundation/nsurlrequest> to which this asset resource will be sent.
+///   - resource: the asset resource to be uploaded.
 /// - Returns: A change request for the created job.
 + (instancetype)creationRequestForJobWithDestination:(NSURLRequest *)destination resource:(PHAssetResource *)resource NS_SWIFT_NAME(creationRequestForJob(destination:resource:)) API_AVAILABLE(ios(26.4));
 
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHCloudIdentifier.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHCloudIdentifier.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHCloudIdentifier.h	2026-08-12 00:25:15
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHCloudIdentifier.h	2026-10-04 03:09:41
@@ -98,7 +98,7 @@
  Use this method instead of `localIdentifierMappingsForCloudIdentifiers:` to avoid looking up PHAsset local identifiers based on the media content matching
  
  - Parameters:
- - cloudIdentifiers The array of `PHCloudIdentifier` instances whose local identifiers are being requested.
+   - cloudIdentifiers: The array of `PHCloudIdentifier` instances whose local identifiers are being requested.
  */
 - (NSDictionary <PHCloudIdentifier *, PHLocalIdentifierMapping *> *)localIdentifierMappingsForSyncedCloudIdentifiers:(NSArray<PHCloudIdentifier *> *)cloudIdentifiers API_AVAILABLE(macos(27), ios(27), tvos(27), visionos(27)) NS_REFINED_FOR_SWIFT;
 
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHCollectionListChangeRequest.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHCollectionListChangeRequest.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHCollectionListChangeRequest.h	2026-09-19 03:46:43
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHCollectionListChangeRequest.h	2026-09-13 22:55:52
@@ -46,7 +46,7 @@
  Use `canPerformEditOperation:` on the collection list to determine if the type of change is allowed. If the collection list does not allow the type of change requested the changes request will fail and an error is returned.
 
  - Parameters:
- - collectionList: the collection list being modified
+   - collectionList: the collection list being modified
  */
 + (nullable instancetype)changeRequestForCollectionList:(PHCollectionList *)collectionList;
 
@@ -58,8 +58,8 @@
  Call `canPerformEditOperation:` on the collection list to determine if the type of change is allowed. If the collection list does not allow the type of change requested, the .
 
  - Parameters:
- - collectionList: the collection list being modified
- - childCollections: the child collections to modify (see `fetchCollectionsInCollectionList:options:`)
+   - collectionList: the collection list being modified
+   - childCollections: the child collections to modify (see `fetchCollectionsInCollectionList:options:`)
  */
 + (nullable instancetype)changeRequestForCollectionList:(PHCollectionList *)collectionList childCollections:(PHFetchResult<__kindof PHCollection *> *)childCollections;
 
@@ -71,7 +71,7 @@
  This is the equivalent to calling `changeRequestForCollectionList:childCollections:` with the collection list matching the type `PHCollectionListTypeFolder` and subtype `PHCollectionListSubtypeRootFolder`
  
  - Parameters:
- - childCollections: the child collections to modify (see `fetchTopLevelUserCollections:options:`)
+   - childCollections: the child collections to modify (see `fetchTopLevelUserCollections:options:`)
  */
 + (nullable instancetype)changeRequestForTopLevelCollectionListUserCollections:(PHFetchResult<__kindof PHCollection *> *)childCollections API_AVAILABLE(macos(11), ios(14.2), tvos(14));
 
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHPhotoLibrary.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHPhotoLibrary.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHPhotoLibrary.h	2026-09-19 03:46:43
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHPhotoLibrary.h	2026-09-13 22:53:54
@@ -83,7 +83,7 @@
 ///
 /// The value is `true` if the extension is enabled and active, and is `false` otherwise.
 ///
-/// The extension's host app uses this property to determine the background processing status. See ``PHAssetResourceUploadJob`` and ````PHAssetResourceUploadJobChangeRequest`` for more information.
+/// The extension's host app uses this property to determine the background processing status. See ``PHAssetResourceUploadJob`` and ``PHAssetResourceUploadJobChangeRequest`` for more information.
 @property (readonly, getter=isUploadJobExtensionEnabled) BOOL uploadJobExtensionEnabled API_AVAILABLE(ios(26.1), macCatalyst(27.0), macos(27.0)) API_UNAVAILABLE(tvos, visionos, watchos) NS_SWIFT_NAME(uploadJobExtensionEnabled);
 
 /// Enables or disables the background asset resource upload job feature.

Contributing

Bindings

Tips & tricks

Clone this wiki locally