Updating Flash Builder Burrito Applications to Flash Builder 4.5

April 27, 2011By 34 Comments

Have you downloaded the latest Flash Builder 4.5 from pre-release (and if you haven’t, what are you waiting for?!) and tried to import a project you built in Flash Builder Burrito only to find a bunch of errors? I made a list of things I discovered when going through this process and noted them below. Please comment here if you have any to add that I have missed so others can get up to speed quickly.

  • spark.components.MobileApplication is now spark.components.ViewNavigatorApplication
  • spark.components.TabbedMobileApplication is now spark.components.TabbedViewNavigatorApplication
  • spark.components.MobileIconItemRenderer is now spark.components.IconItemRenderer
  • FlexEvent.REMOVING is now ViewNavigatorEvent.REMOVING
  • spark.components.supportClasses.MobileTextField is now spark.components.supportClasses.StyleableTextField
  • The sessionCachingEnabled property on the root application tag for enabling data persistence is now persistNavigatorState
  • FlexEvent.APPLICATION_PERSISTING is now FlexEvent.NAVIGATOR_STATE_SAVING (for custom persistence handling)
  • FlexEvent.APPLICATION_RESTORING is now FlexEvent.NAVIGATOR_STATE_LOADING (for custom persistence handling)
  • spark.effects.ViewTransition is now spark.transitions.ViewTransitionBase
  • spark.effects.SlideViewTransition is now spark.transitions.SlideViewTransition
  • lineBreak is no longer a property on the Spark DataGrid
  • Default mobile theme colors have changed. The prior builds had a dark theme, so if you coded any specific colors around this theme you will have to change them because your UI will likely look funky.

Download the 2.6 version of Adobe AIR Launchpad from this link if you are using the Flash Builder 4.5 pre-release. It will generate projects that will work with the pre-release and the soon to be released official Flash Builder 4.5.

Filed in: Flash BuilderFlex 4.5 Tags:

About the Author ()

Comments (34)

Trackback URL | Comments RSS Feed

  1. Lionel says:

    Excellent ! I was hoping that Launchpad update would not take too long to come.

    Thanks !

  2. fuxin says:

    Excellent ! I was hoping that Launchpad update would not take too long to come.

    Thanks !

  3. Boris says:

    You saved the day. Thank you!

  4. When you change the MobileIconItemRenderer be sure to change the ‘decoratorClass’ to ‘decorator’

    Minor pain in the a** having to alter the minor things especially when working on a large application with many views. Thankfully the debug facility makes it an easier task.

  5. Wendy says:

    Great! Thank you very much! I am just working on this parts.

  6. Nathan5x says:

    Hi Holly,

    This is what I was looking for. I have a quick question, hope I get the solution.

    See, I’m using FB Burrito to build some simple mobile apps. I have downloaded the Flex SDK and configured it in my IDE. However still I’m not able to build TabbedMobileApplication or TabbedViewNavigatorApplication. Is it available in that SDK ? or should I use FB 4.5 to get the full fledged features?


  7. Wim Deblauwe says:

    What is the replacement for ‘returnedObject’ property?

    • devgirl says:

      Hi Wim, There is a navigator.poppedViewReturnedObject() with an object type of ViewReturnObject that is returned from the popped view when you override the createReturnObject() in your view. Is that what you’re looking for? Thanks! Holly

  8. Wim Deblauwe says:

    One more: ‘navigator.landscapeOrientation’ ?

    • devgirl says:

      Hi Wim, sounds like you might need:


      for the landscapeOrientation replacement…

      To clear the navigation stack you can use navigator.popAll();

      Hope that helps!

      • Wim Deblauwe says:


        I wanted to read the property, not set. I have found that you can use:


        This returns one of the constant strings in StageOrientation.

        navigator.popAll() indeed clears the stack, but it also visually changes the view. I wanted a method to keep the current view, but clear the history so that the backbutton would not go back. I have worked around it now by using ‘replaceView’ so I don’t need to clear the stack anymore.

        Thanks for the help.

  9. Wim Deblauwe says:

    And ‘navigator.navigationStack.clear()’ ?

    I tried ‘navigator.navigationLayout.clearVirtualLayoutCache()’, but that gives me a NullPointerException

  10. TYu says:

    FlexEvent.VIEW_ACTIVATE –> ViewNavigatorEvent.VIEW_ACTIVATE, and
    FlexEvent.VIEW_DEACTIVATE –>

    Anyone knows about Button.icon? Got an error, but not sure what to change to.

    • devgirl says:

      Try the iconDisplay property on Button…

      • Wim Deblauwe says:

        iconDisplay does not allow you to use a Class as icon.

        I think this should work instead:

        myButton.setStyle( “icon”, myIconClass )

        • devgirl says:

          Hi Wim, yes that is true, you would need to specify the URL to the icon as the source of a BitmapImage for iconDisplay, such as versus using a Class:

          var bi:BitmapImage = new BitmapImage();
          bi.source = "assets/icon.png";
          b.iconDisplay = bi;

          Just depends on your needs… sounds like you have your solution!


  11. Thibault Heylen says:

    I have installed the new SDK in my flash builder burrito but now I can’t make apk files anymore.

    When I click export release build the screen opens. I hit next but when I then click finish nothing happens. He doesn’t make my apk file.

    Someone a solution?

    Kind regards.

  12. Greg Gibson says:

    I get errors on the mx.controls.Alert buttons when I try to compile under the newly downloaded Flash Builder 4.5. Do you know of any alternatives for displaying a popup message to the user when building a Mobile App?

  13. Will Tonini says:

    Hi Holly! Thanks for putting this information together – really helpful (saved me a ton of work).

    One issue I’ve been struggling for a couple of days is that my application built with Burrito opens well with 4.5, builds ok, and I can debug it using the desktop simulator (not the one running on VMware). But when I open a mxml file in design mode, I receive the error: An unknown item is declared as the root of your MXML document.

    Could the fact of having my MXML using be a problem? If not, any guidance on what to look for would be greatly appreciated.



  14. dave says:

    Thanks for all the help here. thats awsome.

    But its really lame of Adobe to cause all these problems , I am up to my neck in errors caused by migrating from burrito to FB4.5 . Adobe really have **** this time.

  15. Jed Hatamosa says:

    Thanks for this post. It helped a lot. I have one question, can we still use the old sdk in burrito to run in flash builder 4.5? my project was done in burrito and migration to flash builder 4.5 is ok, but all the layout screwed. i have tried using the old sdk but it doesnt seem to work, maybe you have some suggestions. Thank you..

    • Hi Jed, can you show me a screenshot of what you mean with the layout? I would also suggest moving into the latest versus staying on the burrito SDK… Thanks! Holly

      • Jed says:

        Hi Holly, thanks for the reply. Actually i used MobileTextField a lot in my application and when i upgrade, it seems the dimensions were changed that’s why my layout screwed( labels etc. ). I guess ill just need to solve all this issues one by one. i dont have a choice but to upgrade to the latest. but is it really faster compared to burrito? Thanks Jed..

  16. Aaron says:

    Thank you for this article.
    It’s jus what a needed.

  17. Ian Bullock says:

    Just wanted to point out another property they’ve removed:

    textAlign is no longer a property of the Spark RadioButton

    Thankfully my project had only a few errors when upgrading, but this post certainly helped ease the transition a bit anyway! Thanks!

  18. Johnny Chang says:

    Hi Holly Schinsky

    I am using the flash builder 4.6, the error is the “the definition mx.controls.Alert could not be found” Could you help me how to solve it.
    thanks advanced

  19. Odum Samuel says:

    (Flex for the BlackBerry PlayBook in 90 Minutes)
    Good morning ma, i really want to thank adobe for
    the above mentioned tutorial i came across, it was
    very useful and informative. am having a problem
    with it, am using the new flash builder 4.6 and the
    code works well except for the part when you want to make the search feature work using the
    model.*. the list dataprovider gives error when
    you try to run it saying {data} which is in the
    dataprovider property is not correct. please ma can
    you help me out, am new to flex. am learning to
    build a mobile app that retrieves data from an xml file using httpservice, how do i add a search
    feature at the navigator part to search the data

Leave a Reply