Repository navigation
BackgroundAssets tvOS xcode27.2 b3
Alex Soto edited this page Oct 17, 2026
·
1 revision
#BackgroundAssets.framework
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAAssetPack.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAAssetPack.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAAssetPack.h 2026-08-08 18:27:45
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAAssetPack.h 2026-09-13 22:44:03
@@ -17,7 +17,7 @@
@interface BAAssetPack : NSObject
/// A unique identifier for the asset pack.
-@property (readonly, copy) NSString* identifier NS_SWIFT_NAME(id);
+@property (readonly, copy) NSString *identifier NS_SWIFT_NAME(id);
/// The size of the download file containing the asset pack in bytes.
///
@@ -30,14 +30,14 @@
/// The language, represented as a BCP-47 identifier, for which this asset pack is localized.
///
/// This property is `nil` if the asset pack isn’t localized and therefore isn’t language-specific.
-@property (nullable, readonly, copy) NSString* language
+@property (nullable, readonly, copy) NSString *language
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27))
NS_SWIFT_NAME(languageID);
/// JSON-encoded custom information that’s associated with the asset pack.
///
/// This property is `nil` for Apple-hosted asset packs.
-@property (nullable, readonly, copy) NSData* userInfo;
+@property (nullable, readonly, copy) NSData *userInfo;
- (null_unspecified instancetype)init NS_UNAVAILABLE;
@@ -45,13 +45,13 @@
/// Creates a download object for the asset pack that you schedule using a download manager.
/// - Remark: Use this method in your main app; use ``BAAssetPack/downloadForContentRequest:`` instead in your downloader extension.
-- (BADownload*)download;
+- (BADownload *)download;
/// Creates a download object for the asset pack that you schedule using a download manager.
/// - Parameter contentRequest: The content request for the current extension invocation.
/// - Returns: A download object.
/// - Remark: Use this method in your downloader extension; use ``BAAssetPack/download`` instead in your main app.
-- (BADownload*)downloadForContentRequest:(BAContentRequest)contentRequest;
+- (BADownload *)downloadForContentRequest:(BAContentRequest)contentRequest;
@end
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAAssetPackManager.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAAssetPackManager.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAAssetPackManager.h 2026-08-16 00:33:01
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAAssetPackManager.h 2026-09-13 22:44:03
@@ -8,6 +8,7 @@
#import <BackgroundAssets/BAAssetPackManifest.h>
#import <BackgroundAssets/BAAssetPackStatus.h>
#import <BackgroundAssets/BAManagedAssetPackDownloadDelegate.h>
+#import <BackgroundAssets/BASizeCalculationMethod.h>
NS_HEADER_AUDIT_BEGIN(nullability, sendability)
@@ -21,7 +22,7 @@
@interface BAAssetPackManager : NSObject
/// The shared asset-pack manager.
-@property (class, readonly, strong) BAAssetPackManager* sharedManager
+@property (class, readonly, strong) BAAssetPackManager *sharedManager
NS_SWIFT_NAME(shared);
/// An object that receives notifications about events that occur as an asset pack is downloaded.
@@ -33,7 +34,7 @@
///
/// Setting a new resolved language also changes your application’s display language.
/// - Note: Don’t set this property to a new value within your downloader extension.
-@property (nullable, readwrite, copy) NSString* resolvedLanguage
+@property (nullable, readwrite, copy) NSString *resolvedLanguage
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27))
NS_SWIFT_NAME(resolvedLanguageID);
@@ -43,7 +44,7 @@
/// Gets the manifest of asset packs that are available to download.
/// - Parameter completionHandler: A block that receives the manifest or an error if one occurs.
-- (void)getManifestWithCompletionHandler:(void (^)(BAAssetPackManifest* _Nullable manifest, NSError* _Nullable error))completionHandler
+- (void)getManifestWithCompletionHandler:(void (^)(BAAssetPackManifest * _Nullable manifest, NSError * _Nullable error))completionHandler
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27));
/// Gets the current status relative to a particular asset pack.
@@ -61,8 +62,8 @@
/// - Parameters:
/// - assetPack: The asset pack.
/// - completionHandler: A block that receives the current status relative to the asset pack or an error if one occurs.
-- (void)getStatusRelativeToAssetPack:(BAAssetPack*)assetPack
- completionHandler:(void (^)(BAAssetPackStatus status, NSError* _Nullable error))completionHandler
+- (void)getStatusRelativeToAssetPack:(BAAssetPack *)assetPack
+ completionHandler:(void (^)(BAAssetPackStatus status, NSError * _Nullable error))completionHandler
API_AVAILABLE(ios(26.4), macos(26.4), tvos(26.4), visionos(26.4));
/// Gets an asset pack’s local status.
@@ -76,27 +77,49 @@
/// - Parameters:
/// - assetPackIdentifier: The asset pack’s identifier.
/// - completionHandler: A block that receives the asset pack’s local status.
-- (void)getLocalStatusOfAssetPackWithIdentifier:(NSString*)assetPackIdentifier
+- (void)getLocalStatusOfAssetPackWithIdentifier:(NSString *)assetPackIdentifier
completionHandler:(void (^)(BAAssetPackStatus status))completionHandler
API_AVAILABLE(ios(26.4), macos(26.4), tvos(26.4), visionos(26.4));
/// Checks whether the asset pack with the specified identifier is available locally.
/// - Parameter assetPackIdentifier: The asset pack’s identifier.
/// - Returns: Whether the asset pack is available locally.
-- (BOOL)assetPackIsAvailableLocallyWithIdentifier:(NSString*)assetPackIdentifier
+- (BOOL)assetPackIsAvailableLocallyWithIdentifier:(NSString *)assetPackIdentifier
API_AVAILABLE(ios(26.4), macos(26.4), tvos(26.4), visionos(26.4))
NS_SWIFT_NAME(assetPackIsAvailableLocally(withID:));
+/// Returns a locally available asset pack’s version number.
+/// - Parameters:
+/// - assetPackIdentifier: The asset pack’s identifier.
+/// - error: A pointer to an error that will be set if an error occurs. If the asset pack isn’t available locally, then `error` will point to an `NSError` object with ``BAManagedErrorCode/BAManagedErrorCodeAssetPackNotFound`` as its code.
+/// - Returns: The asset pack’s version number. A return value of `-1` indicates that an error occurred.
+- (NSInteger)localVersionOfAssetPackWithIdentifier:(NSString *)assetPackIdentifier
+ error:(NSError * _Nullable *)error
+API_AVAILABLE(ios(27.2), macos(27.2), tvos(27.2), visionos(27.2))
+NS_SWIFT_NAME(localVersion(ofAssetPackWithID:error:));
+
+/// Calculates a locally available asset pack’s installation size.
+///
+/// This is different than the download size, which could be smaller. Calculating the size of an asset pack that contains many files can take a long time.
+/// - Parameters:
+/// - assetPackIdentifier: The asset pack’s identifier.
+/// - calculationMethod: The method to use to calculate the asset pack’s installation size.
+/// - completionHandler: A block that receives the asset pack’s installation size in bytes or an error if one occurs. If the asset pack isn’t available locally, then the `error` parameter will point to an `NSError` object with ``BAManagedErrorCode/BAManagedErrorCodeAssetPackNotFound`` as its code.
+- (void)getLocalSizeOfAssetPackWithIdentifier:(NSString *)assetPackIdentifier
+ calculationMethod:(BASizeCalculationMethod)calculationMethod
+ completionHandler:(void (^)(signed long long int size, NSError * _Nullable error))completionHandler
+API_AVAILABLE(ios(27.2), macos(27.2), tvos(27.2), visionos(27.2));
+
/// Gets the languages used by asset packs that are localized and are available locally.
/// - Parameter completionHandler: A block that receives an array of BCP-47 language identifiers.
-- (void)getLocallyAvailableLanguagesWithCompletionHandler:(void (^)(NSArray<NSString*>* languageIdentifiers))completionHandler
+- (void)getLocallyAvailableLanguagesWithCompletionHandler:(void (^)(NSArray<NSString *> *languageIdentifiers))completionHandler
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27));
/// Reconciles the set of locally available asset packs with the current preferred languages.
///
/// This method downloads any missing localized asset packs, waits for those downloads to finish, and removes any unneeded ones. If you’ve overridden the preferred languages by setting ``resolvedLanguage``, then this method respects that selection. Don’t use this method if your application offers split-language functionality; instead, handle the reconciliation manually.
/// - Parameter completionHandler: A block that’s called when the the system has successfully reconciled the set of locally available asset packs with the user’s preferred languages or that receives an error if one occurs.
-- (void)reconcilePreferredLanguagesWithCompletionHandler:(void (^)(NSError* _Nullable error))completionHandler
+- (void)reconcilePreferredLanguagesWithCompletionHandler:(void (^)(NSError * _Nullable error))completionHandler
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27));
/// Ensures that the specified asset pack is available locally, performing a download if necessary.
@@ -108,8 +131,8 @@
/// - assetPack: The asset pack the local availability of which to ensure.
/// - completionHandler: A block that’s called when the asset pack is available locally or that receives an error if one occurs.
/// - Note: This method doesn’t check for updates. It’s equivalent to calling ``BAAssetPackManager/ensureLocalAvailabilityOfAssetPack:requireLatestVersion:completionHandler:`` and passing `NO` to the `shouldUpdate` parameter.
-- (void)ensureLocalAvailabilityOfAssetPack:(BAAssetPack*)assetPack
- completionHandler:(void (^)(NSError* _Nullable error))completionHandler;
+- (void)ensureLocalAvailabilityOfAssetPack:(BAAssetPack *)assetPack
+ completionHandler:(void (^)(NSError * _Nullable error))completionHandler;
/// Ensures that the specified asset pack is available locally, performing a download if necessary.
///
@@ -120,9 +143,9 @@
/// - assetPack: The asset pack the local availability of which to ensure.
/// - shouldUpdate: Whether to require that the latest version be available locally. When `YES` is passed to this parameter, the method will wait for the update (if there indeed is one available) to be downloaded before returning. When `NO` is passed, the method won’t check for updates and won’t attempt to download any.
/// - completionHandler: A block that’s called when the asset pack is available locally or that receives an error if one occurs.
-- (void)ensureLocalAvailabilityOfAssetPack:(BAAssetPack*)assetPack
+- (void)ensureLocalAvailabilityOfAssetPack:(BAAssetPack *)assetPack
requireLatestVersion:(BOOL)shouldUpdate
- completionHandler:(void (^)(NSError* _Nullable error))completionHandler
+ completionHandler:(void (^)(NSError * _Nullable error))completionHandler
API_AVAILABLE(ios(26.4), macos(26.4), tvos(26.4), visionos(26.4));
/// Ensures that the specified asset packs are available locally.
@@ -132,8 +155,8 @@
/// - assetPacks: The asset packs the local availability of which to ensure.
/// - completionHandler: A block that’s called when the asset packs are all available locally or that receives an error if one occurs.
/// - Note: This method doesn’t check for updates. It’s equivalent to calling ``BAAssetPackManager/ensureLocalAvailabilityOfAssetPacks:requireLatestVersions:completionHandler:`` and passing `NO` to the `shouldUpdate` parameter.
-- (void)ensureLocalAvailabilityOfAssetPacks:(NSSet<BAAssetPack*>*)assetPacks
- completionHandler:(void (^)(NSError* _Nullable error))completionHandler
+- (void)ensureLocalAvailabilityOfAssetPacks:(NSSet<BAAssetPack *> *)assetPacks
+ completionHandler:(void (^)(NSError * _Nullable error))completionHandler
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27));
/// Ensures that the specified asset packs are available locally, performing a batch download if necessary.
@@ -143,14 +166,14 @@
/// - assetPacks: The asset packs the local availability of which to ensure.
/// - shouldUpdate: Whether to require that the respective latest versions be available locally. When `YES` is passed to this parameter, the method will wait for the updates (if there indeed are any available) to be downloaded before returning. When `NO` is passed, the method won’t check for updates and won’t attempt to download any.
/// - completionHandler: A block that’s called when the asset packs are all available locally or that receives an error if one occurs.
-- (void)ensureLocalAvailabilityOfAssetPacks:(NSSet<BAAssetPack*>*)assetPacks
+- (void)ensureLocalAvailabilityOfAssetPacks:(NSSet<BAAssetPack *> *)assetPacks
requireLatestVersions:(BOOL)shouldUpdate
- completionHandler:(void (^)(NSError* _Nullable error))completionHandler
+ completionHandler:(void (^)(NSError * _Nullable error))completionHandler
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27));
/// Gets the latest asset-pack information from the server, updates outdated asset packs, and removes obsolete asset packs.
/// - Parameter completionHandler: A block that receives a set of identifiers of asset packs that are being updated and a set of identifiers of removed asset packs or an error if one occurs.
-- (void)checkForUpdatesWithCompletionHandler:(nullable void (^)(NSSet<NSString*>* _Nullable updatingIdentifiers, NSSet<NSString*>* _Nullable removedIdentifiers, NSError* _Nullable error))completionHandler;
+- (void)checkForUpdatesWithCompletionHandler:(nullable void (^)(NSSet<NSString *> * _Nullable updatingIdentifiers, NSSet<NSString *> * _Nullable removedIdentifiers, NSError * _Nullable error))completionHandler;
/// Returns the contents of an asset file at the specified relative path.
///
@@ -161,10 +184,10 @@
/// - options: Options for how to read the file’s contents into a data object.
/// - error: A pointer to an error that will be set if an error occurs. If no file is found at `path`, then `error` will point to an `NSError` object with ``BAManagedErrorCode/BAManagedErrorCodeFileNotFound`` as its code.
/// - Returns: The file’s contents or `nil` if an error occurred.
-- (nullable NSData*)contentsAtPath:(NSString*)path
-searchingInAssetPackWithIdentifier:(nullable NSString*)assetPackIdentifier
- options:(NSDataReadingOptions)options
- error:(NSError* _Nullable *)error
+- (nullable NSData *)contentsAtPath:(NSString *)path
+ searchingInAssetPackWithIdentifier:(nullable NSString *)assetPackIdentifier
+ options:(NSDataReadingOptions)options
+ error:(NSError * _Nullable *)error
NS_SWIFT_NAME(contents(atPath:searchingInAssetPackWithID:options:));
/// Returns the contents of a localized asset file at the specified relative path.
@@ -179,10 +202,10 @@
/// - options: Options for how to read the file’s contents into a data object.
/// - error: A pointer to an error that will be set if an error occurs. If no file is found at `path`, then `error` will point to an `NSError` object with ``BAManagedErrorCode/BAManagedErrorCodeFileNotFound`` as its code.
/// - Returns: The file’s contents or `nil` if an error occurred.
-- (nullable NSData*)contentsAtPath:(NSString*)path
- asLocalizedForLanguage:(NSString*)languageIdentifier
- options:(NSDataReadingOptions)options
- error:(NSError* _Nullable *)error
+- (nullable NSData *)contentsAtPath:(NSString *)path
+ asLocalizedForLanguage:(NSString *)languageIdentifier
+ options:(NSDataReadingOptions)options
+ error:(NSError * _Nullable *)error
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27))
NS_SWIFT_NAME(contents(atPath:asLocalizedForLanguageWithID:options:));
@@ -196,9 +219,9 @@
/// - error: A pointer to an error that will be set if an error occurs. If no file is found at `path`, then it will point to an `NSError` object with ``BAManagedErrorCode/BAManagedErrorCodeFileNotFound`` as its code.
/// - Returns: A descriptor for the opened file. A return value of `-1` indicates that an error occurred.
/// - Remark: Use this method if you need low-level access to the file descriptor. If you don’t, then use ``BAAssetPackManager/contentsAtPath:searchingInAssetPackWithIdentifier:options:error:`` instead.
-- (signed int)fileDescriptorForPath:(NSString*)path
- searchingInAssetPackWithIdentifier:(nullable NSString*)assetPackIdentifier
- error:(NSError* _Nullable *)error
+- (signed int)fileDescriptorForPath:(NSString *)path
+ searchingInAssetPackWithIdentifier:(nullable NSString *)assetPackIdentifier
+ error:(NSError * _Nullable *)error
NS_SWIFT_NAME(descriptor(forPath:searchingInAssetPackWithID:error:));
/// Opens and returns a file descriptor for a localized asset file at the specified relative path.
@@ -214,9 +237,9 @@
/// - error: A pointer to an error that will be set if an error occurs. If no file is found at `path`, then it will point to an `NSError` object with ``BAManagedErrorCode/BAManagedErrorCodeFileNotFound`` as its code.
/// - Returns: A descriptor for the opened file. A return value of `-1` indicates that an error occurred.
/// - Remark: Use this method if you need low-level access to the file descriptor. If you don’t, then use ``BAAssetPackManager/contentsAtPath:asLocalizedForLanguage:options:error:`` instead.
-- (signed int)fileDescriptorForPath:(NSString*)path
- asLocalizedForLanguage:(NSString*)languageIdentifier
- error:(NSError* _Nullable *)error
+- (signed int)fileDescriptorForPath:(NSString *)path
+ asLocalizedForLanguage:(NSString *)languageIdentifier
+ error:(NSError * _Nullable *)error
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27))
NS_SWIFT_NAME(descriptor(forPath:asLocalizedForLanguageWithID:error:));
@@ -230,8 +253,8 @@
/// - path: The relative file path.
/// - error: A pointer to an error that will be set if an error occurs.
/// - Returns: The URL to the item or `nil` if an error occurred.
-- (nullable NSURL*)URLForPath:(NSString*)path
- error:(NSError* _Nullable *)error
+- (nullable NSURL *)URLForPath:(NSString *)path
+ error:(NSError * _Nullable *)error
NS_SWIFT_NAME(url(forPath:));
/// Returns a URL for the specified relative path.
@@ -248,9 +271,9 @@
/// - languageIdentifier: The language, represented as a BCP-47 identifier, that the framework uses to limit the search within localized asset packs.
/// - error: A pointer to an error that will be set if an error occurs.
/// - Returns: The URL to the item or `nil` if an error occurred.
-- (nullable NSURL*)URLForPath:(NSString *)path
- asLocalizedForLanguage:(NSString*)languageIdentifier
- error:(NSError * _Nullable *)error
+- (nullable NSURL *)URLForPath:(NSString *)path
+ asLocalizedForLanguage:(NSString *)languageIdentifier
+ error:(NSError * _Nullable *)error
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27))
NS_SWIFT_NAME(url(forPath:asLocalizedForLanguageWithID:));
@@ -258,8 +281,8 @@
/// - Parameters:
/// - assetPackIdentifier: The asset pack’s identifier.
/// - completionHandler: A block that receives an error if one occurs.
-- (void)removeAssetPackWithIdentifier:(NSString*)assetPackIdentifier
- completionHandler:(nullable void (^)(NSError* _Nullable error))completionHandler
+- (void)removeAssetPackWithIdentifier:(NSString *)assetPackIdentifier
+ completionHandler:(nullable void (^)(NSError * _Nullable error))completionHandler
NS_SWIFT_ASYNC_NAME(remove(assetPackWithID:));
// MARK: Deprecated
@@ -268,7 +291,7 @@
///
/// This method may attempt to get the latest asset-pack information from the server.
/// - Parameter completionHandler: A block that receives the asset packs or an error if one occurs.
-- (void)getAllAssetPacksWithCompletionHandler:(void (^)(NSSet<BAAssetPack*>* _Nullable assetPacks, NSError* _Nullable error))completionHandler
+- (void)getAllAssetPacksWithCompletionHandler:(void (^)(NSSet<BAAssetPack *> * _Nullable assetPacks, NSError * _Nullable error))completionHandler
API_DEPRECATED("Send -getManifestWithCompletionHandler: to obtain a manifest, and send -assetPacks to that manifest to obtain the set of asset packs.", ios(26, 27), macos(26, 27), tvos(26, 27), visionos(26, 27));
/// Gets the asset pack with the given identifier.
@@ -277,8 +300,8 @@
/// - Parameters:
/// - assetPackIdentifier: The asset pack’s identifier.
/// - completionHandler: A block that receives the asset pack or an error if one occurs.
-- (void)getAssetPackWithIdentifier:(NSString*)assetPackIdentifier
- completionHandler:(void (^)(BAAssetPack* _Nullable assetPack, NSError* _Nullable error))completionHandler
+- (void)getAssetPackWithIdentifier:(NSString *)assetPackIdentifier
+ completionHandler:(void (^)(BAAssetPack * _Nullable assetPack, NSError * _Nullable error))completionHandler
API_DEPRECATED("Send -getManifestWithCompletionHandler: to obtain a manifest, and send -assetPackWithIdentifier: to that manifest to obtain an asset pack.", ios(26, 27), macos(26, 27), tvos(26, 27), visionos(26, 27));
/// Gets an asset pack’s status.
@@ -287,8 +310,8 @@
/// - Parameters:
/// - assetPackIdentifier: The asset pack’s identifier.
/// - completionHandler: A block that receives the asset pack’s status or an error if one occurs.
-- (void)getStatusOfAssetPackWithIdentifier:(NSString*)assetPackIdentifier
- completionHandler:(void (^)(BAAssetPackStatus status, NSError* _Nullable error))completionHandler
+- (void)getStatusOfAssetPackWithIdentifier:(NSString *)assetPackIdentifier
+ completionHandler:(void (^)(BAAssetPackStatus status, NSError * _Nullable error))completionHandler
API_DEPRECATED_WITH_REPLACEMENT("Send -getStatusRelativeToAssetPack:completionHandler: instead.", ios(26, 26.4), macos(26, 26.4), tvos(26, 26.4), visionos(26, 26.4));
@end
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAAssetPackManifest.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAAssetPackManifest.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAAssetPackManifest.h 2026-08-08 20:44:42
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAAssetPackManifest.h 2026-10-04 02:55:51
@@ -17,29 +17,29 @@
@interface BAAssetPackManifest : NSObject
/// The asset packs in this manifest that are available to download.
-@property (readonly, copy) NSSet<BAAssetPack*>* assetPacks;
+@property (readonly, copy) NSSet<BAAssetPack *> *assetPacks;
/// The application’s primary language, represented as a BCP-47 identifier, as configured in App Store Connect.
///
/// If no available localized asset packs match the current preferred languages, the system falls back on the application’s primary language.
-@property (nullable, readonly, copy) NSString* primaryLanguage
+@property (nullable, readonly, copy) NSString *primaryLanguage
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27))
NS_SWIFT_NAME(primaryLanguageID);
/// The languages, represented as their respective BCP-47 identifiers, for which asset packs in this manifest are localized.
-@property (readonly, copy) NSArray<NSString*>* availableLanguages
+@property (readonly, copy) NSArray<NSString *> *availableLanguages
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27))
NS_SWIFT_NAME(availableLanguageIDs);
/// The language, represented as a BCP-47 identifier, asset packs in this manifest that are localized for which the system automatically makes available locally.
///
/// The user’s preferred languages inform the choice of resolved language, respecting any language that your application sets manually by setting ``BAAssetPackManager/resolvedLanguage``. This property may be `nil` if no localized asset packs are available. If the user recently changed their preferred language or if this manifest is outdated, this property’s value may be out of sync with the set of asset packs available locally.
-@property (nullable, readonly, copy) NSString* resolvedLanguage
+@property (nullable, readonly, copy) NSString *resolvedLanguage
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27))
NS_SWIFT_NAME(resolvedLanguageID);
/// The subset of asset packs in this manifest that best match the current preferred languages.
-@property (readonly, copy) NSSet<BAAssetPack*>* localizedAssetPacks
+@property (readonly, copy) NSSet<BAAssetPack *> *localizedAssetPacks
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27));
- (null_unspecified instancetype)init NS_UNAVAILABLE;
@@ -49,9 +49,9 @@
/// - URL: A URL to a local JSON file.
/// - applicationGroupIdentifier: The identifier of the application group in which to store unmanaged asset packs that are downloaded from the manifest.
/// - error: A pointer to an error that will be set if an error occurs.
-- (nullable instancetype)initWithContentsOfURL:(NSURL*)URL
- applicationGroupIdentifier:(NSString*)applicationGroupIdentifier
- error:(NSError* _Nullable * _Nullable)error
+- (nullable instancetype)initWithContentsOfURL:(NSURL *)URL
+ applicationGroupIdentifier:(NSString *)applicationGroupIdentifier
+ error:(NSError * _Nullable * _Nullable)error
NS_SWIFT_NAME(init(contentsOf:appGroupID:));
/// Initializes a representation of a manifest in memory from JSON-encoded data.
@@ -59,9 +59,9 @@
/// - data: JSON-encoded data.
/// - applicationGroupIdentifier: The identifier of the application group in which to store unmanaged asset packs that are downloaded from the manifest.
/// - error: A pointer to an error that will be set if an error occurs.
-- (nullable instancetype)initFromData:(NSData*)data
- applicationGroupIdentifier:(NSString*)applicationGroupIdentifier
- error:(NSError* _Nullable * _Nullable)error
+- (nullable instancetype)initFromData:(NSData *)data
+ applicationGroupIdentifier:(NSString *)applicationGroupIdentifier
+ error:(NSError * _Nullable * _Nullable)error
NS_SWIFT_NAME(init(from:appGroupID:));
+ (null_unspecified instancetype)new NS_UNAVAILABLE;
@@ -69,7 +69,7 @@
/// Returns the asset pack in this manifest with the given identifier.
/// - Parameter assetPackIdentifier: The asset pack’s identifier.
/// - Returns: The asset pack, if it could be found in this manifest; otherwise, `nil`.
-- (nullable BAAssetPack*)assetPackWithIdentifier:(NSString*)assetPackIdentifier
+- (nullable BAAssetPack *)assetPackWithIdentifier:(NSString *)assetPackIdentifier
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27))
NS_SWIFT_NAME(assetPack(withID:));
@@ -78,7 +78,7 @@
/// Depending on which languages are available, the returned asset packs’ respective languages may not exactly match the specified language.
/// - Parameter languageIdentifier: The language’s BCP-47 identifier.
/// - Returns: The localized asset packs.
-- (NSSet<BAAssetPack*>*)localizedAssetPacksForLanguage:(NSString*)languageIdentifier
+- (NSSet<BAAssetPack *> *)localizedAssetPacksForLanguage:(NSString *)languageIdentifier
API_AVAILABLE(ios(27), macos(27), tvos(27), visionos(27))
NS_SWIFT_NAME(localizedAssetPacks(forLanguageWithID:));
@@ -87,7 +87,7 @@
/// The returned download objects can be scheduled with the download manager.
/// - Returns: A collection of download objects.
/// - Remark: Use this method in your main application; use ``allDownloadsForContentRequest:`` in your downloader extension.
-- (NSSet<BADownload*>*)allDownloads;
+- (NSSet<BADownload *> *)allDownloads;
/// Creates download objects for every asset pack in this manifest.
///
@@ -95,7 +95,7 @@
/// - Parameter contentRequest: The content request for the current extension invocation.
/// - Returns: A collection of download objects.
/// - Remark: Use this method in your downloader extension; use ``allDownloads`` instead in your main application.
-- (NSSet<BADownload*>*)allDownloadsForContentRequest:(BAContentRequest)contentRequest;
+- (NSSet<BADownload *> *)allDownloadsForContentRequest:(BAContentRequest)contentRequest;
@end
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAManagedAssetPackDownloadDelegate.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAManagedAssetPackDownloadDelegate.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAManagedAssetPackDownloadDelegate.h 2026-08-08 18:27:44
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAManagedAssetPackDownloadDelegate.h 2026-09-13 22:44:03
@@ -20,29 +20,29 @@
/// Notifies the receiver that the download began or resumed after being paused.
/// - Parameter assetPack: The asset pack.
-- (void)downloadOfAssetPackBegan:(BAAssetPack*)assetPack;
+- (void)downloadOfAssetPackBegan:(BAAssetPack *)assetPack;
/// Notifies the receiver that the download paused.
/// - Parameter assetPack: The asset pack.
-- (void)downloadOfAssetPackPaused:(BAAssetPack*)assetPack;
+- (void)downloadOfAssetPackPaused:(BAAssetPack *)assetPack;
/// Notifies the receiver that the download is in progress.
/// - Parameters:
/// - assetPack: The asset pack.
/// - progress: The download progress.
-- (void)downloadOfAssetPack:(BAAssetPack*)assetPack
- hasProgress:(NSProgress*)progress;
+- (void)downloadOfAssetPack:(BAAssetPack *)assetPack
+ hasProgress:(NSProgress *)progress;
/// Notifies the receiver that the download completed and that the asset pack is available locally.
/// - Parameter assetPack: The asset pack.
-- (void)downloadOfAssetPackFinished:(BAAssetPack*)assetPack;
+- (void)downloadOfAssetPackFinished:(BAAssetPack *)assetPack;
/// Notifies the receiver that the download failed.
/// - Parameters:
/// - assetPack: The asset pack.
/// - error: The error that occurred.
-- (void)downloadOfAssetPack:(BAAssetPack*)assetPack
- failedWithError:(NSError*)error;
+- (void)downloadOfAssetPack:(BAAssetPack *)assetPack
+ failedWithError:(NSError *)error;
@end
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAManagedDownloaderExtension.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAManagedDownloaderExtension.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAManagedDownloaderExtension.h 2026-08-08 18:27:44
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BAManagedDownloaderExtension.h 2026-09-13 22:44:03
@@ -64,6 +64,6 @@
/// By default, the system automatically downloads all applicable asset packs with either “essential” or “prefetch” download policies for the current installation event type. You can optionally implement this method to filter out unwanted asset packs at runtime.
/// - Parameter assetPack: An asset pack that’s being considered as a candidate to be downloaded.
/// - Returns: Whether the asset pack should be downloaded.
-- (BOOL)shouldDownloadAssetPack:(nonnull BAAssetPack*)assetPack;
+- (BOOL)shouldDownloadAssetPack:(nonnull BAAssetPack *)assetPack;
@end
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BASizeCalculationMethod.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BASizeCalculationMethod.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BASizeCalculationMethod.h 1969-12-31 19:00:00
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BASizeCalculationMethod.h 2026-09-13 22:44:03
@@ -0,0 +1,23 @@
+//
+// BASizeCalculationMethod.h
+// Background Assets
+//
+// Created by Gabriel Jacoby-Cooper on 8/7/26.
+//
+
+#import <Foundation/Foundation.h>
+
+/// Methods for calculating a file’s size.
+typedef NS_ENUM(NSInteger, BASizeCalculationMethod) {
+
+ /// A calculation method that counts the number of bytes in a file.
+ ///
+ /// The result of a “logical” size calculation for a file may be greater or less than the actual number of bytes that a file takes up on disk due to file-system features like alignment or compression.
+ BASizeCalculationMethodLogical,
+
+ /// A calculation method that counts the number of bytes that the file system allocated for a file.
+ ///
+ /// The result of an “allocated” size calculation for a file roughly corresponds to the number of bytes that would newly be made available if the file were removed.
+ BASizeCalculationMethodAllocated
+
+} API_AVAILABLE(ios(27.2), macos(27.2), tvos(27.2), visionos(27.2)) API_UNAVAILABLE(watchos) NS_SWIFT_NAME(SizeCalculationMethod);
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BackgroundAssets.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BackgroundAssets.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BackgroundAssets.h 2026-08-08 18:27:44
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/BackgroundAssets.framework/Headers/BackgroundAssets.h 2026-09-13 22:44:02
@@ -26,3 +26,4 @@
#import <BackgroundAssets/BAManagedAssetPackDownloadDelegate.h>
#import <BackgroundAssets/BAManagedDownloaderExtension.h>
#import <BackgroundAssets/BAManagedError.h>
+#import <BackgroundAssets/BASizeCalculationMethod.h>