Background Assets - Apple Hosted - iOS26

I've followed the setup process to get Apple Hosted Background Assets configured for my project.

(https://developer.apple.com/documentation/backgroundassets/downloading-apple-hosted-asset-packs)

But when I build and run the app I get the following error...

BackgroundAssets/AssetPackManager.swift:174: Fatal error: The process lacks a team ID.

I've checked the Signing->Team for both targets and they both have my Team associated.

Any help or advice would be appreciated...

Answered by Frameworks Engineer in 865993022

@andy_nash @tom_krikorian @Dokug In general, Background Assets requires that your app be properly code-signed with a real Apple Developer identity. We’ve identified a potential issue that prevents this check from working properly in the simulator. Until the fix is ready, you can test your app on a physical device. If you see this error on a physical device and can confirm that your code-signing settings are correct, then please file a feedback report with a sysdiagnose log from the affected device and a copy of your built products attached and reply to this thread with the feedback ID so that we can investigate further. Thanks!

Doesn't appear to work on simulator. Use a device

Hello! Could you file a feedback report in Feedback Assistant and attach the built app products? You can find the built products in Xcode’s Derived Data folder, to which you can navigate by selecting Product > Show Build Folder in Finder from Xcode’s menu bar. Please include details about the specific target device or simulator that’s experiencing the issue and reply to this thread with the feedback ID so that we can follow up. Thanks!

Hi,

Apologies for the delay, the feedback Id is FB20735813 with the app build folder attached.

The target is an iPhone Air running Simulator running iOS 26.1...

I believe I've followed all the steps in the configuration guide... https://developer.apple.com/documentation/backgroundassets/downloading-apple-hosted-asset-packs

Hope this helps.

--Andy

I'm having the same issue, looks like we can't use BackgroundAssets with Apple hosted Asset Packs with the simulator at all?

The same is happening for me when trying to debug this on my Mac/SwiftUI app.

Even though it is still not finding the asset pack, I worked around the fatal error by adding the following to my bundles entitlements:

<key>com.apple.developer.team-identifier</key>
    <string>$(DEVELOPMENT_TEAM)</string>

@andy_nash @tom_krikorian @Dokug In general, Background Assets requires that your app be properly code-signed with a real Apple Developer identity. We’ve identified a potential issue that prevents this check from working properly in the simulator. Until the fix is ready, you can test your app on a physical device. If you see this error on a physical device and can confirm that your code-signing settings are correct, then please file a feedback report with a sysdiagnose log from the affected device and a copy of your built products attached and reply to this thread with the feedback ID so that we can investigate further. Thanks!

Background Assets - Apple Hosted - iOS26
 
 
Q