Skip to main content
Inspiring
May 22, 2026
Question

AIR 51.3.2.2 iOS app crashes with “Packaging Error, please check your assets.car file”

  • May 22, 2026
  • 2 replies
  • 60 views

Hi everyone,

I am currently having a critical issue with iOS packaging using Adobe AIR SDK 51.3.2.2 and would like to know if this is a known regression or if anyone has found a working solution.

Environment:

  • Adobe AIR SDK: 51.3.2.2

  • Adobe Animate

  • Xcode 26

  • iOS 18 / iPadOS 18+

  • Pure AIR application (NO ANEs, NO distriqt extensions)

Problem:
If I package my app using a custom Assets.car, the app installs successfully on the iPad/iPhone, shows the splash/title screen for about one second, then immediately crashes with the message:

“Packaging Error, please check your assets.car file”

What I already tested:

  • completely recreated Assets.car using Xcode

  • all required icon sizes added correctly

  • no transparency in PNGs

  • valid 120x120 icon included

  • Assets.car exists only once in the IPA

  • file is located correctly in the app root

  • CFBundleIconName set to AppIcon

  • tested renderMode="gpu" and renderMode="direct"

  • no ANEs used

  • re-signing IPA manually

  • tested on real devices

My AIR XML currently contains:

<iPhone>
<assetsCar>Assets.car</assetsCar>
<requestedDisplayResolution>high</requestedDisplayResolution>

<InfoAdditions><![CDATA[
<key>CFBundleIconName</key>
<string>AppIcon</string>
]]></InfoAdditions>
</iPhone>

Important:
If I REMOVE Assets.car and instead use classic PNG icons inside the <icon> tag, the app works perfectly on the device.

However, App Store Connect / Transporter then rejects the IPA with:

“Missing required icon file. The bundle does not contain an app icon of exactly 120x120 pixels…”

even though the 120x120 PNG definitely exists and is correctly referenced.

So currently I am stuck between:

  • Assets.car → App crashes

  • classic PNG icons → Upload rejected by Apple

I also found multiple reports describing similar regressions in AIR 51.2.x / 51.3.x with iOS 18+:

  • AIR apps crashing immediately after launch with “application packaging error”

  • issues related to Assets.car packaging/runtime lookup

Examples:

Has anyone found a stable workflow for:

  • AIR 51.3.x

  • Xcode 26

  • iOS 18+

  • App Store compliant icon packaging?

Or is this currently a confirmed AIR runtime regression?

Any help would be greatly appreciated because at the moment it is impossible to both:

  1. upload successfully to App Store Connect
    AND

  2. launch the app successfully on-device.

Thanks!

    2 replies

    Participant
    July 20, 2026

    I finally found the solution after spending many days debugging this issue, so I'd like to share it in case it helps someone else.

    Environment:
    - Adobe AIR SDK 51.3.x
    - Xcode 11 (also tested against newer Xcode versions)

    Symptoms:
    - The IPA builds successfully.
    - The app installs successfully.
    - The splash screen appears briefly.
    - Then the application immediately crashes with:

    "Packaging Error, please check your assets.car file"

    At first I thought the problem was related to Xcode or the generated Assets.car format, but after comparing multiple Assets.car files and reading the AIR release notes carefully, I discovered the real cause.

    The issue was NOT caused by missing App Icons.

    If you generate Assets.car manually using Xcode, you MUST also include the AIR splash image sets that are provided with the AIR SDK.

    They are located here:

    AIRSDK/lib/aot/res/

    and consist of these two folders:

    - splash_landscape.imageset
    - splash_portrait.imageset

    Important:
    Copy the entire ".imageset" folders (including their Contents.json files), NOT just the PNG images.

    Your Asset Catalog should look like this:

    Assets.xcassets
     ├── AppIcon.appiconset
     ├── splash_landscape.imageset
     ├── splash_portrait.imageset
     └── Contents.json

    Then rebuild (or Archive) the Xcode project and extract the newly generated Assets.car.

    To verify that the splash assets are actually inside the generated Assets.car, run:

    xcrun assetutil --dump-info Assets.car

    and make sure you can find both:

    - splash_landscape
    - splash_portrait

    After including these AIR splash assets inside Assets.car, the crash disappeared completely.

    Hopefully this saves someone else many hours of debugging.

    One final note:
    The AIR release notes mention an Assets.car-related issue and the SDK already includes these splash image sets under AIRSDK/lib/aot/res, but it's very easy to overlook this requirement when manually generating Assets.car. If you're creating your own Assets.car, make sure those two image sets are included before rebuilding.

     

    Participating Frequently
    June 11, 2026

    Hi, having the same issue and experience as you, did you find the solution?