-
Notifications
You must be signed in to change notification settings - Fork 576
Photos tvOS xcode27.0 b5
Alex Soto edited this page Aug 10, 2026
·
1 revision
#Photos.framework
diff -ruN /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAsset.h /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAsset.h
--- /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAsset.h 2026-07-11 03:53:04
+++ /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAsset.h 2026-08-05 01:18:31
@@ -56,7 +56,7 @@
@property (nonatomic, strong, readonly, nullable) NSDate *modificationDate;
/// The date and time this asset was added to the photo library (from the device that was used to add this asset)
-@property (nonatomic, strong, readonly) NSDate *addedDate API_AVAILABLE(macos(26.0), ios(26.0), tvos(26.0), visionos(26.0));
+@property (nonatomic, strong, readonly, nullable) NSDate *addedDate API_AVAILABLE(macos(26.0), ios(26.0), tvos(26.0), visionos(26.0));
@property (nonatomic, strong, readonly, nullable) CLLocation *location;
diff -ruN /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetChangeRequest.h /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetChangeRequest.h
--- /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetChangeRequest.h 2026-07-16 01:59:10
+++ /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetChangeRequest.h 2026-08-05 02:12:56
@@ -34,7 +34,8 @@
// This can be used to fetch the newly created asset after the change block has completed by using -localIdentifier
// It can also be added directly to collections within the current change block
@property (nonatomic, strong, readonly, nullable) PHObjectPlaceholder *placeholderForCreatedAsset;
-// The rating for this asset
+
+/// The rating for this asset
@property (nonatomic, assign, readwrite) PHAssetRating rating API_AVAILABLE(macos(27), ios(27), tvos(27), visionos(27));
/// An asset description to change to.
diff -ruN /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetExtendedMetadata.h /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetExtendedMetadata.h
--- /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetExtendedMetadata.h 2026-07-11 03:53:05
+++ /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetExtendedMetadata.h 2026-08-05 01:24:45
@@ -12,8 +12,8 @@
/// Represents other asset attributes that are not included when fetching `PHAsset` directly.
///
-/// When `PHAsset.extendedMetadata` is called, these properties are fetched. They can be
-/// prefetched by toggling `PHFetchOptions.prefetchAssetExtendedMetadata` when fetching `PHAsset`.
+/// When ``/Photos/PHAsset/extendedMetadata`` is called, these properties are fetched. They can be
+/// prefetched by toggling ``/Photos/PHFetchOptions/prefetchAssetExtendedMetadata`` when fetching ``/Photos/PHAsset``.
API_AVAILABLE(macos(27), ios(27), tvos(27), visionos(27))
OS_EXPORT
NS_SWIFT_SENDABLE
@@ -23,7 +23,7 @@
@property (copy, readonly, nullable) NSString *caption;
/// The original file name of this asset.
-@property (copy, readonly, nullable) NSString *originalFileName;
+@property (copy, readonly, nullable) NSString *originalFilename;
/// The keywords associated with this asset
@property (copy, readonly) NSArray<NSString *> *keywords;
diff -ruN /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResource.h /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResource.h
--- /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResource.h 2026-07-11 03:53:05
+++ /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResource.h 2026-08-05 01:24:45
@@ -25,7 +25,12 @@
/// The local identifier of the asset associated with this asset resource
@property (nonatomic, copy, readonly) NSString *assetLocalIdentifier;
-@property (nonatomic, copy, readonly) NSString *originalFilename;
+
+@property (nonatomic, copy, readonly) NSString *originalFilename API_DEPRECATED("Use filename instead", ios(9, 27), macos(10.15, 27), tvos(10, 27), visionos(1, 27));
+
+
+/// 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`)
@property (nonatomic, copy, readonly) UTType *contentType API_AVAILABLE(macos(26.0), ios(26.0), tvos(26.0), visionos(26.0));
diff -ruN /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResourceUploadJobOptions.h /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResourceUploadJobOptions.h
--- /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResourceUploadJobOptions.h 1969-12-31 19:00:00
+++ /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHAssetResourceUploadJobOptions.h 2026-08-05 01:24:44
@@ -0,0 +1,23 @@
+//
+// PHAssetResourceUploadJobOptions.h
+// Copyright © 2026 Apple Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// Options that affect the service behavior when processing Asset Resource Upload Jobs.
+API_AVAILABLE(ios(27.0), macCatalyst(27.0), macos(27.0)) API_UNAVAILABLE(tvos, visionos, watchos)
+@interface PHAssetResourceUploadJobOptions : NSObject <NSCopying>
+
+/// Prevents expensive network access, such as cellular, for the service.
+///
+/// When `true`, the service only performs work for the associated configuration while the
+/// device has a non-expensive network connection (such as Wi-Fi or Ethernet); cellular
+/// connectivity is not used. Defaults to `false`.
+@property (nonatomic, assign) BOOL preventsExpensiveNetworkAccess;
+
+@end
+
+NS_ASSUME_NONNULL_END
diff -ruN /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHPhotoLibrary.h /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHPhotoLibrary.h
--- /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHPhotoLibrary.h 2026-07-11 04:56:14
+++ /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PHPhotoLibrary.h 2026-08-06 01:22:45
@@ -15,6 +15,7 @@
@class PHPhotoLibrary;
@class PHPersistentChangeToken;
@class PHPersistentChangeFetchResult;
+@class PHAssetResourceUploadJobOptions;
typedef NS_ENUM(NSInteger, PHAuthorizationStatus) {
@@ -94,7 +95,38 @@
/// - Parameters:
/// - enable: `true` allows calls to the extension's host application; you can fulfill that protocol to create ``PHAssetResourceUploadJob`` objects. `false` stops calls to the extension's host application.
/// - error: if either enabling or disabling was unsuccessful, `false` is returned and an error is set on the `error` parameter.
-- (BOOL)setUploadJobExtensionEnabled:(BOOL)enable error:(NSError * __autoreleasing *)error API_AVAILABLE(ios(26.1), macCatalyst(27.0), macos(27.0)) API_UNAVAILABLE(tvos, visionos, watchos);
+- (BOOL)setUploadJobExtensionEnabled:(BOOL)enable error:(NSError **)error API_DEPRECATED("Use -enableUploadJobExtensionWithOptions:error: and -disableUploadJobExtensionWithError: instead", ios(26.1, 27.0)) API_UNAVAILABLE(macCatalyst, macos, tvos, visionos, watchos);
+
+/// Enables the background asset resource upload job feature with the given options, atomically.
+///
+/// The configuration is created with `options` already set, as a single change — unlike calling
+/// ``setUploadJobExtensionOptions:error:`` afterward, as a separate change.
+///
+/// - Parameters:
+/// - options: the options to set for the newly enabled configuration, or `nil` to use default values.
+/// - error: if enabling was unsuccessful, `false` is returned and an error is set on the `error` parameter.
+- (BOOL)enableUploadJobExtensionWithOptions:(nullable PHAssetResourceUploadJobOptions *)options error:(NSError **)error API_AVAILABLE(ios(27.0), macCatalyst(27.0), macos(27.0)) API_UNAVAILABLE(tvos, visionos, watchos);
+
+/// Disables the background asset resource upload job feature.
+///
+/// - Parameters:
+/// - error: if disabling was unsuccessful, `false` is returned and an error is set on the `error` parameter.
+- (BOOL)disableUploadJobExtensionWithError:(NSError **)error API_AVAILABLE(ios(27.0), macCatalyst(27.0), macos(27.0)) API_UNAVAILABLE(tvos, visionos, watchos);
+
+/// The options for the calling app's background asset resource upload job configuration.
+///
+/// The value is `nil` if the extension isn't enabled or the caller isn't authorized. Otherwise, the value is an
+/// options object with default values if the configuration exists but no options have been set.
+@property (readonly, nullable) PHAssetResourceUploadJobOptions *uploadJobExtensionOptions API_AVAILABLE(ios(27.0), macCatalyst(27.0), macos(27.0)) API_UNAVAILABLE(tvos, visionos, watchos);
+
+/// Sets the options for the calling app's background asset resource upload job configuration.
+///
+/// To reset the configuration's options to their default values, pass a newly-initialized `PHAssetResourceUploadJobOptions` instance.
+///
+/// - Parameters:
+/// - options: the options to set.
+/// - error: if the configuration could not be found, the caller isn't authorized, or the update failed, `false` is returned and an error is set on the `error` parameter.
+- (BOOL)setUploadJobExtensionOptions:(PHAssetResourceUploadJobOptions *)options error:(NSError **)error API_AVAILABLE(ios(27.0), macCatalyst(27.0), macos(27.0)) API_UNAVAILABLE(tvos, visionos, watchos);
#pragma mark - Library availability
diff -ruN /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/Photos.h /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/Photos.h
--- /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/Photos.h 2026-07-11 03:53:03
+++ /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/Photos.h 2026-08-05 01:24:43
@@ -34,6 +34,7 @@
#import <Photos/PHAssetResourceUploadJob.h>
#import <Photos/PHAssetResourceUploadJobChangeRequest.h>
+#import <Photos/PHAssetResourceUploadJobOptions.h>
#import <Photos/PHCollectionListChangeRequest.h>
#import <Photos/PHLivePhotoEditingContext.h>
diff -ruN /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PhotosTypes.h /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PhotosTypes.h
--- /Applications/Xcode_27.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PhotosTypes.h 2026-07-16 01:59:10
+++ /Applications/Xcode_27.0.0-beta5.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/Photos.framework/Headers/PhotosTypes.h 2026-08-05 02:12:56
@@ -38,10 +38,14 @@
// PHCollectionListTypeFolder subtypes
- /// A user-configurable, regular folder that can be created, or modified via `PHCollectionListChangeRequest`
+ /// A user-configurable folder containing albums or other folders.
+ ///
+ /// Can be created, or modified via ``/Photos/PHCollectionListChangeRequest``
PHCollectionListSubtypeRegularFolder = 100,
- /// The collection list that contains the top-level user collections, there is always one root folder in the library and does not allow `PHCollectionEditOperationRename` or `PHCollectionEditOperationDelete`
+ /// The collection list that contains the top-level user collections.
+ ///
+ /// There is always one root folder in the library and does not allow ``/Photos/PHCollectionEditOperation/PHCollectionEditOperationRename`` or ``/Photos/PHCollectionEditOperation/PHCollectionEditOperationDelete``
PHCollectionListSubtypeRootFolder API_AVAILABLE(macos(27), ios(27), tvos(27), visionos(27)) = 101,
// PHCollectionListTypeSmartFolder subtypes
@@ -108,7 +112,11 @@
PHAssetCollectionSubtypeSmartAlbumUnableToUpload API_AVAILABLE(macos(10.15), ios(13), tvos(13)) = 216,
PHAssetCollectionSubtypeSmartAlbumRAW API_AVAILABLE(macos(12), ios(15), tvos(15)) = 217,
PHAssetCollectionSubtypeSmartAlbumCinematic API_AVAILABLE(macos(12), ios(15), tvos(15)) = 218,
+
+ /// A Smart Album that groups all photos and videos captured as spatial media.
PHAssetCollectionSubtypeSmartAlbumSpatial API_AVAILABLE(macos(15), ios(18), tvos(18)) = 219,
+
+ /// A Smart Album that groups all videos captured using the device’s screenrecordings function.
PHAssetCollectionSubtypeSmartAlbumScreenRecordings API_AVAILABLE(macos(11), ios(14), tvos(14)) = 220,