Open Source & Free  

Codename One 3.3 Release Notes

Codename One 3.3 Release Notes


Version 3.3 starts a trend of refinement that we hope to stretch into version 3.4. We modernized a lot
of details and continued trends from 3.2 such as performance, background process support, terse syntax etc.

Highlights – Click For Details

Faster rendering of backgrounds & Labels

Animation Manager, Title Animations & Style Animations

“Remastered” Documentation (ongoing)

Material Design Icons

Media Playback & Geo Fencing in the Background

PhoneGap/Cordova Compatibility

New hello world project & icon

New Simplified Native Fonts

Terse syntax enhancements

ParparVM Performance & Open Source

Properties file format support

Ending Support for the codescan API


  • Fixed bug in Javascript bridge that seemed to affect Android only. This bug would sometimes cause get() to
    return null for a Javascript expression that should be non-null.
  • Fix for #1645 when a style was changed on the EDT the currently queued async paint got changed as well
  • Updated the usage of the @inheritDoc javadoc tag which was misused thru the entire codebase
  • Fix for NPE when initializing the UI too soon Fix for NPE when initializing the UI too soon
  • Added JavaDocs and code samples to Dialog Added JavaDocs and code samples to Dialog
  • Minimised the overhead of drawString in Android in a similar way to the iOS port by drawing on a bitmap within the EDT instead of on the Android thread.
  • Fixed infinite progress javadocs
  • Fixed bug with OnOff switch that printed the ‘on-off’ state of the switch as text even if the flag was set to disable
  • Added ability to programmatically set the on, off, and mask images for the OnOff switch to allow for greater
    ‘per-instance’ customization of an off switch.
  • Fixed transform issue on iOS mutable images reported at
  • Added easy ability to toggle on/off the new paint modes for Android
  • Initial work on new graphics optimization that caches paint data
  • Merge pull request #1643 from @McSym28 isSupported() should be static
  • Merge pull request #1637 from @ddyer0 – remember the requested size for derived fonts
  • Fixed issue with text fields intermittently showing the text from the previous text field when clicking ‘Next’ in async
    edit mode on iOS.
  • Merge pull request #1636 from @ddyer0 – Fix an additional error loop in the VM socket implementation
  • Minor performance improvement for async paint
  • Workaround for usage of gradients in designer where developers set the same color on a linear gradient to get a solid color
  • Fix for URLImage to throw exceptions sooner:
  • Added support for Picker preferredPopupWidth and preferredPopupHeight that can be used on platforms like iPad
    to decide how big the picker popup should be. Currently only implemented for iPad, and not relevant to iPhone.
  • Merge pull request #1633 from @ddyer0 – fix a fencepost error in flowlayout
  • Merge pull request #1633 from @ddyer0 – when readFromStream or writeToStream throw an IOError, mark the stream as no longer connected.
  • Merge pull request #1633 from @ddyer0 – Added event type information to ActionEvent
  • Removed vestigal keyboard support sections as they can’t effectively be used anyways. Keyboard changes
    ended up being too far reaching for this simple flag to be sufficient for reverting to old handling.
    The new handling appears to be working for all use-cases anyways.
  • Added 2D transform support for mutable images on iOS. This effectively fixes issues with being able to share
    charts that are generated as images #1629
  • Added new UITimer constructor for further simplicity
  • Replaced array.length calls inside for loops with local ‘length’ variables
  • Fixed issue with transforms on mutable images in JavaSE port that would cause Graphics.getTransform() to
    always return the identity transform
  • Added support for drawing shapes on mutable images in iOS #1629
  • Fixed async editing support on Android when TextureView is used.
  • Added addComponentToSideMenu() to Toolbar this will allow devs to customize the sidePanel even for permanent side
  • Added ability to center the title in the Toolbar Added ability to center the title in the Toolbar
  • Fixed cancelLocalNotification to only delete the notification whose deletion was requested
  • Fixed regression in left aligned labels
  • Fixed remove command from title
  • Added ScaleImageLabel to simplify the process of adding a label that will scale correctly
  • Added AssignableExpression to ParparVM implementation. This will allow the translator to work with
    instructions in a more generic way when determining if an instruction can be reduced to a single expression
    that can be assigned to a variable or passed as a parameter
  • Changed ParparVM primitive local variables to use C locals instead of storing them in the stack.
    This should bring performance improvements on two fronts: 1. STORE operations now map to a single assignment
    instead of two, since we don’t have to assign the variable type. 2. LLVM should be able to perform better
    optimization surrounding C locals.
  • Fix for launching the android sms activity
  • Pull request from @ddyer0 Fix for two problems with Sockets; data corruption and infinite error loop when input socket is closed.
  • Fix for #1623 tickering should cycle
  • Refactored ParparVM’s custom Invoke and Jump optimizations into separate Instruction classes so that there
    is no confusion on how the Jump and Invoke instructions interact with the stack.
  • Added getStackOutputTypes() and getStackInputTypes() methods to Instruction in ParparVM so that optimizers
    can inspect instructions to see how they affect the stack. This will eventually allow for better reduction of instructions during the optimization phases.
  • Improved CustomInvoke optimizations in ParparVM to cover many more cases that were missed
    before. This should further reduce redundant stack operations surrounding qualifying method invocations.
  • Added small optimization for binary integer arithmetic ops in ParparVM to directly assign result to local variable
    instead of first pushing it to the stack, then popping it to a local
  • Improved the performance monitor to show UIID’s
  • Fix for some edge cases of component animation:
  • Fixed issue with android async keyboard still showing on form change
  • Added the missing overflow icon
  • Fixed the decay motion to stop if last 4 returned animation values are the same
  • Fixed potential exception in animation layout transition that might collide with a remove operation
  • Deprecated the com.codename1.codescan package. Going forward developers are encouraged to use the
    cn1-codescan cn1lib instead.
  • New ability to force popup dialog in a specific direction
  • Flipped the default for “ends with 3 points” to be false as this slows down performance slightly
  • Fixed special case that caused scroll to 0,0 when first field of form requests focus whether or not it is already visible.
    This improves usability of the MaterialLogin demo.
  • Fixed problem with rendering FontImage, IndexedImage & RGBImage
  • Caching derived font instances which can significantly boost performance by allowing the native side of the
    fence to cache additional data on the font object
  • Fixed issue with async editing changes causing text field to close and reopen sometimes when switching to a
    different field
  • Fixed masked icons to render correctly in the new pipeline
  • Fixed the android get contacts to ignore case upon returning contacts
  • Added a picture to some of the Simulator contacts
  • Implemented component drawing for labels and buttons in the native async layer
  • Native implementation of label and background drawing to squeeze every ounce of performance
  • Major refactoring of the UI with the goal of improving on device performance for iOS/Android by moving
    frequently used code into the IMPL layer and allowing us to optimize it
  • Added support for Android async editing
  • Improved efficiency of Container.contains() for containers with many children
  • Adjusted the decay scroll parameters based on comparisons with native iOS app scrolling
  • Added additional checks for peer components before firing the onParentPositionChange event.
    This dramatically improves smoothness of drag scrolling
  • Performance optimization for scrolling a large set of elements when we have no peers
  • Changed default scroll motion to use exponential decay instead of friction to simulate more closely native behavior.
    You can revert to the previous friction style of scrolling by setting the theme constant ‘ScrollMotion’ to ‘FRICTION’.
    You can tune the decay parameter ‘DecayMotionScaleFactorInt’ to adjust how sensitive the scrolling is.
  • Removed excessive pointer events from event dispatch to prevent slowness during dragging
  • Optimization for stringWidth that should avoid calls to that relatively slow API by caching the value within labels
  • Added a binary search for the ‘viewable’ children of a container that can be used to make it easier to only paint
    visible children for large containers
  • Removed redundant opengl calls to try to make painting more efficient
  • Fixed contact getDisplayName() to never return null
  • Removed a rectangle allocation that caused a GC in the EDT paint cycle. This fixes some jitter that occurs
    while scrolling
  • Fixed the animation manager scrolling behavior so it won’t misbehave when pulling from the top
  • Made style animation work as expected for multiple elaborate cases
  • Improved add/remove component to act as if the component was already added/removed and avoid some exceptions
    in cases that would be serialized
  • Added ability to detect an empty border
  • Fixed regression with ComponentGroup due to changing method signature
  • Better error handling in the JavaSEPort
  • New title animations and style animations API’s
  • Additional improvements for side menu bar preventing potential issue
    with animations
  • Fix for potential exception if an animation is running while changing the Toolbar
  • Fixed the animations and add/remove operations so they won’t collide. If an animation is in progress add/remove
    will get queued until after the animation is performed
  • New animation framework that accepts all animation requests globally and processes them
  • New methods for Integer & Character classes
  • Added getTitleComponent to the Toolbar
  • Fixed regression in ios keyboard that caused it to not respect the ios.keyboardOpen build hint.
    Now it gives multiple levels of control over whether a field uses async editing or legacy editing
  • Fixed getPrimaryPhoneNumber to return a number if a number exists
  • Fixed issue with background location monitoring on iOS 9
  • Fixed textarea resizing to work properly on iOS 7 and below
  • Fixed edge case of text area being edited in legacy mode when part of the text area is covered by the keyboard.
    Now the native editing component is sized to only occupy the space above the keyboard so that scrolling
    happens more smoothly as typing, and the textview will auto scroll as the cursor moves in and out of view
  • Fix so that legacy keyboard doesn’t push the selected text area up any higher than the top of the text area
  • Fixed issue with keyboard upside down multiplier on iOS 7
  • Changes to keyboard on iOS to deal with quirks on iOS 5. Also modified some of the orientation detection
    handling that didn’t seem to be working correctly on iOS 5.x
  • Added ability to have more than one layered pane
  • Workaround for regression in checkbox/combobox that broke their theme styles on the unselected state due to
    loading of theme beforehand
  • Added support for tuning the speed of the infinite progress
  • Fixed ConnectionRequest issue with setReadResponseForErrors is true
  • Added a static factory method to UITimer
  • Made building Codename One easier for 3rd parties with some build.xml teaks
  • Added ability to disable the automatic tab UIID switching
  • Fixed NPE in validator interaction dialog on scroll change
  • Fixed deadlock when toggling between fields in legacy mode on iOS. Behaviour was seen only on iOS 7
  • Fixed issue with iOS isTextEditing not correctly reporting because it deferred to the superclass isTextEditing
    methods. This resulted, occasionally, in text fields not being rendered properly when in async edit mode
  • Fixed issue with keyboard opening, then closing, then opening again the first time a field is edited with async
  • Fixed new fonts to respect italic/bold setting on Android
  • Fixed text field editing with form bottom padding fields
  • Added the onShowComplete callback when a show() is called on a Form which is the current Form
  • Fixes in ParparVM encoding for cases where UTF characters might reside on the edge between bytes
    Fix for encoding issues triggered by partial reading of the bytes
  • Reworked text input to reduce the cyclomatic complexity. Working well on iOS 9 with async, legacy, and form
    bottom padding test cases on iPhone 4S
  • Added return statement to prevent calling editString twice simultaneously
  • Added DeviceName property and added implementation to the stopTextEditing method
  • Added optimization to reduce ParparVM stack operations involved in invoking methods that take only
    constants and local variables as parameters
  • Added explicit hook in keyboardWillShow to hide the picker, if it is showing
  • Added textposition support to title command
  • Added ability to make rows in the MultiButton stick together
  • Optimized stack operations in ParparVM surrounding binary integer operations
  • Added some optimizations to reduce stack operations surrounding some integer comparisons in ParparVM
  • Fixed issues with scrolling fields into view on iOS when using 3rd party keyboard
  • Fairly major changes to text editing on iOS to fix some bugs that appeared when using the SwiftKey keyboard
    Since swiftkey will call the keyboardShown event multiple times while it is showing, with different keyboard
    sizes reported, we needed to handle these events more incrementally
  • Fixed issue with not scrolling to focused text field on iOS when VKBAlwaysOpen is set to YES
  • Added support for opacity in resource files
  • Added support for opacity in FontImage
  • Added simpler methods to edit/stop editing and track editing state for a text component
  • Added a builtin ability to launch the text area editing when a form is shown which simplifies some common
    boilerplate code that is often implemented incorrectly
  • Added a builtin ability to launch the text area editing when a form is shown which simplifies some common
    boilerplate code that is often implemented incorrectly
  • Implemented RFE #1510 “simplifying error message handling”
  • Added north, south, east and west methods to match the center method in the BorderLayout
  • Made the parent scrollable public, this is important for some generic code that resides outside the package
    specifically the validation manager
  • FloatingHint a new type of textfield/label wrapper that allows the hint to migrate to a label on top
  • Fixed multiple issues in the popup positioning and arrow functionality
  • Minor configuration fine tuneing for the progress indicator
  • Fix for uncover transition
  • Made iOS simulators use Helvetica Neue on Macs
  • Added constructSideNavigationComponent to Toolbar to allow overriding the panel
  • Fix for issue with native font loading using the new native: syntax
  • Added missing theme constants for checkboxes Added missing theme constants for checkboxes
  • Fix for RFE #1609 added support for the assert keyword
  • Updated the size of the InfiniteProgress and made it spin faster
  • Fixed pull to refresh to show the infinite progress
  • Fixed issue with local sending a local notification causing push to be registered
  • Moved createBackgroundMedia to the CodenameOneImplementation
  • Removed some iOS 6 dependencies for compatibility with older versions
  • New support for material design icon fonts
  • Added background media playback to android and JavaSE port
  • Fixed issue with network thread getting deadlocked in some cases when a setDisposeOnCompletion is set
  • Fixed issue with infinite progress dialog not showing up if an existing progress dialog is opened
  • Fixed issue with multiple concurrent infinite progress dialogs interfering with each other
  • Fixed getAllContacts(…) to return the contacts sorted by name
  • Support for the new hello world project look Support for the new hello world project look
  • Fixed the fonts in the top 2 themes
  • Fixed issue with iOS apps still being in ‘minimized’ state during the start() method
  • Fixed issue with string picker showing up underneath keyboard on iOS. Now keyboard will auto fold when string
    picker is shown
  • Merge pull request #1608 from @Pmovil Fixed multipart utf8 string (fails on android)
  • Added support for onCompletionCallback for video components in iOS. Related to #1595
  • Some improvements to the default demo in the designer
  • Added isNativeFont supported and new flow layout terse factory methods
  • Added ability to detect running on simulator which is useful for crash reporting
  • Simplified code that allows binding standard boilerplate crash reporting logic
  • Shorthand terse syntax for layered layout
  • Fixed regression with testflight builds
  • Added support for native OS fonts that are builtin to iOS/Android with multiple weights.
    This is mapped to the simulator on Windows/Linux as Roboto due to copyright issues with Helvetica.
  • Fixed for exception in table layout
  • Fixed issue that caused a revalidate to occur off the EDT in iOS when the keyboard is about to be shown.
    This may fix numerous issues. But, at least seems to fix an NPE from #1601
  • Fixed issue where the first contact is always blank on iOS. Changed contacts to come out sorted by default #1598
  • Changed Contact.getDisplayName() to return an alternate value like the phone, email, name if the contact has no display name #1598
  • Fixed iOS port not respecting setChunkedStreamingMode. iOS8 had been using chunked streaming by default
    for multipart requests. Now it will only use chunked streaming when setChunkedStreamingMode() is called
    with a non-negative integer argument
  • Fixed regression in Javascript bridge that broke execution on Android
  • Fix for #1602 – Menu missing with Android 6 Marshmallow
  • Added ability to hide/show components without removing them (setHidden)
  • Fixed data dir location to .cn1 inside the project directory. This directory is used by the simulator for localStorage
  • Added async methods to JavascriptContext for better performance when synchronous calls are not needed.
    Also fixed Javascript bridge callbacks in simulator
  • Added improved debugging in the Simulator’s BrowserComponent
  • Fixed iOS local notifications. Turned out they had been commented out by a merge right after they were implemented
  • Added some error logging when mkdir() fails
  • Fixed simulator BrowserComponent support for localStorage
  • Fixed bug in extracting html hierarchies
  • Fixed issue with some fonts being cut off at the bottom in iOS
  • Fixed stream closed error in video component on iOS #1595
  • Removed unnecessary retain in creating video component that could cause memory leak
  • Added terse API to download/parse JSON synchronously useful for webservices
  • Added tearse add() methods to container that accept images to make the process of adding even simpler
  • Created shorter default creation method to URLImage
  • Added factory methods based on encloseWith to BorderLayout and BoxLayout to simplify/shorten the resulting code
  • Added ability to construct a form with a layout manager
  • Slider is now recognized by the generic list cell renderer and can be used in a renderer component
  • Workaround for EDT performance issues while dragging
  • Added the ability to extend the Toolbar and modify the side panel
  • Added support for background location services and geo fencing on iOS
  • Added support for Properties file format
  • Exposed a public constructor for Label which accepts the text and a UIID, this makes terse code simpler
  • Made table layout constraint construction more terse for easier layout of tables
  • Added geofence and background location tracking