Release Notes.txt

= RubyMotion 9.10 (Dec 2025) =
  * [Xcode] Added support for Xcode 16.2.


= RubyMotion 9.9 =
  * [Xcode] Fixed issue with launching simulator in Xcode 16.1.


= RubyMotion 9.8 =
  * [Xcode] Added support for Xcode 16.1.


= RubyMotion 9.7 =
  * [Xcode] Added support for Xcode 16.0 GM.


= RubyMotion 9.6 (Sep 2024) =
  * [Xcode] Added support for Xcode 16.0 RC.
  * [Xcode] Added support for Xcode 16.1 Beta.
  * [Android] Dropped support for SDK version less than 26.
  * [Android] NDK target updated to v26.3.11579264 and SDK Target 34.

   IMPORTANT:
   For updated Android toolchains, run:
   ```sh
   motion repo
   motion android-setup
   ```

   In your Rakefile, you'll need to update the following.
   ```ruby
   # recommended minimum target to have largest compatability
   app.api_version = '26'
   # required api target for distribution on GooglePlay
   app.target_api_version = '34'
   ```
   
   
= RubyMotion 9.5 =
  * [Xcode] Added support for Xcode 16.0 Beta.


= RubyMotion 9.4 (May 2024) =
  * [Xcode] Added support for Xcode 15.3.


= RubyMotion 9.3 =
  * [Xcode] Added support for Xcode 15.3.


= RubyMotion 9.2 =
  * [Xcode] Added support for Xcode 15.0.1, 15.1, 15.2.


= RubyMotion 9.1 =
  * [Xcode] Added support for Xcode 15.0 and 15.1 beta.

  IMPORTANT:
  There is a known issue in Xcode 15.0 and 15.1 with the linker. Run `motion repo` to
  get latest updates to compilation machinery.

  If you were having issues with BridgeSupport functions not being precompiled, recompile
  these apps with Xcode 15+ and the issue should be resolved.

  See the following link for more info:
  https://developer.apple.com/documentation/xcode-release-notes/xcode-15-release-notes#Linking

  IMPORTANT:
  Apple has completely changed the Xcode 15.0 simulator and device connectivity
  infrastructure (including Sonoma). We have a dependency on libimobiledevice and the
  contributors are working on implementating this new communcation protocol.

  We are tracking updates to this GH Issue here (and attempting to contribute updates where we can): https://github.com/libimobiledevice/libimobiledevice/issues/1490

  What this means:

  - Apps can be installed onto the device using Xcode 15, but the repl will fail to boot (on both the device and simulator).
  - Apps targeting iOS 17.0 and MacOS 14.0 can be distributed to production, dev builds to device will install to device, but repl will not connect.
  - Repl will connect on the Simulator using Xcode 14.3.1, but standard-in will not be accepted on Sonoma (though console out will be shown).


= RubyMotion 9.0 (Sep 2023) =
  * [iOS] Apps that leverage the MessagesUI framework have a collision with the Complex
    numeric type in RubyMotion. This type has been removed so as not to clash with
    iOS 17. If you're app uses MessagesUI, release a production build to avoid crashes
    when iOS 17 release.
  * [iOS] iOS SDK Versions less than 12.4 have been removed (less than 1% of device use
    versions under 12.4).
  * [Pending] Fixes for the interaction with Xcode 15.0's repl and developer devices is still
    in the works. Please use Xcode 14.3.1 for now.


= RubyMotion 8.18 =
  * [Xcode] Added support for Xcode 15 beta 5.
  * [BridgeSupport] Updated BridgeSupport binary to be universal.


= RubyMotion 8.17 =
  * [MacOS] Re-enabled Universal Binaries.


= RubyMotion 8.16 =
  * [Repl] Arm64 support added to repl.
  * [Repl] Fixed issues with detecting deviced connected via USB.


= RubyMotion 8.15 =
  * [BridgeSupport] Arm64 support added to BridgeSupport.
  * [Repl] Dependency on libimobiledevice upgraded to latest version.


= RubyMotion 8.14 =
  * [Repl] Repl dependencies no longer rely on what's installed via brew.


= RubyMotion 8.13 =
  * [Xcode] Added support for Xcode 14.3.1
  * [Starter] Bug fix for Starter License default SDK


= RubyMotion 8.12 =
  * [Xcode] Added support for Xcode 14.3.
  * [MacOS] Added support for MacOS 13.3.
  * [iOS] Added support for iOS 16.4.


= RubyMotion 8.9 =
  * [Xcode] Added support for Xcode 14.2.
  * [MacOS] Added support for MacOS 13.1.
  * [iOS] Added support for iOS 16.2.


= RubyMotion 8.8 =
  * [MacOS] Added support for MacOS 13.0.
  * [Android] Added support for Android APIs 31 through 33.
    IMPORTANT:
    For the new Android toolchains, you will need to run `motion repo`
    and `motion android-setup`.

    IMPORTANT:
    The adoption percentages for API 33 are likely to be low, when
    releasing to the play store be sure to set your `app.api_version=`
    to an API version that has wider adoption (the recommended value
    is `app.api_version = '26'`).


= RubyMotion 8.7 =
  * [Xcode] Added support for Xcode 14.1 Beta 3 and iOS 16.1.


= RubyMotion 8.6 =
  * [Xcode] Added support for Xcode 14.0.


= RubyMotion 8.5 =
  * [Xcode] Added support for Xcode 14.0 Release Candiate.


= RubyMotion 8.4 (May 2022) =
  * [Xcode] Added support for Xcode 13.4.


= RubyMotion 8.3 (Apr 2022) =
  * [MacOS] Added support for MacOS 12.3.
  * [MacOS] Added support for Universal Binaries.
    IMPORTANT:
    With the addition of universal binaries, the built-in MacOS template
    has been deprecated and a new template has been extracted to the public repo.

    Be sure to run `motion repo` so that latest templates are pulled down.

    - If you only want to compile for x86 you can add the following line to
      your Rakefile with:
      ```
      app.archs["MacOSX"] = ["x86_64"]
      ```

    - If you have an existing MacOS app, after running `motion repo`, you
      can incorporate the new template into your existing Rakefile
      by changing the top few lines:
      ```ruby
      # -*- coding: utf-8 -*-
      $:.unshift("/Library/RubyMotion/lib")
      $:.unshift("~/.rubymotion/rubymotion-templates") # this line is new line
      require 'motion/project/template/osx'
      ```


= RubyMotion 8.2 =
  * [Xcode] Added support for Xcode 13.3.
  * [Android] Legacy SDKs available to compile against.
    You must still compile against api 30, but can provided a lower api version
    for backwards compatibility.

    To install legacy android sdks run `motion android-setup-legacy`.

    Here is an example of what you're Rakefile would look like:
    Motion::Project::App.setup do |app|
      app.api_version = '21' # minSdkTarget
      app.target_api_version = '30' # compilation target
    end
  * [MacOS] RubyMotion kernel has been created for both x86 and arm64: kernel-arm64.bc, kernel-x86_64.bc (updates to MacOS rake tasks pending).


= RubyMotion 8.1 =
  * [Xcode] Added support for Xcode 13.2.1.
  * [Bugfix] Repl for iOS simulator fixed.


= RubyMotion 8.0 (Dec 2021) =
  * [LLVM] RubyMotion compiler upgraded to LLVM Version 10.0. This is a big upgrade to the
    compiler. Please let us know if you hit any issues.
  * [Android] Added support for Android API 30. As of November 2021 Google has deprecated all SDK
    versions below SDK 30. Run `motion android-setup` to install the new toolchain.
  * [Android] Project templates for Android API 30 updated. Run `motion repo` to get new templates.
  * [Xcode] Added support for Xcode 13.1.
  * [Known Issues] [Android] Automated construction of Android Application Bundle is pending. See
    https://developer.android.com/studio/build/building-cmdline#build_bundle for help in manually creating
    an app bundle.


= RubyMotion 7.22 (Oct 2021) =
  * [Xcode] Added support for Xcode 13.0.
  * [Known Issues] Repl + Device running iOS 15.0 works for valid ruby commands (we are still working
    through crashes related to invalid Ruby/exceptions). Repl issues still exist for running with the
    simulator, but the incremental fix for device centric repl is worth releasing.


= RubyMotion 7.21 =
  * [Xcode Beta] Added support for Xcode 13.0 Beta 5 (this is for Indie and Pro Licenses Only).


= RubyMotion 7.20 =
  * [Xcode] Backtrace now also considers the case when `DW_AT_ranges`
    is present instead of DW_AT_hipc. For more information about the
    DWARF Standard, see: http://dwarfstd.org/


= RubyMotion 7.19 =
  * [Xcode] Fixed backtrace issue related to Xcode 12.0+. Issue is related to
    Xcode 12.0 adding debug information partitioned by DWARF compilation units that
    overlap the same address space. These overlapping address spaces are now taken
    into consideration for determining the correct location of an exception.


= RubyMotion 7.18 (Apr 2021) =
  * [Xcode] Added support for Xcode 12.5.


= RubyMotion 7.17 =
  * [Bugfix] [OSX] Fixes added for deployment target 11.+.
  * [OSS] Be sure to run `motion repo` for fixes related to `OBJC_DISABLE_INITIALIZE_FORK_SAFETY`.
  * [Bugfix] Fixes added for `rake debug=1`.


= RubyMotion 7.16 (Feb 2021) =
  * [Important] [Bugfix] Bugfix for generating 64-bit BridgeSupport files on Big Sur.
  * [Bugfix] MacOS 10.14 SDK target fixed.
  * [Xcode] Added support for Xcode 12.4.


= RubyMotion 7.15 (Jan 2021) =
  * [Big Sur] Supported added for MacOS 11.0.
  * [Xcode] Added support for Xcode 12.3.
  * [rubymotion-template] Added updates so that Swift Runtime libraries are no longer required to run the repl.
  * [Important] [Prerequisites] Please be sure to do the following after updating to 7.15:
    1. Install Xcode 12.3 if you are able. Be sure to launch Xcode at least once and accept any EULAs
       and install "Additional Components".
    2. Be sure Xcode Commandline Tools are installed and set to the default location:
       ```
       sudo xcode-select --install
       sudo xcode-select --reset
       ```
    3. Update the RubyMotion community templates:
       ```
       motion repo
       ```
    4. Be sure you are running the latest version of the `cocoapods` gem:
       ```
       gem install cocoapods # if needed
       bundle update cocoapods
       pod repo update
       ```
    5. Be sure to do a full clean of your project:
       ```
       rake clean:all
       rake pod:install # if you leverage cocoapods
       rake default
       ```
    6. Come to the [RubyMotion Slack Channel](http://slack.rubymotion.com) if you hit any snags. Happy new years everyone!


= RubyMotion 7.14 (Dec 2020) =
  * Compiler updates in preparation for Apple Silicon and Big Sur.
  * [Xcode] Added Support for Xcode 12.2.
  * [Xcode] Added Support for Xcode 12.1.1.
  * [Xcode Beta] Added Support for Xcode 12.3 Beta 3.


= RubyMotion 7.13 =
  * [Xcode] Added support for Xcode 12.1.1 Release Candidate.
  * [Xcode] Added support for Xcode 12.2 Release Candiate.


= RubyMotion 7.12 =
  * [Xcode] Added support for Xcode 12.1 GM (Which includes simulators for new devices).
  * [Xcode] Added support for Xcode 12.2 Beta 3.


= RubyMotion 7.11 (Sep 2020) =
  * [Xcode] Added support for Xcode 12.2 Beta.


= RubyMotion 7.10 =
  * [Xcode] Added support for Xcode 12.0 GM.
  * [BridgeSupport] BridgeSupport files for MacOS 11.0 generated based off of Xcode 12.0 GM.


= RubyMotion 7.9 =
  * [Bugfix] Fixed BridgeSupport files for Xcode 11.7. You can see the new metadata in
    /Library/RubyMotion/data/.


= RubyMotion 7.8 =
  * [Xcode Beta] Added support for Xcode 12.0 (Beta 6) running on macOS Catalina. This is only
    for Indie and Pro subscriptions.

  * [Xcode] Added support for Xcode 11.7.

  * [Bugfix] OSX `Support/Error.h` compilation exceptions resolved when not providing a deployment_target.

  * NOTE: Change log for 7.6 updated with more information about using `Pointer`.


= RubyMotion 7.7 =
  * [Xcode Beta] Added support for Xcode 12.0 (Beta 5) running on macOS Catalina. This is only
    for Indie and Pro subscriptions.

  * NOTE: Change log for 7.6 updated with more information about using `Pointer`.


= RubyMotion 7.6 =
  * [Xcode] Added support for Xcode 11.6.

  * [Bugfix] `Pointer.new` top level retain behavior has been reverted. If you were having crashes
    in RM 7.5, this should resolve that issue. The retain logic for Pointer has instead
    been scoped down to the access of the value. If you want the Pointer to auto release, instead of:

    ```
    @pointer = Pointer.new(:object)
    someObjectiveCFunction(@pointer)

    .... later in code ....

    puts @pointer.value
    ```
    You will need to do:

    ```
    pointer = Pointer.new(:object)
    someObjectiveCFunction(pointer)
    @pointer_value = pointer.value_with_autorelease

    .... later in code ....

    puts @pointer_value
    ```

    If the value within the Pointer is an array. Instead of:
    ```
    @pointer = Pointer.new(:object)
    someObjectiveCFunction(@pointer)

    .... later in code ....

    puts @pointer[0] # alias is @pointer.value_at(0)
    puts @pointer[1] # alias is @pointer.value_at(1)
    ```

    You will need to do

    ```

    If the value within the Pointer is an array. Instead of:
    ```
    pointer = Pointer.new(:object)
    someObjectiveCFunction(@pointer)
    @pointer_item_1 = pointer.value_at_with_autorelease(0)
    @pointer_item_2 = pointer.value_at_with_autorelease(1)

    .... later in code ....

    puts @pointer_item_1
    puts @pointer_item_2
    ```

    Here is a complete example of the two ways you can write this:

    ```
    # Pointer is ivar/retained and pointer's content is accessed via `.value`
    class AppDelegate
      def application(application, didFinishLaunchingWithOptions:launchOptions)
        rootViewController = UIViewController.alloc.init
        rootViewController.title = 'pointersinrubymotion'
        rootViewController.view.backgroundColor = UIColor.whiteColor
        navigationController = UINavigationController.alloc.initWithRootViewController(rootViewController)
        @window = UIWindow.alloc.initWithFrame(UIScreen.mainScreen.bounds)
        @window.rootViewController = navigationController
        @window.makeKeyAndVisible
        @error_ptr = Pointer.new(:object)
        data = NSData.alloc.init
        unless data.writeToFile("~/file-does-not-exist", options: 0, error: @error_ptr)
          error = @error_ptr.value
          puts "#{error.localizedDescription}"
        end
        true
      end
    end
    ```

   ```
   # Pointer is not an ivar and pointer's content is accessed via `.value_with_autorelease` (and is an ivar)
   class AppDelegate
     def application(application, didFinishLaunchingWithOptions:launchOptions)
       rootViewController = UIViewController.alloc.init
       rootViewController.title = 'pointersinrubymotion'
       rootViewController.view.backgroundColor = UIColor.whiteColor
       navigationController = UINavigationController.alloc.initWithRootViewController(rootViewController)
       @window = UIWindow.alloc.initWithFrame(UIScreen.mainScreen.bounds)
       @window.rootViewController = navigationController
       @window.makeKeyAndVisible
       error_ptr = Pointer.new(:object)
       data = NSData.alloc.init
       unless data.writeToFile("~/file-does-not-exist", options: 0, error: error_ptr)
         @error = error_ptr.value_with_autorelease
         puts "#{@error.localizedDescription}"
       end
       true
     end
   end
   ```

  * [Xcode Beta] Added support for Xcode 12.0 running on macOS Catalina. This is only
    for Indie and Pro subscriptions. Big Sur plus Apple Silicon support will be released
    at a future date. Come to the Slack channel for updates: http://slack.rubymotion.com.


= RubyMotion 7.5 =
  * [Bugfix] `Pointer.new` was leaking a small amount of memory with every instance
    creation and is noticeable after a few thousand constructions. This has been resolved.
    With this change, you cannot hold onto a `Pointer` type within an iVar. Instead of
    ```
    @pointer = Pointer.new(:object)
    someObjectiveCFunction(@pointer)

    .... later in code ....

    puts @pointer.value # will now throw an exception
    ```
    You will need to do

    ```
    pointer = Pointer.new(:obeject)
    someObjectiveCFunction(pointer)
    @pointer_value = pointer.value # only hold onto the value from the pointer

    .... later in code ....

    puts @pointer_value # will now throw an exception
    ```

    The minimum reproduction of this memory leak was provided by Ben Govero:
    https://github.com/ben5516/objc-pointer-crash

  * [Xcode] Added support for Xcode 11.5.


= RubyMotion 7.4 =
  * [Bugfix] Added missing BridgeSupport metadata files for iOS 11.4.


= RubyMotion 7.3 =
  * [Xcode] Added Support for Xcode 11.4.
  * [Known Isssues] We are working on creating a cross platform repl. As
    a work around for NSLog, open Xcode->Windows->Device And Simuators. From
    there, you can open the console for your device and see NSLog statements.
  * [News] New DragonRuby website should launch by the end of April.


= RubyMotion 7.2 =
  * [Xcode] Added Support for Xcode 11.3.1.


= RubyMotion 7.1 =
  * [MacOSX] [Bugfix] Fix BridgeSupport files associated with MacOSX 10.13.
  * [Known Issues] Repl does not relay NSLog statements. This is currently
    being worked on and a fix will release soon.
  * [command] Forced `motion doctor` verification now respects the RM_BYPASS_DOCTOR
    environment variable.
  * [command] Having multiple SDKs in your SDK directory is now treated as a warning
    as opposed to a `motion doctor` exception/error.
  * [Catalina] If you want to give ZSH a try, consider using OhMyZsh. It was
    straightforward to install and the theme options that are provided out of the box have
    really nice PS1 formatting/git status information.


= RubyMotion 7.0 (Dec 2019) =
  * [MacOSX] Added Support for MacOS Catalina.
  * [Bugfix] Repl has been fixed and can now connect to iOS 13 devices.
    We are still working on a fix for repl interaction with devices that
    cannot install iOS 13 (any device released before the iPhone 6S). To use
    the repl you must use an iPhone 6S or higher. Older devices will
    still be able to install a developer build, however the repl will fail to run.
  * [SemVer] 32 bit support has been dropped (Catalina no longer supports
    32-bit applications).
  * [command] Motion `doctor` has been improved.
  * [Known Issues] Catalina requires OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
    to use the RubyMotion compiler. We are updating the compiler's thread usage
    to get rid of this environment variable. For now you will need to add the
    following line to your ~/.profile:

    ```
    export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
    ```
  * [Catalina] Upgrading your local machine to catalina should be relatively painless.
    Here are the steps Amir always follows when doing an OS upgrade:

    1. Install the latest Xcode (in this case install Xcode 11.2.1).
       You should *not* install Xcode from the AppStore, and instead
       download it from http://developer.apple.com/downloads. This
       ensures that Xcode isn't automatically updated without your
       knowledge. Be sure to open Xcode and accept the EULA.
    2. Re-install Command Line Tools:

       ```
       sudo rm -rf /Library/Developer/CommandLineTools
       sudo xcode-select --install
       sudo xcode-select --reset
       ```
    3. Take note of all brew packages installed, and then *completely*
       uninstall *all* of them. Then reinstall. This ensures that all
       your packages are compiled against the latest toolchain and OS.
       While this may seem excessive, it guarantees system consistency.
    4. Remove any cached RubyMotion builds using
         `rm -rf ~/Library/RubyMotion/build`
       and be sure to run
         `rake clean:all`
       in your RubyMotion projects directories.
    5. Catalina's default shell is zsh which may not be 100% compatible
       with what you have in your .bash_profile and .bashrc. Here's some
       guidance to help you transition to zsh. If you do not want to
       upgrade your shell. You can skip these recommendations if you
       do not want to use the new shell.

       1. Move all environment variables to ~/.profile and remove
          them from ~/.bashrc and ~/.bash_profile.
       2. Keep existing aliases in ~/.bashrc.
       3. Remove any PS1 customizations you have as they probably won't
          work in zsh.
       4. Create a ~/.zshrc file and bootstrap it with ~/.profile and
          ~/.bashrc:

          ```
          [[ -e ~/.profile ]] && emulate sh -c 'source ~/.bashrc'
          ```

       5. Update ~/.bashrc and ~/.bash_profile to also source
          ~/.profile, here is a sample:

          ```
          source ~/.profile # <-- add this line

          # Rest of your bash profile customizations
          # (just an example)
          alias sleepc="osascript -e 'tell application \"Finder\" to sleep'"
          alias vim="emacs"
          ```

       6. For case insensitive file completion, add these lines to
          your .zshrc:

          ```
          [[ -e ~/.profile ]] && emulate sh -c 'source ~/.bashrc'
          autoload -Uz compinit
          precmd() { compinit }
          zstyle ':completion:*' matcher-list 'm:{a-z}={A-Za-z}'
          ```

       7. For light weight git integration and a customized PS1:

          ```
          [[ -e ~/.profile ]] && emulate sh -c 'source ~/.bashrc'
          autoload -Uz vcs_info
          autoload -Uz compinit
          precmd() { vcs_info && compinit }
          zStyle ':completion:*' matcher-list 'm:{a-z}={A-Za-z}'
          zstyle ':vcs_info:*' enable git
          zstyle ':vcs_info:git*' formats "(%b)"
          NEWLINE=$'\n'
          PROMPT="┌── [ %~ ${vcs_info_msg_0_}]${NEWLINE}+-> "
          ```


= RubyMotion 6.5 =
  * [Xcode] Added support for Xcode 11.2.
  * [Known Issues] The repl attachment against iOS 13 devices is currently not working. A fix is
    in the works for this. The repl should still attach to the Simulator.
    UPDATE: We've isolated the issue with regards to the REPL on devices. The changelog will have all the details
    with regards to what happened and how it was fixed (for those that are interested in the details).
  * [Important] [News] RubyMotion's ownership expansion has been completed. Amir remains as CEO.
    Aaron continues to operate as CIO. Ryan's title has been changed/better-aligned
    to CGO (Chief Gaming Officer). And most recently, please welcome Alex Denisov, an LLVM specialist
    and our new CTO. A longer news entry will be released after Catalina versions of RM have been finalized.
  * [Important] [News] Things have finally stabilized from Apple's side I feel, so expect to
    upgrade to Catalina within the next few weeks (but not yet). There will be a RubyMotion 6.x release before
    Catalina. And then "immediately" afterwards, a RubyMotion 7.0 release which WILL work with Mojave.
    RM 7.0 will drop all support for 32 bit including dropping support for MacOS Maverick (10.9).


= RubyMotion 6.4 =
  * [Xcode] Added support for Xcode 11.1.
  * [Bugfix] Cycle detection was resulting in unrooted/prematurely GC'ed Ruby objects.
  * [Known Issues] The repl attachment against iOS 13 devices is currently not working. A fix is in the works for this.
    The repl should still attach to the Simulator.


= RubyMotion 6.3 (Sep 2019) =
  * [Android] Updated NDK to r15c allowing us to use LLVM 5.0. Run `motion android-setup` to install the new NDK.
  * [Android] The default Android target has been upgraded to API 28 for both Pro, Indie and Starter License.
  * [Xcode] Added support for Xcode 11.0 and Xcode 11.1 GM.
  * [Known Issues] The repl attachment against iOS 13 devices is currently not working. A fix is in the works for this.
    The repl should still attach to the Simulator.


= RubyMotion 6.2 (Jul 2019) =
  * [Xcode] Support for Xcode 10.3 added.
  * [iOS, tvOS, WatchOS] Retroactively added deprecated 64 bit SDKs given requests from the community
    to bring back the ability to compile legacy apps.
  * [Android] Internal updates to support Android API 28 LLVM compilation. Targeting API 28 is expected to
    be in the next release.
  * [Beta, WatchOS] Internal updates to support Catalina, the new Apple Watch chipsets, and iOS 13.x.
    Expect Xcode 11.0 Beta support to be added to the next release.
  * [LLVM] RubyMotion now targets LLVM 5.0 and we are currently testing LLVM 6.2.
  * [command] `motion doctor` has been added to help troubleshoot environment problems. The shims
    have been staged in RubyMotion, with the heavy lifting done in `doctor.rb` located
    on github/amirrajan/rubymotion-templates. Feel free to contribute.
  * [News] RubyMotion's Community Channel is close to breaking 1,000 members (it has nearly doubled) :-)


= RubyMotion 6.1 =
  * [Android] LLVM Compiler regressions for Android have been patched to fix compilation
    issues up to API version 27. NDK Version r19c, LLVM 5.0, and Android 28 support is coming.
  * [Android] The default Android target has been upgraded to API 27 for both Pro, Indie and Starter License.
  * [Android] If you are on the Pro/Indie License and have an *existing* Android app deployed to Google Play,
    it's strongly recommended that you target API 23 to get the largest Android install base.
  * [Android] If you are on the Pro/Indie License and are working on a *new* Android app,
    it's strongly recommended that you target API 26.


= RubyMotion 6.0 (Apr 2019) =
  * This is a major release of RubyMotion. Please read the change log carefully.
    Come to the Slack channel if you need any help: http://slack.rubymotion.com.
  * [Important] [News] Amir Rajan, owner of RubyMotion has brought on two partners to help in the
    continued expansion of the platform (this is good news). Read more about it at:
    http://www.rubymotion.com/news/2019/03/01/the-sleeping-dragon-has-awoken.html
  * [Important] [News] Lori Olson has started up a fantastic news letter for RubyMotion devs, subscribe here:
    https://rubymotionweekly.com/ and be sure to also visit http://schools.rubymotion.com.
  * [Important] [SemVer] Given then Xcode 10.2 requires Mojave, this RubyMotion release (by extension) also requires MacOS
    Mojave. Here is a guide to help you navigate the options you have available to you.

    =======================================================================
    Recommended - Upgrade to Mojave 10.14.4, Xcode 10.2, and RubyMotion 6.0
    =======================================================================

    Amir Rajan (Steward of RubyMotion and App Developer) has been on Mojave since October of 2018
    and everything is been running smoothly. As stated in the previous RM release, here are the
    things you need to keep in mind when upgrading to Mojave:

    1. The upgrade to Mojave takes about an hour.
    2. Be sure to reinstall Xcode 10.2 from developer.apple.com/downloads.
       *DO NOT INSTALL XCODE FROM THE APP STORE (WHICH AUTO UPDATES).*.
    3. Be sure to open Xcode 10.2 and log into your developer account under Xcode -> Preferences -> Account.
    4. After Xcode 10.2 has been fully initialized, open terminal and run:
       `sudo xcode-select --install && sudo xcode-select --reset`.
    5. On Mojave, MacOS SDK header files do not come preinstalled. You'll need to run the following command to install them:
       `sudo installer -pkg /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg -target /`
    6. After installing Xcode 10.2, the command line tools, and the header files, it is *strongly recommended*
       that you fully uninstall homebrew and reinstall a clean copy. Go to https://docs.brew.sh/FAQ
       for installation instructions.

       You can take note of all the brew packages you have installed using the following command:
       `brew list`

       To uninstall brew:
       `ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)"`

       To reinstall brew:
       `/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"`

       After reinstalling brew, you'll want to reinstall your packages. RubyMotion recommends that you install
       the following packages (so consider doing so):

       ```
       brew install gcc
       brew install cmake
       brew install libxml2
       brew install sqlite
       brew install rbenv
       ```

       And at least following _minium_ Ruby version:

       ```
       rbenv install 2.3.7
       ```
    ======================================================================
    Not Recommended - If you don't want to upgrade to Mojave 10.14.4.
    ======================================================================

    To reiterate, it's strongly recommended that you upgrade to Mojave 10.14.4. Xcode
    10.2 will *not* run on MacOS's below Mojave and requires a seperate download of the
    Swift 5 runtime for Mojave versions below 10.14.4.

    But if you are unable to, and want to stay on a MacOS version below 10.14.4, follow
    the following steps to downgrade RubyMotion 6.0.

    1. Delete Xcode from /Applications.
    2. Install the archived version of Xcode 10.1 from http://developer.apple.com/downloads/more.
    3. Open Xcode 10.1 and log into your developer account under Xcode -> Preferences -> Account.
    4. After Xcode 10.1 has been fully initialized, open terminal and run:
       `sudo xcode-select --install && sudo xcode-select --reset`.
    5. Download the archived version of RubyMotion 5.17: `sudo motion update --cache-version=5.17`

       Open the Rakefile of the apps you want to keep developing, change the top line from:

           $:.unshift("/Library/RubyMotion/lib")

       To:

           $:.unshift("/Library/RubyMotion5.17/lib")

    6. After changing the Rakefile. Perform a full clean, followed by a rebuild: `rake clean:all default`.
    7. If you run into any issues. Come to the Slack Channel: http://slack.rubymotion.com.


= RubyMotion 5.17 (Feb 2019) =
  * [Important] [SemVer] Xcode 10.2 *requires* Mojave. This is the final release of RubyMotion that will support Sierra, and High Sierra.

    If you want to continue using Sierra/High Sierra. Do not upgrade your Mac OS, Xcode (10.1), or RubyMotion (5.17) past this point.
    This is not recommended as Apple is effectively deprecating Xcode support for all OS'es under 10.14.

    It is strongly recommended that you upgrade to Mojave at this time. The next version of RubyMotion will be 6.0 which will work with
    Xcode 10.1, Xcode 10.2 Beta 3, and Mojave.

    Upgrade tips:

    - The upgrade to Mojave takes about an hour.
    - Be sure to reinstall Xcode 10.1 from developer.apple.com/downloads. *DO NOT INSTALL XCODE FROM THE APP STORE (WHICH AUTO UPDATES).*.
    - Be sure to open Xcode 10.1 at least once to accept EULAS.
    - Be sure to reinstall Xcode's command line tools: `sudo xcode-select --install && sudo xcode-select --reset`.
    - Be sure to fully uninstall brew, rbenv, rvm, all rubies and then reinstall.
    - For your system-wide ruby, it's recommended that you use at least 2.3.3 and rbenv to manage your ruby environment.

  * [OSS] [Pending] motion-cocoapods v1.9 currently breaks vendor library compliation. Use v1.8.
  * [WatchOS] [Pending] Watch OS arm32_64 chipset architecture compliation is still in development and is expected to release
    in RubyMotion 6.0 with Xcode 10.2 Beta 3 support.
  * [Important] [News] [DragonRuby] Amir is expanding RubyMotion leadership team and bringing on two other partners. As soon as the entity
    has been officially created a news entry will show up on RubyMotion.com.
  * [Important] [News] [DragonRuby] Amir's talk for Ruby Kaigi 2019 has been accepted: Developing Games for the Nintendo Switch using Ruby.
  * [simd] [ARKit] Native support added for vector C structures defined in simd.
  * [crashlog] [backtrace] [caller] Crashlog no longer truncates.
  * [Mojave] [BridgeSupport] Metadata from framework dependencies regenerated targeting latest MacOS SDKs.
  * [DragonRuby] BridgeSupport is an integral part of RubyMotion. With regards to sustainable open source,
    make sure you take the time to understand BridgeSupport's role in RubyMotion, and how to build it.
    You can find the source code with instructions to build at: https://github.com/amirrajan/rubymotion-bridgesupport

    Follows is a more in-depth explanation of changes in Mojave that impacted BridgeSupport:

    # Sustainable open source and your responsibilities as a Ruby developer.

    This "call to action" is now more important than ever given the current landscape of open source
    and the recent BitCoin mining backdoor that compromised many NPM packages. We cannot rely
    on the few to carry the burden of hard, low-level problems (not for free at least).

    As Ruby devs, we rely heavily on open source software created over twenty years. And
    given this mountain of dependencies, **seasoned Ruby developers have a responsibility to "go down the
    stack" and help with the harder problems**.

    Codename "DragonRuby" is my initiative where I will try to educate those who use RubyMotion
    and provide a path of improvement and growth. We _have to_ bolster the ranks of those that can
    contribute at the same level as the (right now very small) core Ruby team.

    Take the time to read and internalize the following postmortem. Having these skills
    will help you diagnose problems only the few know how to reason through (which is not a good thing).

    # Changes to `dyld` in Mojave.

    In Mojave, Apple introduced a new feature to their global library cache called `dyld`. The new feature
    "closures for dyld cache" was used sparingly in previous versions of the OS, but its usage was
    expanded in Mojave (speculatively to SIP).

    # `dyld`'s usage expansion and the SEGFAULT in BridgeSupport.

    BridgeSupport (an Apple-maintained library that RubyMotion leverages to interop with Objective C)
    began to SEGFAULT on Mojave. After some trial and error, it was found that compiling BridgeSupport
    against Ruby 2.3.7 fixed the issue. The issue was also fixed by disabling System Integrity Protection on Mojave
    machines. Both these options were suboptimal (one would require all devs to install `rbenv` and Ruby 2.3.7,
    the other required disabling an important piece of protection from the OS).

    # Troubleshooting `dyld`

    To being the troubleshooting process, BridgeSupport was recompiled with `dyld` debug flags enabled.

    - `DYLD_LIBRARY_PATH=/System/Library/Frameworks/Ruby.framework/Versions/2.3/usr/lib`
    - `DYLD_PRINT_WARNINGS=y`

    Executing BridgeSupport with these flags yields the following on High Sierra:

    ```
    dyld: found closure 0x7ffff48ae9ac (size=844) in dyld shared cache
    dyld: closure 0x7ffff48ae9ac not used because DYLD_FRAMEWORK_PATH changed
    ```

    The SEGFAULT occurs in `Init_bridgesupportparser` method when attempting to define the foreign function interface using
    `rb_define_method`. On Mojave, the address of this method was corrupted. Using `dladdr` we see:

    Here is what the output looked like on Mojave:

    ```
    dladdr(0xd41682, 0x7feca739d290)
    dladdr() => 1, { "/usr/bin/ruby", 0x100640000, "(null)", 0x0 }
    dladdr(0x1007d71e7, 0x7feca739d2b0)
    dladdr() => 1, { "/opt/rubymotion/RubyMotionBridgeSupport/DSTROOT/System/Library/BridgeSupport/ruby-2.3/bridgesupportparser.bundle",
                     0x1007c9000,
                     "Init_bridgesupportparser",
                     0x1007d71c0 }
    ```

    On Mojave, `dyld` attempts to get the address for this method from `/usr/bin/ruby` (which should reside in `libruby.dylib`), but is
    unable to do so.

    # Stepping through C based foreign function interfaces.

    To debug this issue, the following steps were performed:

    - Make BridgeSupport.
    - Export the following environment variable `export RUBYLIB='./DSROOT/System/BridgeSupport/ruby-2.3'`.
    - Run LLDB (Low Level Debugger) with the following arguments:

      ```
      lldb /usr/bin/ruby -- gen_bridge_metadata -o ./DSROOT/System/Library/BridgeSupport/libSystem.bridgesupport

      ```

    - Once the debugger starts up, add a breakpoint:

      ```
      br set -r Init_bridgesupportparser
      ```

    - Run the program under LLDB: `run`.

    - Once the breakpoint is hit, use LLDB's `si` command to step through each instruction. Eventually, the instruction will reach
      the `rb_define_module` line.

    - Performing an additional step yields the following data:

      ```
      (lldb) disassemble
       bridgesupportparser.bundle`rb_define_module:
       ->  0x1039443dc <+0>: jmpq   *0x1309c6(%rip)  ; (void *)0x0000000000d41682

      (lldb) si
      * thread #1, queue = 'com.apple.main-thread', stop reason = instruction step into
          frame #0: 0x0000000000d41682
      error: memory read failed for 0xd41600
      ```

    # Disabling `dyld` closures for BridgeSupport.

    - Next, BridgeSupport was rebuilt using the following environment variables.

      ```
      export DYLD_PRINT_APIS=y
      export DYLD_PRINT_WARNINGS=y
      export RUBYLIB='./DSTROOT/System/Library/BridgeSupport/ruby-2.3'
      ```

   - And rerun:

     ```
     ruby gen_bridge_metadata.rb -o ./DSTROOT/System/Library/BridgeSupport/libSystem.bridgesupport
     ```

   - You'll see several messages with: "dyld: found closure ... in dyld shared cache". With one of the messages being:

     ```
     dladdr(0xd41682, 0x7f82d37c5bc0)
       dladdr() => 0
     dladdr(0x1071a81e7, 0x7f82d37c5be0)
       dladdr() => 1, { "/opt/rubymotion/RubyMotionBridgeSupport/DSTROOT/System/Library/BridgeSupport/ruby-2.3/bridgesupportparser.bundle",
                        0x10719a000,
                        "Init_bridgesupportparser",
                        0x1071a81c0 }
     ```

   - The symbol resolved by `dladdr` `(0x7f82d37c5bc0)` to 0 is the 'rb_define_module' from the previous section.

   - Next, `dyld` closures were explicitly disabled:

     ```
     export DYLD_PRINT_APIS=y
     export DYLD_PRINT_WARNINGS=y
     export RUBYLIB='./DSTROOT/System/Library/BridgeSupport/ruby-2.3'
     export DYLD_FRAMEWORK_PATH=
     ```

   - Rerunning BridgeSupport:

     ```
     ruby gen_bridge_metadata.rb -o ./DSTROOT/System/Library/BridgeSupport/libSystem.bridgesupport
     ```

     Now yields the following log statements (indicating that closures will not be used):

     ```
     dyld: found closure ... in dyld shared cache
     dyld: closure ... not used because DYLD_FRAMEWORK_PATH changed
     ```

   - This removed the SEGFAULT.

   - Why this removed the SEGFAULT (and why disabling SIP resolves the issue) is unknown. A bug description has been submitted to Apple.

   # Patching BridgeSupport's makefiles given the findings above

   - Given the information above, the following patch was created for BridgeSupport for Mojave.

     ```
     diff --git a/swig/Makefile b/swig/Makefile
     index 51bc9be..47648e2 100644
     --- a/swig/Makefile
     +++ b/swig/Makefile
     @@ -72,7 +72,7 @@ ldflags  = $(RC_CFLAGS) -mmacosx-version-min=10.9 $(shell $(LLVM-CONFIG) --ldfla
      dldflags =
      archflag =
      DLDFLAGS = $(ldflags) $(dldflags) $(archflag)
     -LDSHARED = $(CC) $(RC_CFLAGS) -pipe -bundle -undefined dynamic_lookup
     +LDSHARED = $(CC) $(RC_CFLAGS) -pipe -bundle
      AR = ar
      EXEEXT =

     @@ -105,7 +105,7 @@ extout =
      extout_prefix =
      target_prefix =
      LOCAL_LIBS =
     -LIBS = $(LIBRUBYARG_SHARED)                                -lclangCodeGen -lclangAnalysis -lclangARCMigrate -lclangRewriteFrontend -lclangSema -lclangSerialization -lclangFrontend -lclangEdit -lclangDriver -lclangAST -lclangParse -lclangLex -lclangBasic -lLLVMCore -lLLVMSupport -lLLVMBitWriter -lLLVMBitReader -lLLVMCodeGen -lLLVMAnalysis -lLLVMTarget -lLLVMMC -lLLVMMCParser -lLLVMOption
     +LIBS = $(LIBRUBYARG_SHARED) -lLLVMProfileData -lz -lcurses -lclangCodeGen -lclangAnalysis -lclangARCMigrate -lclangRewriteFrontend -lclangSema -lclangSerialization -lclangFrontend -lclangEdit -lclangDriver -lclangAST -lclangParse -lclangLex -lclangBasic -lLLVMCore -lLLVMSupport -lLLVMBitWriter -lLLVMBitReader -lLLVMCodeGen -lLLVMAnalysis -lLLVMTarget -lLLVMMC -lLLVMMCParser -lLLVMOption
      SRCS = bridgesupportparser.cpp bridgesupportparser_wrap.cpp
      OBJS = bridgesupportparser.o bridgesupportparser_wrap.o
      TARGET = bridgesupportparser
      ```

    - Details as to why the following patch fixes the issue is left to the reader to research.

    # Insight and perspective of open source

    This is what the core Ruby team does on a daily basis. For free. This is what RubyMotion does for you (with a heavily
    discounted cost relative to competitors).

    Those vocal about open source and its long-term viability must start "increasing" the bus factor. I hope the information above
    gives you a window into Matz and company. Please be sure to thank them. And above all, start learning these techniques so the core
    Ruby team doesn't have to carry these heavy burdens alone. We've deferred the cost of free (libre) open source for too long in my opinion.

    Also, if you see an open source project that seems like a good option, but looks "dead". Do _not_ simply look for another option. It
    is your responsibility to bring projects out of _dormancy_ if you feel it's useful to you.

    This is important. The current trend of "take more than you give" must end for the long-term viability of open source. Get your hands
    dirty. I promise. I (and by extension RubyMotion's subscription income) am here to help you reach the next level. Please help spread
    the narrative of "if you find X useful, bring it out of dormancy".


= RubyMotion 5.16 =
  * [Mojave] [BridgeSupport] [segfault] Disabling SIP on Mojave is not longer required. Nor is it
    necessary to pass in DYLD_LIBRARY_PATH.
  * [Starter Edition] Both MacOSX 10.13 and 10.14 are available for free. As Mojave adoption increases,
    10.13 will be removed from the Starter Edition and will require an Indie license if that's a platform
    you'd want to target.


= RubyMotion 5.15 =
  * [Xcode 10.1] Supported added for Xcode 10.1.
  * [Mojave] [BridgeSupport] [segfault] There is a pending bug submitted to Apple with
    regards to BridgeSupport, System Ruby, and changes to Mojave SIP (System Integrity Protection)
    and its treatment of PATH variables.

    Because of this, you MUST disable SIP and pass the following path variable if you are
    currently using RubyMotion on Mojave:

    DYLD_LIBRARY_PATH=/System/Library/Frameworks/Ruby.framework/Versions/2.3/usr/lib rake


= RubyMotion 5.14 =
  * [Starter Edition] Added better help text to the Starter Edition for unsupported sdk versions. Be sure to also
    read the change log for RubyMotion 5.13.


= RubyMotion 5.13 =
  * [Xcode 10 GM] Support for Xcode 10 GM added. If you are using The Starter Edition of RubyMotion, you MUST download Xcode 10 GM from the
    Apple Developer Portal (the AppStore will not have the App). Go to: http://developer.apple.com/download.

  * [Deprecations and Breaking Changes] These are relevant deprecation notices from Apple. Detailed explanations
    have been included within these release notes. BE SURE TO READ THEM. From Apple's Xcode 10 Release Notes:

    >The macOS 10.14 SDK no longer contains support for compiling 32-bit applications. If developers
    >need to compile for i386, Xcode 9.4 or earlier is required. (39858111)

    >Building with libstdc++ was deprecated with Xcode 8 and is not supported in Xcode 10 when
    >targeting iOS. C++ projects must now migrate to libc++ and are recommended to set a deployment
    >target of macOS 10.9 or later, or iOS 7 or later. Besides changing the C++ Standard Library build
    >setting, developers should audit hard-coded linker flags and target dependencies to remove
    >references to libstdc++ (including -lstdc++, -lstdc++.6.0.9, libstdc++.6.0.9.tbd, and
    >libstdc++.6.0.9.dylib). Project dependencies such as static archives that were built against libstdc++
    >will also need to be rebuilt against libc++. (40885260)

    >Libgcc is obsoleted. Xcode 10 can no longer build apps with deployment targets of macOS 10.4 and
    >10.5. (42818150, 38035243)

    Because of the deprecation notices above, the following change has been made to
    /Library/RubyMotion/lib/motion/builder.rb:

    ```ruby
    def build(config, platform, opts)
    [...]
    369:  configuration_libs = config.libs.reject { |c| c =~ /libstdc/ }
    370:
    371:  if configuration_libs.length != config.libs.length
    372:    App.warn "A gem or vendor library referenced stdc++, stdc++.6.0.9,
                      libstdc++.6.0.9.tbd, or libstdc++.6.0.9.dylib. This deprecated
                      link has been removed during the build process. To remove this
                      warning, please audit your library dependency chain and update
                      any harded coded dylib links to stdc++. For more information,
                      refer to Xcode 10's release notes."
    373:  end
    374:
    375:  sh "#{cxx} -o \"#{main_exec}\" #{entitlements} -filelist
              \"#{objs_file.path}\" #{config.ldflags(platform)}
              -L\"#{File.join(datadir, platform)}\" -lrubymotion-static -lobjc
              -licucore #{linker_option} #{framework_search_paths}
              #{frameworks} #{weak_frameworks}
              #{configuration_libs.join(' ')} #{vendor_libs}"
    [...]
    end
    ```

  * [BubbleWrap] iOS 12.0 has moved camera apis to `CoreServices` and view based api to
    `QuartzCore`. When compiling with Xcode 10 (and sdk_framework=12.0), these frameworks
    will be added by default.

  * [Troubleshooting] iOS 12.0 has moved libraries around. If you ever run into runtime exceptions such as:

    ```
    uninitialized constant [...] (NameError)
    ```

    or

    ```
    Objective-C stub for message [...] type `[...]' not precompiled.
    ```

    Do the following:

    ```
    brew install ag
    cd /Library/RubyMotion/data/ios/
    ag -i NameOfConstant -l
    ```

    Note: `brew` is an application installation app that can downloaded from http://brew.sh
          `ag` is an application that will quickly search for a piece of text in a directory.

    You will be given a list of .bridgesupport files. Given this list, add the `basename` of the
    file to your frameworks list. Here is an example:

    Let's say you get the following exception:

    ```
    uninitialized constant BubbleWrap::Device::Camera::KUTTypeMovie (NameError)
    ```

    Do the following:

    ```
    brew install ag # This only needs to be run once.
    cd /Library/RubyMotion/data/ios/12.0
    ag -i KUTTypeMovie -l
    ```

    `ag` will output something like the following:

    ```
    ┌── [ /Library/RubyMotion/data/ios/12.0  ]
    +-> ag -i KUTTypeMovie -l
    BridgeSupport/CoreServices.bridgesupport
    ```

    Given this result, the following line can be added to the Rakefile:

    ```
    Motion::Project::App.setup do |app|
      [...]
      app.frameworks << "CoreServices"
      [...]
    end
    ```

    Here is another example of an error you may encounter:

    ```
    Objective-C stub for message `setBorderColor:' type `v@:^{CGColor=}'
    not precompiled. Make sure you properly link with the framework or library
    that defines this message.
    ```

    Do the following:

    ```
    brew install ag
    cd /Library/RubyMotion/data/ios/12.0
    ag -i setBorderColor -l
    ```

    Which outputs:

    ```
    ┌── [ /Library/RubyMotion/data/ios/12.0  ]
    +-> ag -i setBorderColor -l
    BridgeSupport/SceneKit.bridgesupport
    BridgeSupport/PDFKit.bridgesupport
    BridgeSupport/QuartzCore.bridgesupport
    ```

    Given this list, include the library that makes the most contextual sense for your application.

    ```
    Motion::Project::App.setup do |app|
      [...]
      app.frameworks << "QuartzCore"
      [...]
    end
    ```

  * [RubyMotion 6.0] RubyMotion 6.0 will release after Mojave
    goes GM (Q1 of 2019). Expect RubyMotion 6.0 to have the following
    major changes:

    - Minimum MacOS version for Indie Edition will be High Sierra.
    - Minimum MacOS version for Starter Edition will be Mojave.
    - All 32-bit compilation support accross all Mac runtimes will be removed.
    - Compilation of iOS versions less than 10.0 will be removed.
    - Android compilations of SDKs less than API 26 will be depreced.

  * [DragonRuby] RubyMotion's SUSTAINABLE open source initiatives
    continue. The codename for open sourcing RubyMotion will operate
    under the codename: DragonRuby.

    The name was inspired by LLVM's logo (which is a dragon). More importantly,
    DragonRuby sounds really cool, and I imagine the logo will look awesome as a
    laptop sticker.

    In 2019, expect the RubyMotion REPL to be released under a
    permissive license under the DragonRuby umbrella.

    Long term support of the REPL will still be provided via RubyMotion
    given a paid subscription.


= RubyMotion 5.12 =
  * [Xcode Beta] Fix for cocoapods in Xcode 10. The symlink is no longer needed under
    `/Applications/Xcode.app/Contents/Developer/Toolchains/OSX10.13.xctoolchain`.
    `bin/gen_bridge_metadata` and `/Library/RubyMotion/lib/motion/project/xcode_config.rb` were updated
    to check for the existence of this directory and remove it.


= RubyMotion 5.11 =
  * [Xcode Beta] Xcode 10.0 Beta support added.
  * [motion repo] Better reminders of running `motion repo`.
  * [RubyMotion Starter Edition] Better error messages for unsupported SDKs in the starter edition.
  * [News] Be sure to check out Lori's new RubyMotion courses: https://wndx.school/
  * [News] RubyMotion is a Silver Sponser to Rails Girls Summer of Code.


= RubyMotion 5.10 =
  * [Note] This is small update.
  * [Xcode] Fixed regressions in OSX and Android template generation and build.
  * [OSS] Be sure to run `motion repo` to get fixes to template regresssions faster.
  * [OSS] A new command will soon be added called `motion pulse`. This will give you
    the latest news right in your terminal (as opposed to relying on
    social media, blogs, emails blasts, or forums). `motion pulse` will give
    important information and point you to where you can read more if needed.
    If you'd like to share any RM news with the community, create a pull request at
    http://github.com/amirrajan/pulse.rubymotion.com.
  * [Mojave] Work to support Mojave and iOS 12.0 has begun. Keep an eye on progress
    using the `motion pulse` command.


= RubyMotion 5.9 =
  * [News] RubyMotion one year recap (since I took over as CEO/Steward). Read here and share: http://www.rubymotion.com/news/2018/05/13/one-year-later.html
  * [Xcode] Xcode 9.4 support added.
  * [Xcode] [Important] [OSS] If you are using BubbleWrap, you will need to add `app.frameworks << "MobileCoreServices"` for compiling against 11.4.
    See GH Issue: https://github.com/rubymotion/BubbleWrap/issues/498
  * [LLVM] The RubyMotion compiler is still going through upgrades to fully support LLVM 5.0 and maintain compatibility
    with Apple's clang compiler. This is all low level plumbing and will not affect you negatively. Just be aware that
    the update is a SemVer release (LLVM 3.9 to 5.0). Quite a few touch points, but all manageable. The stack-trace and
    crash log issues (and the `CMTime` issue in Xcode 9.4 Beta 2 will be fixed with this upgrade).
  * [iOS 11.4 Frameworks] [Important] It seems like quite a few framework dependencies have been moved around. If
    you get a compiler or runtime error along the lines of:

    ```
    undefined method 'SOMEMETHODNAME'
    ```

    or

    ```
    uninitialized constant SOMECONSTANTNAME (NameError)
    ```

    It may be because the symbole has been moved to a different framework. To find the framework:

    ```
    brew install ag
    ag "TypeOrMethodName" /Library/RubyMotion/data/ios/11.4/BridgeSupport
    ```

    A file name will be returned (if the symbol is found). Add the returned framework to your `Rakefile`

    ```
    app.frameworks << 'FRAMEWORK_FROM_SEARCH'
    ```

    If you hit any snags. Come to the Slack channel or report an issue at http://github.com/amirrajan/rubymotion-applied

  * [OSX High Sierra] [Important] Apple introduced a new filesystem called APFS. This is different than the filesystem
    on Sierra, Mac OS Extended (HFS+). Context/writeup about this issue is here:
    https://eclecticlight.co/2017/07/17/apfs-ios-11-and-high-sierra-will-fix-normalisation-problems/

    The primary problem with this new file system is that `Dir.glob` no longer returns files in lexicographical order.
    The impact of this ordering may cause compilation errors. If you depend on gems that have build errors
    it is because the gems include files without sorting them. Given this:

    ```
    app.files = Dir.glob('**/*.rb')
    ```

    Will no longer return files in a guaranteed order. The fix for this issue is
    to change the line above to:

    ```
    app.files = Dir.glob('**/*.rb').sort
    ```

    An example of this side effect is seen in both ProMotion, and Bubblewrap. Here are the
    lines that will need to be changed:

    - https://github.com/infinitered/ProMotion/blob/master/lib/ProMotion.rb#L11
    - https://github.com/rubymotion/BubbleWrap/blob/master/lib/bubble-wrap/requirement.rb#L57

    General recommendation is to:

    1. `brew install ag`
    2. `ag Dir.glob`
    3. Replace all occurrences of `Dir.glob()` with `Dir.glob().sort`

    The build tools within RubyMotion have been fixed to use `Dir.glob().sort` where applicable.
    Possible issues with generating BridgeSupport files will be fixed with this update. Report problems to http://github.com/amirrajan/rubymotion-applied

    Absolute worst case (which should be done as a last resort), would be to work around this problem by creating an HFS+ partition, and build your application
    on that partition. Again, this should not be needed. But an HFS+ partition will avoid any regressions you may experience across all rubies and applications
    that suddenly stop working on High Sierra (the APFS change has impacted all thick client apps on Mac OS and isn't limited to just RubyMotion).

    Community Heroes

    A BIG thank you goes out to Isaac Kearse (@isaackerse) for helping to troubleshoot this APFS issue.
    Another big thank you to Lori Olsen (@wndxlori) and Andrew Havens (@andrew) for the work they've put
    in to maintain motion-support, motion-providing, ProMotion, and Bubblewrap. Be sure to show your gratitude to them on
    [Slack](http://motioneers.herokuapp.com).

    RubyMotion's future is bright :-)


= RubyMotion 5.8 =
  * [Community] The RubyMotion community forum has been rebooted. Please read about
    it here: [Hello World](http://community.rubymotion.com/t/hello-world-start-here/13?u=amirrajan)
  * [News] [RubyMotion's Guiding Principals](http://www.rubymotion.com/news/2018/02/12/rubymotion-guiding-principals.html)
  * [Android] Added support for API 26 and 27. Removed support for API 19 and 20 as they are no long supported by Google.
  * [RM Starter] Starter edition will target Android api 27 as opposed to api 23.
  * [BridgeSupport] Fixes for the Stripe cocoapod. This should resolve exceptions in `xcpretty_printer`.
  * [Xcode] Xcode 9.3 support added. Please keep in mind that Xcode 9.3 *requires* High Sierra.
  * [OSX High Sierra] `Dir.glob` behaves differently in High Sierra. Do not rely on this to import `.rb` files in the right order.

    Details:

    Given High Sierra's new file system. `Dir.glob` orders files differently _across all rubies_. It's generally recommended
    that you do not rely on `Dir.glob`'s file order for requiring `.rb` files. With regards to RubyMotion, have `app.detect_depencencies`
    set to `false` will most likely not work. Look for the following warning message when performing a build on High Sierra:


    ```
    # Warning is provided by: /Library/RubyMotion/lib/motion/project/dependency.rb:46
    # I encourage you to study it as it's a very interesting problem that uses a
    # very interesting package called 'ripper'.

    WARNING: Possible cyclical dependency between #{def_path} and #{ref_path}'s class hierarchy. Consider revision if
    runtime exceptions occur around undefined symbols.
    ```

    - It is strongly recommended that you set `app.detect_depencencies` to `true`.
    - If you see the warning above, it is strongly recommended that you resolve the cyclical dependency.
    - This directly affects the following RubyMotion gems: Formotion, motion-support. For more information on how this will be fixed,
      see: https://github.com/rubymotion/motion-support/issues/38#issuecomment-366676898


= RubyMotion 5.7 =
  * [RubyMotion Templates] Fixed regression in templates where templates hosted in a git repo stopped working.
  * [RubyMotion Templates] Added RUBYMOTION_OFFLINE environment variable if you don't want to synchronize templates or cli commands.
  * [Xcode] Xcode 9.3 beta support added.


= RubyMotion 5.6 =
  * [RubyMotion Templates] RubyMotion templates have been moved external to RM so that they can be updated outside of releases.
  * [RubyMotion Command] Machinery to support RubyMotion auxiliary commands has been added.
  * [Xcode] Xcode 9.2 (iOS 11.2 et al) support has been added.
  * [OSX] OSX 10.13 has been added to RubyMotion Starter Edition.
  * [News] Take a moment to read the following link and give me your thoughts: http://community.rubymotion.com/t/the-future-of-rubymotion/2227/5?u=amirrajan


= RubyMotion 5.5 =
  * [OSX, High Sierra BridgeSupport] Fixed macOS static constant generation (regeneration of BOTH 10.12 and 10.13 bridge support).


= RubyMotion 5.4 =
  * [Xcode] Support for Xcode 9.1 added, Xcode 9.2 beta support added.
  * [OSX, High Sierra BridgeSupport] Fixed macOS static constant generation.
  * [News] Be sure to join the Slack channel and say hello: http://motioneers.herokuapp.com/.
  * [News] Looks like there will be one more update to Xcode from Apple before we head into holiday season. After
           this release RM will begin new feature work for the new year :-)
  * [News] Press Release scheduled for Jan 2018. I (Amir) will be at RubyConf in New Orleans. Come say hi.
  * [News] Visit https://github.com/amirrajan/rubymotion-applied/issues for pending issues.
  * [Pending] Waiting for ownership rights to motion-sqlite3 repo. Check github.com/amirrajan/rubymotion-applied
              for a patch to get sqlite working on High Sierra for iOS.
  * [Pending] motion-cocoapods + resources. Check github.com/amirrajan/rubymotion-applied for current workaround.


= RubyMotion 5.3 =
  * [Xcode] For High Sierra, be sure to download Xcode from
    developer.apple.com/download/more. Direct download link: https://download.developer.apple.com/Developer_Tools/Xcode_9/Xcode_9.xip
  * [Xcode] Fixes for BridgeSupport on High Sierra (working on
    removing the need for symlinks in the Xcode directory).


= RubyMotion 5.2 =
  * [Xcode] Xcode 9.1 beta support added.
  * [Xcode] Fixed issues with Cocoapods compiling against Xcode 9.0.


= RubyMotion 5.1 =
  * [MacOSX] High Sierra SDKs updated to RTM.
  * [MacOSX] BridgeSupport2 added for High Sierra.
  * [MacOSX] Symlink added to Xcode on High Sierra. If build fails,
  * run the following code as `sudo` (you shouldn't have to, but just
  * in case):

  ```ruby
      File.symlink "/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain",
                   "/Applications/Xcode.app/Contents/Developer/Toolchains/OSX10.13.xctoolchain"
  ```
  * [MacOSX] @digitalmoksha has observed that some enums now require a type prefix, info below:

  Some enums that you might have used in your code, for example

  ```ruby
  case return_code
  when NSAlertFirstButtonReturn  # OK
  ```

  are now typed constants, so you need to do

  ```ruby
  case return_code
  when NSModalResponse.NSAlertFirstButtonReturn  # OK
  ```

  You can see the difference in the bridgesupport files:

  ```ruby
  # /Library/RubyMotion/data/osx/10.13/BridgeSupport/AppKit.bridgesupport
  <constant const='true' declared_type='NSModalResponse' name='NSAlertFirstButtonReturn' type='i' type64='q'/>
  ```

  versus

  ```ruby
  # /Library/RubyMotion/data/osx/10.12/BridgeSupport/AppKit.bridgesupport
  <enum name='NSAlertFirstButtonReturn' value='1000'/>
  ```


= RubyMotion 5.0 (Sep 2017) =
  * [SemVer] 32 bit compilation has been removed. Use RM 4.22 and
    Xcode 8.3.3 to build 32 bit artifacts.
  * [SemVer] Xcode 9 GM is now the default Xcode. Make sure Xcode 9 GM is
    installed as `/Applications/Xcode.app`. Be sure to run `rake
    clean:all` on your apps to ensure a complete recompile.
  * [SemVer] Support for Xcode versions < 9.0 has been dropped. This
    includes repl support. To use older versions of RM:

    1. `sudo motion update --cache-version=VERSIONNUMBER
    2. `sudo cp /Library/RubyMotion/ /Library/RubyMotion.bak`
    3. `sudo mv /Library/RubyMotionVERSIONNUMBER/ /Library/RubyMotion`
    4. `sudo cp /Library/RubyMotion.bak/license.key /Library/RubyMotion/`

    This only applies for RubyMotion version < 5.0. Furture versions
    of RubyMotion will not require you to "fully reinstall" (the `sudo
    motion update --cache-version =VERSIONNUMBER` command can be used
    normally without having to explicitly move directories).

  * [iOS] Asset Catalogs added to default iOS template. Apple now
    requires Asset Catalogs for icons and launch screens. If you
    haven't been using them, you'll need migrate over. To see how this
    will impact your app, create a new RM app using `motion create
    SOMETEMPAPPNAME` and take a look at the `./readme.md`, `./Rakefile`,
    and `./resources` contents. Thanks to John Gerhardt for helping to test
    out Asset Catalogs.
  * [RM Starter] No changes to RM Starter will be pushed until Xcode 9
    is officially released. You'll have to keep using Xcode 8.3.3 till
    then.
  * [MacOSX] High Sierra is still in beta (pre GM). Updates to
    RubyMotion will come as soon as High Sierra goes GM.
  * Be sure to join the Slack channel: http://motioneers.herokuapp.com/


= RubyMotion 4.22 =
  * [iOS] Xcode Beta 5 Support added.
  * [iOS] Fixed missing `AVFoundation` missing enumerations for iOS 11.0.

  # IMPORTANT, iOS Beta 4 regression has been fixed in iOS Beta 5.

  Changes between Beta 4 to Beta 5:

  On devices running iOS 11.0 Beta 4, three (known) new classes called
  `Process`, `Event`, and `App` are now part of the bundle
  **regardless of what SDK your app targets**.

  Good news:

  It looks like this regression has been fixed by Apple in iOS 11.0
  Beta 5. **It is still recommend that you namespace all of your
  classes going forward.**

  Instead of:

  ```ruby
  class SomePOROClass
  end

  class AppDelegate
    def application(application, didFinishLaunchingWithOptions:launchOptions)
      @some_class = SomePOROClass.new
      true
    end
  end
  ```
  You should do:

  ```ruby
  module MyApp
    class SomePOROClass
    end
  end

  class AppDelegate
    def application(application, didFinishLaunchingWithOptions:launchOptions)
      @some_class = MyApp::SomePOROClass.new
      true
    end
  end
  ```

= RubyMotion 4.21 =
  * [iOS] Fixed crash of RubyMotion apps running on iOS 11.0 Beta 4.
  * [iOS] Deprecation notice for older iOS SDKs.
  * [Android] Deprecation notice for older Android SDKs.
  * [Important] Read below for explanation of crash and steps to
    ensure your apps work when iOS 11.0 goes GM.

  # IMPORTANT, YOUR APP WILL BE IMPACTED BY THIS #

  [iOS] iOS 11.0 Beta 4 crashes on device have been fixed. You will
  need to recompile and re-distribute your app to ensure compatibility
  with iOS 11.0 **regardless of whether you update your target SDK
  or not**.

  # STEPS TO FIX #

  On devices running iOS 11.0, three (known) new classes called
  `Process`, `Event`, and `App` are now part of the bundle
  **regardless of what SDK your app targets**.

  To ensure that your classes do not collide with iPhoneOS classes, be
  sure to namespace your code.

  Instead of:

  ```ruby
  class SomePOROClass
  end

  class AppDelegate
    def application(application, didFinishLaunchingWithOptions:launchOptions)
      @some_class = SomePOROClass.new
      true
    end
  end
  ```

  You should do:

  ```ruby
  module MyApp
  class SomePOROClass
  end
  end

  class AppDelegate
    def application(application, didFinishLaunchingWithOptions:launchOptions)
      @some_class = MyApp::SomePOROClass.new
      true
    end
  end
  ```

  # FURTHER EXPLANATION #

  The failure occurs because the RubyMotion runtime creates a module
  called `Process` and then attempts to define methods on it such as
  `exit`, `fork!`, etc (which fails given the _retroactive_ addition of
  the `Process` class). This RubyMotion module has been renamed
  `Process__`.

  For `App`, if you use BubbleWrap (or have defined a module or
  class named `App` within your bundle), you’ll now have to fully qualify
  it (eg: `BubbleWrap::App.run_after`).

  Generally speaking, if you get a crash, do an audit of your own
  defined classes and see if any of them return true for `defined?()`
  in an empty project.

  Here is some code that demonstrates the introduction of these
  internal classes:

  ```ruby
  puts "=============================="

  puts "In [#{NSProcessInfo.processInfo.operatingSystemVersionString}]"

  if defined?(Process)
  puts "Process is defined in:"
  puts NSBundle.bundleForClass(Process.class).executableURL.absoluteString
  else
  puts "Process is not defined."
  end

  puts "=============================="
  ```

  Here is the repl output,

  ```
  >NSBundle.bundleForClass(Process.class).executableURL.absoluteString
  >In [Version 10.3.2 (Build 14F89)]
  >Process is not defined.

  >In [Version 11.0 (Build 15A5327g)]
  >Process is defined in:
  >file:///var/containers/Bundle/Application/856409D3-C28E-4FAB-8F6E-6E38C75552FC/XXXXX.app/XXXXXXXX
  ```

  Why Apple has added these internal classes _retroactively to all
  SDKs_ is unclear.

  # DEPRECATION NOTICE: 32 BIT #

  - [iOS] Given iOS 11.0 is 64 Bit only, RubyMotion will NO LONGER support
    32 bit compilation after this release. The following SDKs will be
    removed entirely:
  - [iOS] iPhoneOS 5.1, 6.0, 6.1, 7.0, 7.1 will be removed entirely.
  - [Android] Android API Version 10, 11, 12, 13, 14, 15, 16, 17, and 18 will be
    removed entirely.
  - Note: You an always use the `motion * update --cache-version=X.XX`
    command to download an older version of RubyMotion.


= RubyMotion 4.20 =
  * [iOS, OSX, watchOS, tvOS] Added support for Xcode 9 Beta 4.


= RubyMotion 4.19 =
  * The toolchain has been upgraded to LLVM 3.9 for all platforms.
  * [iOS, OSX, watchOS, tvOS] Added support for Xcode 9.
  * [iOS, OSX, watchOS, tvOS] Added support for iOS 11, tvOS 11, watchOS 4 and
    macOS 10.13
  * [Android] Support for MultiDex. If you get an error saying your app has
    over 65536 methods, enable MultiDex by setting `app.multidex = true` in
    your Rakefile.


= RubyMotion 4.18 (New leadership) =
  * Fixed some memory leaks in REPL.
  * Improve `rake spec' by removing redundant backtrace to find the failure
    specs ease.
  * Improve backtrace in exceptions by including the directory path in the
    backtrace of the file where raised the exception.
  * [iOS, OSX, watchOS, tvOS] Added support for Xcode 8.3.
  * [iOS, OSX, watchOS, tvOS] Added support to use the frameworks which created
    by Swift language.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug which could not build the 3rd-party
    framework through `app.vendor_project'.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug which NSMutableArray#{pop, shift}
    would cause a crash.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug which it could not call the method
    which added by nested `include'.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug which Module#ancestors would return
    the incorrect value in some cases.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug in where Module#undef_method would
    not undefine the method from all included classes.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug in where Module#remove_method would
    not remove the method from all included classes.
  * [iOS, OSX, watchOS, tvOS] Fixed a memory leak which would be caused by
    Hash.new {|hash, key| }.
  * [iOS, OSX, watchOS, tvOS] Fixed a problem where it would copy unnecessary
    files in sub directory of resources directory.
  * [iOS, OSX, watchOS, tvOS] Fixed a problem where generating metadata for
    3rd-party library causes build failure with C++ header files.
  * [iOS, OSX, watchOS, tvOS] Improved Hash#flatten wperformance. ~10 times
    faster.
  * [iOS, OSX, watchOS, tvOS] Fixed a problem which build error would be caused
    in where generate bridgesupport metadata if dynamic frameworks were used
    through `app.embedded_frameworks'.
  * [iOS, tvOS] Fixed a problem which the codesigning mightn't be handled to
    pre-built 3rd party dynamic frameworks.
  * [iOS] RubyMotion Starter now targets iOS 10.3.
  * [iOS] Fixed a problem which `rake ib` task failed in extension project.
  * [watchOS] Fixed a problem which build error would be occurred if container
    app's name has spaces.
  * [OSX] Fixed the template in OS X project to follow Xcode's template.
  * [Android] Fixed a problem which cannot use `rake ctags' in Android project.


= RubyMotion 4.17 =
  * Fixed some memory leaks in REPL.
  * [iOS] RubyMotion Starter now targets iOS 10.2.
  * [iOS] Got rid of warning message when building iOS extensions for the
    device.
  * [watchOS] Added support watchOS complications in the watch app template.
  * [watchOS] Fixed a bug where image assets could not be used in watchOS
    extensions.
  * [Android] Fixed a problem where a build error would be triggered if
    `app.name' included uncommon characters.
    Thanks to Hwee-Boon Yar for the patch (pull request #248).
  * [Android] Improve build time slightly for emulator.


= RubyMotion 4.16 =
  * Introduced the `filter' option to `rake spec', which can be used to filter
    the specs that should be run using a regex.
    Example: rake spec filter="can retrieve users"
    Thanks to Pablo Alcalde for the patch (pull request #246).
  * [iOS, OSX, watchOS, tvOS] Added support for Xcode 8.2 beta.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug where 3rd-party libraries could not
    be built with `rake build'.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug which it would cause a compile error
    with 32bit app when a method which returns a structure value was called if
    the structure has only one float field.
  * [iOS, OSX, watchOS] Fixed an error when compiling 32-bit binary when
    compiling a Ruby method which overrides an Objective-C method which returns
    a structure value.
  * [iOS, watchOS, tvOS] Fixed a bug where `eval()' was available in
    application code.
  * [iOS, tvOS] Fixed a bug in `motion device-console' and `rake device' when
    some devices are connected via USB.
  * [tvOS, watchOS] Fixed a bug where `rake clean' wouldn't remove the build
    directories in 3rd-party libraries.
  * [iOS] Fixed a regression where ibtool would cause an error if extension and
    container app has storyboard files.
  * [iOS] Fixed a problem in `rake profile template="..."'.
  * [iOS] Fixed an issue when running specs where if a view was not found using
    the helper method `view(label)' it would not be included in the error count.
    Thanks to Pablo Alcalde for the patch (pull request #244).
  * [iOS] Fixed an issue where an extension's Gemfile was not being
    automatically installed when compiling its parent application.
  * [iOS] Fixed an issue where the wrong extension bundle could be copied to
    the resulting app if there was no change to the extension between builds.
  * [tvOS] Fixed a problem which it could not submit app to AppStore.
  * [watchOS] Removed watchOS v1 (WatchKit extension) app because to submitted
    to the App Store must be apps built with the watchOS 2 SDK or later.
    Please use 'ios-watch-app' template for WatchOS apps.
  * [watchOS] Changed default deployment target value to latest SDK version. If
    you need, please specify deployment target using `app.deployment_target' in
    Rakefile of watchOS app.
  * [watchOS] Fixed a problem which debug log wouldn't be displayed properly
    with `rake watch'.
  * [watchOS] Fixed a problem which `rake ib' on watchOS app project causes an
    error if customized a deployment target.
  * [watchOS] Fixed a trivial problem in `rake watch skip_build=true'.
  * [watchOS] Fixed a bug which a structure value couldn't be passed into a
    method as the argument and couldn't be retrieved from method as returned
    value (such as MKCoordinateRegion/NSRange value).
  * [watchOS] Got rid of warning messages when compiling Ruby files for device.
  * [OSX] Fixed a problem which it wouldn't be able to compile OS X app without
    installing Xcode command line tools.
  * [OSX] Fixed a bug where `rake profile:templates' displayed the invalid
    instruments templates.
  * [Android] Updated Android NDK to android-ndk-r13b version. Please update
    the Android NDK toolchain by using `motion android-setup' command.
  * [Android] Fixed a compilation error if the same Ruby subclass of a Java
    class was defined in two different files.


= RubyMotion 4.15 =
  * `motion update` command will exit with code 0 if there is no update.
  * [iOS, OSX, watchOS, tvOS] Added better support for Xcode 8.1.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug that could cause a deadlock if `eval'
    was evaluated in the REPL.
  * [iOS, OSX, tvOS] Fixed a bug where the wrong Boxed object would be returned
    from an Objective-C method if structure declaration has a float type in
    last member.
  * [iOS, OSX, tvOS] Fixed a bug where the wrong Boxed object would be returned
    from an Objective-C method if structure declaration has a float array type.
  * [iOS, watchOS] Fixed a bug where it wouldn't resolve framework dependencies
    in iOS extension, iOS framework and WatchKit extension for watchOS projects.
  * [iOS, tvOS] Improved error description when deploying an app to a device.
  * [iOS, tvOS] Fixed a problem where it wouldn't display log messages in
    device with `rake device' and `motion device-console'.
  * [iOS, tvOS] Fixed a buffer overflow bug when handling device log messages
    with `rake device' and `motion device-console'.
  * [iOS, tvOS] Fixed a problem where `rake crashlog:device' wouldn't display
    the crash log from device since iOS/tvOS 10.
  * [iOS, tvOS] Fixed a bug where Exception#bactrace would not show the proper
    line number in backtrace messages on device.
  * [iOS] RubyMotion Starter now targets iOS 10.1.
  * [iOS] Fixed the templates for notification-content and notification-service
    extensions.
  * [iOS] Fixed a problem where an app could not be run on device if Wi-Fi sync
    option was enabled in the Summary of iTunes device backup configuration.
  * [iOS] Fixed a bug where custom debug commands (ex. `pro', `pri') would not
    work on device.
  * [iOS] Fixed a problem where the debugger would not automatically run an app
    on a device with `rake device debug=1'.
  * [iOS] Fixed a problem where an app could not be launched on iOS Simulator
    with Xcode 7.2 or below.
  * [iOS, tvOS, watchOS, Android] Fixed a problem where an app on the device
    will continue running when terminate REPL with ^C.
  * [watchOS] Fixed a bug where the MapKit framework in WatchKit extension was
    not being imported by default.
  * [watchOS] Fixed a bug which `rake watch display=regular|compact' would not
    launch proper watchOS simulator.
  * [OSX] Fixed crash when launching document-based applications via rake.
  * [OSX, watchOS, Android] Fixed a bug where REPL won't be terminated with ^D.
  * [Android] Added support for API 25 (experimental).
  * [Android] Updated Android NDK to android-ndk-r13 version. Please update the
    Android NDK toolchain by using `motion android-setup' command.
  * [Android] Added String#== method.


= RubyMotion 4.14 =
  * The toolchain has been upgraded to LLVM 3.8 for all platforms for Xcode 8.
  * [iOS, OSX, watchOS, tvOS] Added better support for Xcode 8.
  * [iOS, OSX, watchOS, tvOS] Added support for iOS 10.1, watchOS 3.1. You will
    need Xcode 8.1 (beta) for these.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug where it would trigger an assertion
    when it will call an objective-c method which has long method signature.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug where structure value cannot be
    received as an argument at Ruby method if the method would be called from
    objective-c.
  * [iOS, OSX, watchOS, tvOS] Fixed a buffer overflow bug in where launching
    the debugger.
  * [iOS, OSX, watchOS, tvOS] Fixed a problem which cannot build the app which
    uses 3rd-party libraries if you have used Ruby which was installed by rvm.
  * [iOS] RubyMotion Starter now targets iOS 10.0.
  * [iOS] Added support for iOS 10 extensions. To see the list of supported
    extensions run `motion create'.
  * [iOS] Fixed a regression which can't launch an app on Simulator in Xcode
    if it would switch Xcode path using `app.xcode_path'.
  * [iOS] Extension targets will now have the same `app.version` and
    `app.short_version` as their containing apps by default.
  * [Android] Updated Android NDK to android-ndk-r12b version. Please update
    the Android NDK toolchain by using `motion android-setup' command.
  * [Android] Dropped API 8 supporting.


= RubyMotion 4.13 =
  * [iOS, OSX, watchOS, tvOS] Added better support for Xcode 8 beta.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug where ENV#inspect would always be an
    empty hash.
  * [iOS, tvOS] Fixed a bug where SIM_STDOUT_PATH/SIM_STDERR_PATH do not work
    if the path of the project contained spaces.
  * [iOS] Fixed an issue where apps would sometimes fail to install in the iOS
    simulator.
  * [OSX] Dropped support for OS X 10.7 and 10.8.
  * [OSX] Removed debug log which would be displayed with (command + mouse over).
  * [OSX] Fixed REPL connection for sandboxed apps.
  * [OSX] Fixed an issue where deployment target would be incorrectly set when
    running on OS X 10.12 and using Xcode 7.
  * [watchOS] Removed debug log which would be displayed in REPL.
  * [Android] Added `undef' method.
  * [Android] Added BigDecimal and ENV.
  * [Android] Added Kernel.{Array, String, Integer, Float} methods.
  * [Android] Added Kernel#<=> and Fixnum#quo methods.
  * [Android] Added String#upto method.
  * [Android] Added Symbol#{slice, size} methods.
  * [Android] Added Object#remove_instance_variable method.
  * [Android] Changed base class of Time to java.util.Calendar instead of
    java.util.Date to handle time zone properly.
  * [Android] Added Time.{mktime, local, utc, gm} methods.
  * [Android] Added Time#{zone, yday, gmtoff, gmt_offset, utc_offset, getgm,
    getutc, gmtime, utc, localtime, getlocal, nsec, subsec, tv_sec, tv_usec,
    tv_nsec, utc?, gmt?, sunday?, monday?, tuesday?, wednesday?, thursday?,
    friday?, saturday?, isdst, dst?} methods.
  * [Android] Added Module#{remove_method, const_defined?, remove_const,
    remove_class_variable} methods.
  * [Android] Fixed various issues in Module#{to_s, alias_method, undef_method}
    to conform to the Ruby specifications.
  * [Android] Fixed various issues in Kernel#sleep and Range#{each, include?,
    member?, ===} to conform to the Ruby specifications.
  * [Android] Fixed a bug where Module#ancestors would cause a crash on Module.


= RubyMotion 4.12 =
  * [iOS, OSX, watchOS, tvOS] Added support for iOS 10, tvOS 10, watchOS 3
    and macOS 10.12 (experimental). You will need Xcode 8 (beta) for these.
  * [tvOS, watchOS] Got rid of warning messages when compiling Ruby files.
  * [iOS, OSX, watchOS, tvOS] Added BigDecimal#{dup, clone} to fix an error in
    duplication.
  * [iOS, OSX, watchOS, tvOS] Fixed a use-after-free bug when resolving cycle
    references in Hash objects.
  * [iOS, OSX, watchOS, tvOS] Fixed a use-after-free bug in String#<< method.
  * [iOS, OSX, watchOS, tvOS] Fixed a use-after-free bug on 32-bit environment
    when invoking an expression in an overridden `dealloc' method.
  * [iOS, OSX, watchOS, tvOS] Fixed a buffer overrun bug when creating a
    Regexp literal.
  * [iOS, OSX, watchOS, tvOS] Fixed a buffer overrun bug when raising an
    exception.
  * [iOS, OSX, watchOS, tvOS] Fixed a buffer overrun bug when searching a
    word in String methods.
  * [iOS, OSX, watchOS, tvOS] Fixed a buffer overrun bug in String#%.
  * [iOS, OSX, watchOS, tvOS] Fixed a buffer overflow bug in Bignum#to_s.
  * [iOS, OSX, watchOS, tvOS] Improved dispatcher performance. ~25% faster.
  * [iOS, OSX, watchOS, tvOS] Improved performance when creating instances.
    ~15% faster.
  * [iOS, OSX, watchOS, tvOS] Improved `new' performance in Proc and Pure Ruby
    class which does not inherit a Cocoa class. ~2 times faster.
  * [iOS, OSX, watchOS, tvOS] Improved Hash#{each, each_pair} performance.
    7 times faster.
  * [tvOS] Fixed an issue where it cannot search provisioning profile created by
    Xcode for tvOS app.
  * [iOS, OSX, watchOS, tvOS] Fixed an issue where dSYM files would not be
    created if the executable was linked but no .rb file was compiled.
  * [Android] Improved performance with 3 new features: literal fixnums,
    optimized arithmetic selectors, and instance variable cache. To get
    an advantage of these optimizations you only need to recompile your app.
  * [Android] Improved compilation speed by using incremental DEX file builds.
  * [Android] Improved compiling time for development by non-optimization.
  * [Android] Improved `app.vendor_project' to now support a `:filter` value,
    which can be set as an Array of regexp patterns, and be used to determine
    which classes of a framework should be covered in the `.bridgesupport' file
    (useful when vendoring a huge library and only needing a few classes).
  * [Android] Updated Android NDK to android-ndk-r11c and SDK package version.
    Please update the Android NDK toolchain by using `motion android-setup'.
  * [Android] Got rid of warning messages when creating the `libpayload.so'
    library, which appeared with the new Android NDK.
  * [Android] Fixed a use-after-free bug when calling block methods.
  * [Android] Fixed a bug where pure Ruby methods could not be overridden.
  * [Android] Fixed various issues in Fixnum#!= to conform to the Ruby
    specifications.
  * [Android] Fixed various issues in Array.new and Array#{<<, concat, insert,
    initialize, +, replace, values_at, inspect, to_s, <=>, zip, flatten,
    flatten!} to conform to the Ruby specifications.
  * [Android] Fixed various issues in Hash.[] and Hash#{inspect, to_s} to
    conform to the Ruby specifications.
  * [Android] Fixed various issues in Enumerable#{count, find_index, member?,
    include?, select, find_all, first} to conform to the Ruby specifications.
  * [Android] Fixed various issues in Time.at and Time#{+, -, usec} to conform
    to the Ruby specifications.
  * [Android] Fixed various issues in String#{chop, reverse, reverse!, strip,
    strip!, rstrip, rstrip!} to conform to the Ruby specifications.
  * [Android] Fixed various issues in `return', `break', Proc.new, Kernel#send
    and Bignum methods to conform to the Ruby specifications.
  * [Android] Changed default CPU architecture to `armv7' from `armv5te' in
    order to avoid `java.lang.OutOfMemoryError: PushLocalFrame' which would
    happen on some devices when launching an app.
  * [Android] Fixed a bug where it would cause a crash when passing many
    arguments into Array#{unshift, insert, values_at}.
  * [Android] Fixed a bug where it would cause a crash if Array object has
    many elements with Hash#delete_if.
  * [Android] Fixed a bug which it would cause a crash if Hash object has many
    elements with Array#{-, &, |, uniq, uniq!}.
  * [Android] Fixed a bug which `return' does not return a value immediately at
    Proc block.
  * [Android] Fixed a bug where compiler would crash with splat arguments in
    `case/when' expressions.
  * [Android] Fixed a bug when vendoring a .jar file that includes a lot of
    classes (ex. the latest version of Google Play Services).
  * [Android] Added support for API 24 (experimental).
  * [Android] Added Java JDK 8 supporting.
  * [Android] Added Array#{assoc, rassoc, fetch, fill, rotate, rotate!, sort,
    sort!, sort_by!, sample, shuffle, shuffle!} methods.
  * [Android] Added Array.try_convert, String.try_convert, Hash.try_convert and
    Array.[] methods.
  * [Android] Added Hash#flatten method.
  * [Android] Added String#{each_byte, bytes, bytesize} methods.
  * [Android] Added Bignum#{coerce, div, size, remainder, fdiv, quo, magnitude}
    methods.
  * [Android] Added Enumerable#{sort, sort_by, zip} methods.
  * [Android] Added Time#{sec, min, hour, day, mday, mon, month, year, wday,
    ctime, asctime} methods.
  * [Android] Added GC.start method.
  * [Android] Added Kernel#set_vm_debug_logs(boolean) to enable or disable debug
    logs programmatically.
  * [Android] Added including Comparable module into String and Time class.


= RubyMotion 4.11 =
  * The toolchain has been upgraded to LLVM 3.7 for all platforms.
  * [Android] Updated Android NDK to android-ndk-r11 version. Please update
    the Android NDK toolchain by using `motion android-setup' command.
  * [Android] Fixed a bug where Java interfaces that extend an interface
    (ex. `android.text.TextWatcher') would not be available in Ruby.
  * [iOS] RubyMotion Starter now targets iOS 9.3.
  * [iOS, watchOS] Fixed an issue where codesigning causes error with
    "cannot read entitlement data" with WatchOS app, Extensions and Frameworks
    after updated rake to 11.0.1+.
    Thanks to Taylor for the patch (pull request #241).


= RubyMotion 4.10 =
  * [Android] RubyMotion Starter now targets API 23.
  * [Android] Added ScriptError, SyntaxError and StopIteration.
  * [Android] Added Fixnum#{**, div, fdiv, truncate, coerce, magnitude} methods.
  * [Android] Added Float#{**, coerce, div, fdiv, quo, nan?, infinite?, finite?}
    methods.
  * [Android] Added Float::{ROUNDS, RADIX, MANT_DIG, DIG, MIN_EXP, MAX_EXP,
    MIN_10_EXP, MAX_10_EXP, MIN, MAX, EPSILON, INFINITY, NAN} constants.
  * [Android] Added Bignum#** method.
  * [Android] Added Regexp.{new, compile, quote, escape, last_match} methods.
  * [Android] Added Regexp::{IGNORECASE, EXTENDED, MULTILINE} constants.
  * [Android] Added MatchData#{eql?, ==} methods.
  * [Android] Added Range#{first, last, cover?} methods.
  * [Android] Added Enumerable#{take_while, drop_while} methods.
  * [Android] Added Object#{object_id, __id__} methods.
  * [Android] Added Kernel.#loop method.
  * [Android] Fixed an issue in `motion android-setup' which it wouldn't accept
    relative directory path in `--directory' option.
  * [Android] Fixed an issue where Module#{const_set, class_variable_get,
    class_variable_set, class_variable_defined?, instance_variable_get,
    instance_variable_set, instance_variable_defined?, attr, attr_reader,
    attr_writer, attr_accessor} would accept invalid names.
  * [Android] Fixed various issues in String#{index, rindex, split, []=, chomp,
    to_i, rjust, each_line, scan, sub, gsub, +} to conform to the Ruby
    specifications.
  * [Android] Fixed various issues in Array#{[]=, flatten} to conform to the
    Ruby specifications.
  * [Android] Fixed various issues in Hash#{[], []=, merge, store, has_value?,
    replace} to conform to the Ruby specifications.
  * [Android] Fixed various issues in Regexp#{match, =~} to conform to the Ruby
    specifications.
  * [Android] Fixed various issues in MatchData#{[], regexp, length} to conform
    to the Ruby specifications.
  * [Android] Fixed a bug when dispatching a polymorphic method given an
    Array argument, when the version that expects a Java array would be called
    instead of the version that expects a java.util.List.
  * [Android] Fixed a bug when re-opening a class that was previously defined
    where the build system would generate an incorrect Java class.
  * [Android] Fixed an issue that could cause compilation error when invoking
    `aapt' and using newer versions of support packages with an older Android
    api version.
  * [iOS, OSX, tvOS] Fixed issue where the REPL would not auto insert the
    suggested autocompletion result.
  * [iOS] Added better support for Xcode 7.3 beta in order to get rid of
    warning messaged when compiling apps for the device.
  * Fixed a bug where objects would not be converted with #to_ary when yield.
  * Fixed various issues in Proc#call to conform to the Ruby specifications.


= RubyMotion 4.9 =
  * [Android] Added Comparable module.
  * [Android] Added Array#{-, &, |, <=>, to_ary, uniq, uniq!, cycle} methods.
  * [Android] Added Kernel#{enum_for, to_enum} methods.
  * [Android] Added Enumerator#{with_index, with_object, each_with_index,
    each_with_object} methods.
  * [Android] Added Enumerable#{cycle, reject, take, drop} methods.
  * [Android] Added Module#{include?, class_variable_get, class_variable_set,
    class_variable_defined?, module_eval, class_eval} methods.
  * [Android] Added Object#define_singleton_method method.
  * [Android] Fixed a bug where overriding a pure Ruby method would cause a
    crash.
  * [Android] Fixed a bug where a compile error would happen when trying to use
    the back-reference syntax of a regular expression.
  * [Android] Fixed a bug where an app couldn't launch on an arm64 device
    (ie. Nexus 9).
  * [Android] Fixed a bug where evaluating expression on REPL would trigger a
    crash on an arm64 device.
  * [Android] Fixed a bug in Time#strftime where local time wasn't used.
  * [Android] Fixed a memory leak in Enumerator objects.
  * [Android] Fixed a crash if `nil' would be passed into methods as index
    arguments.
  * [Android] Fixed a crash if `nil' would be passed into Java methods as
    char/byte/short/long/float/double/array type argument.
  * [Android] Fixed a bug where constants defined in modules that were mixed
    in couldn't be looked up.
  * [Android] Fixed Module#module_function to honor arguments.
  * [iOS] Fixed an issue where iOS Simulator cannot be launched with Xcode 7.3
    beta.
  * [iOS] Fixed an issue where some UI tests using the `tap' method could fail
    after a cold start-up of the iOS simulator.
  * [iOS] Fixed a bug where MIDIClientCreate() would trigger a crash on 32-bit.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug where exceptions raised from a Ruby
    file main scope would not be properly symbolicated.
  * [iOS, OSX, watchOS, tvOS] Fixed a bug where it wouldn't catch Objective-C
    exception which BigDecimal will raise.
  * [iOS, OSX, watchOS, tvOS] Fixed a memory leak in Object#instance_eval.
  * [iOS, OSX, watchOS, tvOS] Fixed a memory leak in Enumerable#zip.


= RubyMotion 4.8 =
  * [iOS, tvOS, watchOS] Added support for iOS 9.3, watchOS 2.2 and tvOS 9.2
    (beta). Latest Xcode is needed.
  * [iOS, OSX, tvOS, watchOS] Fixed an issue where certain vector types like
    'vector_float3' used in frameworks like SpriteKit, SceneKit and GameplayKit
    could not be used.
  * [iOS] Fixed a problem where ibtool would cause an error if extension and
    container app have storyboard files.
  * [watchOS] Fixed a bug where it would trigger a crash when it calls a method
    which takes with a block (like Array#each{|item| .... }).
  * [watchOS] Fixed a problem where it would fail to upload the app to iTunes
    Store.
  * [watchOS] Fixed a bug where it would return a broken value when the method
    or function returns a small structure (like NSRange or CGRect).
  * [android] Fixed a bug where armv5te binary would cause a crash for device.


= RubyMotion 4.7 =
  * Fixed a regression in where RubyMotion compiler causes a crash with
    `rake archive:distribution' if app has the unreachable local variables.
  * Fixed a bug in safe navigation operator which could not work as expected
    with block call.
  * [Android] Added Hash.[] (ex. `Hash[1,2,3,4]').
  * [Android] Fixed a bug where pure Java exceptions would not be catched in a
    "begin;rescue" block.
  * [watchOS] Fixed a bug where it could not deploy app into device.
  * [watchOS] Improve watchOS simulator launcher to be able to check exception
    message easily.
  * [tvOS] Fixed a bug where it will cause a crash if it would call the method
    which handle the CFType value.
  * [tvOS] Fixed an issue where distribution builds would not contain correct
    embedded bitcode.
  * [iOS, tvOS] Fixed a problem where it would fail launching application with
    "Simulator session started with error" message.
  * [iOS, OSX, tvOS, watchOS] Fixed a regression in where Dispatch.once did not
    work correctly with `rake archive:distribution'.
  * [iOS, OSX, tvOS, watchOS] Improved performance where creating Objective-C
    selectors internally. Ex, Object#{send, respond_to?} is now ~20% faster.
  * [iOS, OSX, tvOS, watchOS] Added to support Range object as argument in
    Kernel#rand and Random#rand for CRuby compatibility.
  * [iOS, OSX, tvOS, watchOS] Improved performance in where creating Time
    object by Time.{now, new}. ~30% faster.
  * [iOS, OSX, tvOS, watchOS] Improved performance in where generating Symbol
    object. Ex, String#to_sym is now ~10% faster.
  * [iOS, OSX, tvOS, watchOS] Improved performance in #length and #size method
    in Array/Hash/String. ~70% faster.
  * [iOS, OSX, tvOS, watchOS] Improved creating Range literal performance.
    ~40% faster.


= RubyMotion 4.6 =
  * The toolchain has been upgraded to LLVM 3.6 for all platforms.
  * Introduced safe navigation operator `&.' as experimental.
  * Fixed a bug where operator assignment (like `obj[idx] ||= expr') returns
    wrong result.
  * [iOS, OSX, tvOS, watchOS] Optimized recursive calling. 3 times faster.
  * [Android] Optimized the app executable size when a project has too many
    Ruby source files, by removing unnecessary internal code.
  * [Android] Updated Android NDK to android-ndk-r10e version. Please update
    the Android NDK toolchain by using `motion android-setup' command.
  * [Android] Fixed a bug in `motion android-setup' which couldn't update the
    NDK if `~/.rubymotion-android/ndk' existed.
  * [Android] Fixed a regression when creating non-Java and Enumerator objects.
  * [Android] Added the StandardError exception class.
  * [Android] Added Exception#message.
  * [Android] Fixed a bug where calling from Ruby code Ruby methods overriding
    Java methods would use the Java implementation of said method instead of
    the Ruby one.
  * [Android] Fixed a bug where certain Exception subclasses could not be
    properly instantiated and raised.
  * [Android] Fixed a bug in Object#send where the current block would not be
    propagated to the target method.
  * [Android] Fixed a bug where redefining a Ruby method in a class would not
    overwrite previous implementations of said method.
  * [Android] Fixed a bug where Java classes inheriting from templates
    (generics) would not be available in Ruby.
  * [Android] Apps now use the Material Design theme by default if targeting
    API 21 or newer.
  * [watchOS] Added support to embed bitcode.
  * [tvOS] Fixed a crash when an exception would be raised from the REPL.
  * [iOS, OSX, tvOS, watchOS] Fixed a bug where BigDecimal#to_s would return
    an unexpected string.
  * [iOS, OSX, tvOS, watchOS] Added `:' and `::' modifier in Time#strftime().
  * [iOS, OSX] Fixed a bug where it could not copy resource files properly from
    the resources directory if it contained `resources' as the directory name,
    like `resources-XXX'. Thanks to Hwee-Boon Yar for the patch (pull request
    #233).
  * [iOS] Fixed a bug where `rake spec:device' would not show the spec logs.
  * [OSX] Fixed a bug that caused apps built in release mode to be unable to
    rescue exceptions.
  * [tvOS] Fixed a bug where 3rd-party libraries could not be built.
  * [tvOS] Fixed a bug where some UIKit constants (ex.
    `UILayoutPriorityDefaultHigh') could not be used from Ruby.


= RubyMotion 4.5 =
  * [tvOS] Added device deployment support. Apple TV apps can now be deployed
    on your Apple TV and also be submitted to the App Store.
  * [iOS] Added support for iOS 9.2 (beta). Latest Xcode is needed. RubyMotion
    Starter now targets iOS 9.1 (stable).
  * [iOS] Fixed a bug where `XXXCreateXXX()' or `XXXCopyXXX()' APIs might
    cause a crash with double free.
  * [watchOS] Fixed a bug where device builds were not working.
  * [iOS, OSX] Fixed a bug where the `foo?' shortcut could not be used for
    `isFoo' if it accepted an argument.
  * [iOS, OSX] Fixed an error when generating dSYM files when the executable
    name contained a '%' character.
  * [iOS, OSX] Fixed an error when generating .bridgesupport compiler files
    when the process would abort when trying to increase the number of shell
    files that can be opened.
  * [Android] Added support for arm64-v8a / aarch64 (experimental).
  * [Android] Added Array#zip.
  * [Android] Added String#{ljust,rjust,center}.
  * [Android] Added Fixnum methods to java.lang.{Short,Long} objects.
  * [Android] Added Float methods to java.lang.Float objects.
  * [Android] Fixed Array.new to behave like CRuby.
  * [Android] Fixed a bug where the runtime would sometimes crash if a Java
    exception was raised.
  * [Android] Fixed a bug when the runtime would call the wrong Java method if
    it had multiple implementations and if the one that should have been called
    was accepting a Java string object.


= RubyMotion 4.4 =
  * [iOS, OSX] Improved the startup time of the compiler by 70% when using a
    deployment target much older than the SDK version, by only loading
    BridgeSupport files for that SDK version.
  * [iOS] Fixed a problem where watchOS 1.0 apps could not be installed on an
    Apple Watch device.
  * [iOS] Fixed a bug where line numbers were not properly symbolicated in
    exceptions raised in an iOS 9 app.
  * [iOS] Silenced a warning when starting the simulator with Xcode 7.
  * [Android] Added Proc.new.
  * [Android] Added Numeric#{pred,succ,next}.
  * [Android] Added Module#define_method.
  * [Android] Added Time#strftime.
  * [Android] Set the last expression evaluated in the REPL as the `_'
    local variable.
  * [Android] Fixed a bug where sending `==' to nil could cause a VM crash.
  * [Android] Fixed a bug in `String#to_i' when `-1' would be returned instead
    of large numbers (Bignum).
  * [Android] Fixed a bug where certain builtin selectors (ex. `#===' or `#~=')
    would crash the REPL.
  * [Android] Fixed a bug where calling a block that has variadic arguments
    (ex. `lambda { |*a| ... }') could cause a runtime crash.


= RubyMotion 4.3 =
  * Dropped support for OSX 10.8 as development environment.  Please use OSX
    10.9 or higher.
  * [iOS, OSX] Solved an issue where certain constants in the enums
    NSLayoutPriority* and UILayoutPriority* could not be used.
  * [iOS, OSX] Solved a bug introduced in version 4.1 where an array would not
    correctly return its contents when called from Objective-C in some cases.
    This manifested in UIView#addConstraints not adding certain constraints.
  * [iOS, OSX] Fixed a problem which it would raise an exception in generating
    BridgeSupport file for 3rd-party library.
    The exception is "Received exception: addFile: Couldn't lookup file: ...".
  * [iOS] Fixed a bug where watchkit apps would have an incorrect identifier.
  * [OSX] Using the OSX 10.11 SDK requires running on OSX 10.11. An error will
    be printed if you try to use it in OSX 10.10 or lower.
  * [Android] Fixed a crash that would happen when trying to access a local
    variable that was created from the value of another local variable whose
    value changed after.


= RubyMotion 4.2 =
  * [iOS] Fixed a regression which cannot use UIInterfaceOrientationIsLandscape
    in iOS 8.2 or below.
  * [OSX] Make code signing to all embedded frameworks. Thanks to digitalMoksha
    for the patch (pull request #232).
  * [Android] Added support for API 23 final (and removed MNC version).


= RubyMotion 4.1 =
  * [tvOS] Added initial support for Apple TV (simulator only). To create a new
    tvOS app, run 'motion create mytvapp --template=tvos'. (Xcode 7.1 is
    required).
  * [iOS, OSX] Improved iOS 9 and OS X 10.11 support by fixing some wrong data
    types in BridgeSupport.
  * [iOS, OSX] Fixed a problem which would cause duplicated symbols error when
    using Flurry sdk.
  * [iOS, OSX] Improved performance when converting Ruby Array to NSArray
    object. ~20% faster.
  * [iOS, OSX] Improved performance in Array#{flatten, uniq, &}.
  * [iOS] Fixed a problem where it cannot pass Array object as WeakRef into
    NSArray.arrayWithArray argument with iOS 9.
  * [iOS] Fixed a problem where it couldnt launch Instruments.app with Xcode 7
    with `rake profile'.
  * [iOS] Fixed a problem which it couldnt upload app which was built with
    Xcode 7 to iTunes store.
  * [Android] Fixed a bug where String object could not be used as argument for
    Object#{instance_variable_get, instance_variable_set,
    instance_variable_defined?} and Module#{attr, attr_accessor, attr_reader,
    attr_writer}.
  * [Android] Fixed a regression where assigning values to dynamic (block)
    variables could lead to a runtime Java VM crash.
  * [Android] Fixed a bug which String#gsub will trigger a crash when regular
    expression would not be matched.
  * [Android] Fixed a bug which Array#[start, length]= would trigger a crash
    when it will erase many elements in receiver object.
  * [Android] Added Module#const_set.
  * [Android] Added Symbol#{id2name, intern, empty?, match, <=>, casecmp,
    upcase, downcase, swapcase, capitalize, []}.


= RubyMotion 4.0 =
  * Support for watchOS 2.0 (beta). Apple Watch apps can now use native APIs.
    To create a new watchOS app run `motion create my_watch_app
    --template=ios-watch-app'. Then configure your iOS application by adding:
    `app.target 'path/to/MyWatchOS2App', :watchapp`
  * Fixed a bug where `motion' command would cause an error with Ruby 1.8 which
    is bundled in OS X 10.8.
  * Improved `motion create' to automatically load templates from RubyMotion
    gems. For this to happen, the gem has to provide a value for the
    `rubymotion_template_dir' spec metadata key, which should be the name of
    the directory (relative to the gem) where the templates are located.
  * [iOS] Fixed a problem where codesigning would fail on a shared framework
    when using  `rake device' with Xcode 7.
  * [iOS] Fixed a problem where a crash would happen when using a framework
    added in iOS 9.
  * [OSX] Fixed a problem where framework depencencies would not be properly
    built when compiling an app for OS X 10.11.
  * [iOS, OSX] Improved iOS 9 and OS X 10.11 support for APIs with a updated
    version of the BridgeSupport files generator.
  * [iOS, OSX] Fixed a bug which `begin/rescue' syntax would trigger a crash
    in distributed app.
  * [Android] Fixes an issue when subclassing a nested Java class.
  * [Android] Fixed a regression which would trigger a crash when calling
    certain methods with a block.


= RubyMotion 3.14 =
  * [iOS] Improved iOS 9 ARM64 support.
  * [iOS] Fixed a problem where apps could not compile/link for iOS 9.
  * [iOS] Fixed a problem where `rake debug=1' could not launch the debugger
    with Xcode 7.
  * [iOS, OSX] Fixed a bug where it would cause `Permission denied' error if
    resource files have read-only permission only when they will be copied into
    app bundle.
  * [Android] Added support for `def' expressions in the REPL.
  * [Android] Fixed build when `--trace' is passed to Rake.
  * [Android] Fixed a bug where passing blocks to methods in a loop could
    overflow the Android VM with too many global references.


= RubyMotion 3.13 =
  * [iOS, OSX] Added support for iOS 9 and OS X 10.11 (experimental). To
    target these, you will need Xcode 7 (beta). NOTE: If you can't launch your
    app on a device running iOS 9, manually trust your certificate by going to
    Settings > General > Profiles and selecting your certificate. Also, arm64
    is not supported with Xcode 7 at this point, so you will have to remove it
    from app.archs['iPhoneOS'] when doing device builds.
  * [iOS, OSX] Fixed a bug where certain C structures could not be passed to a
    Ruby block from Objective-C code.
  * [iOS, OSX] Fixed a bug where broken value would be received when a
    Objective-C method returns a small structure on i386 architecture.
  * [iOS] Updated Watchkit templates. If your watch app crashes on launch, try
    replacing the "initWithContext" methods with "awakeWithContext".
  * [Android] Improved compilation time by introduced parallel compiling for
    Java files and faster compiling (like iOS/OS X).
  * [Android] Fixed a bug where Time#- would not return value with millisecond
    precision.
  * [Android] Added Time#to_f.


= RubyMotion 3.12 =
  * [Android] Added support for Android M (experimental). To target it, set
    `app.api_version' to `MNC'.
  * [Android] Improved Object#raise to accept an exception class or instance.
  * [Android, iOS, OSX] Introduced a new experimental file dependency resolver.
    If you have any file dependency manually specified in the Rakefile, the new
    resolver should make those unnecessary. To try it, set the environmental
    variable "experimental_dependency" (e.g. 'rake experimental_dependency=1').
    The new resolver will become the default in a future release.
  * [iOS] Fixed "duplicate symbol" error when it would build app for iOS device
    using Xcode 6.2.
  * [iOS] Fixed a bug where the latest version of the Facebook iOS SDK would
    not compile correctly.
  * [iOS, OSX] Improved compilation time for projects that have many source
    files. 2~ times faster.


= RubyMotion 3.11 =
  * [iOS] Fixed a bug which UIInterfaceOrientation would cause link error when
    specify iOS 8.2 or below as deployment target.
  * [iOS, OSX] Improved floating precision for 64-bit environment.
  * [iOS] Fixed a regression where the exception could not be handled on i386
    iOS simulator.
  * [iOS] Fixed a bug where watch apps could be rejected with iTunes Connect.
    Thanks to digitalfx for the patch (pull request #213 and #214).
  * [iOS] Fixed a bug where watch apps could not installed to iPad devices.
    Thanks to digitalfx for the patch (pull request #215).
  * [iOS] Fixed a bug where watch apps were not able to localize.
  * [iOS, OSX] Fixed a bug where some GLKit structures could not be created.
  * [iOS] Fixed a bug where some GLKit structures could not be created.
  * [iOS] Added support for enterprise certificate profiles. Thanks James
    Daniels for the patch. (pull request #64)
  * [iOS, OSX] Fixed a crash when generating ctags.
  * [iOS, OSX] Fixed a bug where it could not pass a pointer of structure into
    into Ruby Block from Objective-C.
  * [OSX] Fixed a bug where GLKit inline functions could not be used on OS X.
  * [Android] Added Kernel#{block_given?,iterator?}.
  * [Android] Added Integer#upto.
  * [Android] Ruby arrays are now converted to the correct primitive Java array
    type when passed as an argument to a Java method in Android 5.0.
  * [Android] Fixed a bug where refering to the current exception in a rescue
    block would trigger a crash at runtime.
  * [Android] Fixed a bug in the REPL where Java package paths could not be
    properly evaluated.
  * [Android] Fixed a bug where Java classes could not be re-opened.
  * [Android] Fixed a bug where classes defined inside modules would not be
    exposed to Java. Caveat: the module must be provided when declaring the
    class (ex. `class MyModule::MyActivity < Android::App::Activity').
  * [Android] Fixed a bug where the compiler would emit Java method definitions
    for methods defined in classes not present in the current class' super
    class chain.
  * [Android] Fixed a bug where app.vendor_project with `:native' pointing to
    an array of paths for different architecture libraries would not work.


= RubyMotion 3.10 =
  * [Android] Fixed typo in android.rb template which breaks incremental builds.
    Thanks to Darin Wilson for the patch (pull request #210).
  * [Android] Fixed `rake {emulator,device} debug=1' for multi-arch projects.
  * [Android] Added Module#const_get.
  * [Android] Fixed a bug where calling a Java method that returned a large
    non-Object Java array would crash the runtime by creating a JVM stack
    overflow.
  * [Android] Fixed a bug when calling the super version of a Java method,
    where it would fail if the current stack trace included a super Java call
    of the same method name but of a different class.
  * [Android] Fixed a bug where #initialize methods would not be honored when
    defined in superclasses.
  * [Android] Fixed a bug where an assertion would happen when trying to
    resolve a Java class at runtime.
  * [Android] Fixed a bug where a crash would happen when changing the value
    of a local variable that previously contained a reference to a constant
    literal (ex. symbol).
  * [iOS] Added support for iOS 8.4 (beta).
  * [iOS] Fixed a wrong in Watch app templete which notification handler should
    invoke `call' method for Proc handler object. Thanks to Dave Shapiro for
    the patch (pull request #207).
  * [iOS] Fixed a bug which it would be trigger a crash when large structures
    (like CMTime) will be passed into Objective-C methods/funtions on ARM64.
  * [iOS] Fixed a bug which it would be trigger a crash when it will call
    NSDecimalNumber#decimalValue method on ARM64.
  * [iOS] Fixed a bug which UIInterfaceOrientation would cause link error when
    specify iOS 8.2 or below as deployment target.
  * [iOS, OSX] Fixed a bug where small structures with only float members could
    not be passed/returned in a 64-bit environment.


= RubyMotion 3.9 =
  * [Android] Projects now support multiple architectures. The `app.arch'
    variable is replaced by `app.archs' which takes an array of architectures.
    By default, we still build for arm 32-bit only.
  * [Android] Added x86 (Intel 32-bit) support. This is mainly used to run
    apps in faster emulators (such as Genymotion). To build for x86, simply
    edit your project's Rakefile to add the architecture (app.archs << 'x86').
  * [Android] Added the `app.optional_features' to let users specify optional
    features in the manifest file.
  * [Android] Make sure all Ruby file paths are flattened into single Array.
    Thanks to Darin Wilson for the patch (pull request #189).
  * [iOS, OSX] The Ruby runtimes have been rebuilt with Xcode 6.3 final.
  * [iOS] Fixed ARM64 issues introduced since Xcode 6.3 final.
  * [iOS] Fixed a bug where the REPL would crash when using an old simulator.
  * [iOS] Fixed a bug where the value of `app.version' and `app.short_version'
    between the container and watch apps were not synchronized when submitting
    to iTunes Connect. Thanks to digitalfx for the patch (pull request #205).
  * [iOS] Fixed a bug where watch apps could not be submitted to iTunes Connect.
  * [iOS] Fixed a bug where satch apps would not follow the deployment target
    of the host app.
  * [iOS] Fixed a bug where `rake watch' would not launch the watch app when
    using Xcode 6.3 stable.
  * [iOS] Fixed a bug where dSYM files were embeded even if the app was built
    with release mode if app has extensions.
  * [OSX] Fixed a bug where app would crash when running tests if the UIDevice
    class is defined.
  * [iOS, OSX] Fixed a bug where small structures with only float members could
    not be passed/returned in a 64-bit environment.


= RubyMotion 3.8 =
  * The toolchain has been upgrated to LLVM 3.5.
  * [Android] Added the `motion android-setup' command which downloads and
    installs the Android SDK and NDK automatically. Run the
    `motion android-setup --help' command for more information.
  * [Android] Added 'app.support_libraries' option in the Rakefile, which is an
    array containing the names of Android support libraries to be included in
    your app E.g.:
      app.support_libraries << 'google-play-services'
      app.support_libraries << 'android-support-v4'
  * [Android] Added support for API level 22. Removed support for very old
    versions of Android that are no longer supported in the SDK.
  * [Android] Added support to generate Ctags file via the `rake ctags' task.
  * [Android] Fixed a bug where classes.dex would not be re-generated when a
    resource file was changed. Thanks Eito Katagiri for the patch.
  * [Android] Fixed a bug where running specs would crash.
  * [iOS] Fix a bug where a build error would happen when building a project
    for ARM 64-bit using Xcode 6.3 Beta.
  * [iOS, OSX] Fixed the build system to not recompile `.strings' files on
    every build.
  * [iOS, OSX] Fixed a bug where `rake profile' could not launch Instruments.app
    when it will specify Instruments template with Xcode 6.2.
  * [iOS] Fixed a bug where `rake background_fetch=true' would not work with
    with Xcode 6.2.
  * [iOS, OSX] Fixed the build system to print a warning if a framework included
    in the Rakefile does not have a corresponding .bridgesupport file (e.g. it
    has been mispelled).
  * [iOS, OSX] Fixed the build system to not delete '.storyboardc' files if the
    corresponding '.storyboard' file does not exist.
  * [iOS, OSX] Fixed a rare case where gdb would be used instead of LLDB when
    running in debug mode.


= RubyMotion 3.7 =
  * Fixed a bug where the `motion' command would not work as expected if Ruby
    was installed with rbenv/RVM.
  * [iOS] Fix a bug where the build system would not detect the properties of
    the running simulator if it existed with a different version of iOS.
  * [iOS] Fixed a bug where a WatchKit app would not launch on the simulator
    if it was built with x86_64 (64-bit Intel) only.
  * [iOS, OSX] Improved the symbolication of exception backtraces. Backtraces
    are now properly symbolicated when running on the device. This is done by
    parsing the dSYM bundle at runtime. For this to work, in development mode,
    the dSYM will be embedded within the application bundle. (This is disabled
    in release mode). You can control this setting with the `app.embed_dsym'
    variable in the project's Rakefile.
  * [iOS, OSX] Improved performance when creating empty Hash objects.
    ~2 times faster.
  * [iOS, OSX] Improved performance when creating very small Array objects.
    ~30% faster.
  * [iOS, OSX] Bridgesupport files for vendor projects are now generated in the
    common build directory (~/Library/Rubymotion/build). This fixes a problem
    when vendoring the Reveal framework.
  * [iOS, OSX] Added a feature to disable capturing view (command key + moving
    mouse over) in iOS simulator or OS X app. To enable/disable capturing view,
    run `enable_capture' or `disable_capture' commands in REPL. If you want to
    disable capturing before the application is launched, you can set the
    DISABLE_CAPTURE environment variable when you will run the `rake' command.
    (ex. `$ rake DISABLE_CAPTURE=1').
  * [Android] The runtime is now using the GNU C++ stdlib for better internal
    support and also upcoming new features.
  * [Android] Improved compilation time, compiling multiple files in parallel.
  * [Android] Support for defining manual file dependencies via
    'app.files_dependencies'.
  * [Android] Added Module#module_function.
  * [Android] Added Symbol#to_sym.
  * [Android] Added Time#usec.
  * [Android] Object#send now accepts strings.
  * [Android] Improved Kernel#rand to accept ranges (of fixnums and floats).
  * [Android] Fixed a bug where undefined local variables or methods returned
    false instead of raising an exception.
  * [Android] Fixed a bug where Java getter/setter shortcuts would sometimes
    not work.
  * [Android] Fixed a bug where a crash would happen when running a spec with
    a lot of test cases.
  * [Android] Fixed memory leaks when symbolicating an exception backtrace.


= RubyMotion 3.6 =
  * [iOS] Added support for iOS 8.3. Xcode 6.3 beta is required.
  * [iOS, OSX] Fixed a bug where the build would fail when using Xcode 5.
  * [iOS] Fixed a bug where WatchKit applications could not be launched with
    Xcode 6.2 beta 5.
  * [iOS] Fixed a bug where device log wouldn't be displayed with `rake device'
    if `CFBundleName' property was changed.
  * [Android] Improved the build time of projects, by not compiling the
    internal bitcode of Ruby files that have not changed.
  * [Android] Added Math module.
  * [Android] Added Time#{+, -}.
  * [Android] Added Hash#{default, default=, default_proc, default_proc=}.
  * [Android] Added String#{[]=, slice!, chop, chop!, chomp, chomp!, sub, sub!,
    gsub, gsub!, split}.
  * [Android] Improved Float#to_s, String#[], Array#{[]=, values_at} for CRuby
    compatibility.
  * [Android] Improved Hash#{shift, replace} for CRuby compatibility.
  * [Android] Fixed a build error in a Bundler environment.
  * [Android] Fixed a bug where Array#[] would crash when returning a large
    array.
  * [Android] Fixed a bug where Array#delete would crash when removing a lot of
    elements.
  * [Android] Fixed a bug where Array#[start, length]= would crash when
    providing a large start position.
  * [Android] Fixed a bug where Array#pop(number) would crash when specifying
    a large number.
  * [Android] Fixed a bug where Array#flatten would crash when used on a large
    array.
  * [Android] Fixed a bug where String#scan would crash if many elements would
    be matched.
  * [Android] Fixed a bug where String#scan returned the wrong value if the
    Regexp group would be passed as argument.
  * [Android] Fixed a bug where attempting to retrieve a Java field on an
    inner Java class would always return null/zero on Android 21 / ART,
    apparently due to a JNI regression (we added a workaround).


= RubyMotion 3.5 =
  * [iOS, OSX] Fixed a regression introduced by the previous release where the
    REPL would not work.


= RubyMotion 3.4 =
  * [iOS] Fixed a bug where iOS 8 extensions and their host app could not have
    different deployment_target values.
  * [iOS] Fixed a bug where an incorrect architecture would be chosen when
    debugging on a device. Now defaults to the device architecture.
  * [iOS, OSX] Fixed a bug where small structure types couldn't be returned
    from Objective-C methods in 64-bit.
  * [Android] Added Bundler support to the project template.
  * [Android] Added the `app.theme' Rakefile variable to set up the theme of
    the app. The default value is `Theme.Holo'.
  * [Android] Added Array#{flatten, flatten!, slice, slice!}.
  * [Android] Added Enumerable#{reverse_each, each_with_object, each_entry,
    each_slice, each_cons, collect, map, count, find, detect, grep, find_index,
    flat_map, collect_concat, partition, group_by, first, all?, any?, one?,
    none?, min, max, minmax, min_by, max_by, minmax_by, member?, include?}.
  * [Android] Improved Array#[] for CRuby compatibility.
  * [Android] Disabled internal/debug VM logs since they impact launch time and
    general performance. If you want to set them back on (for debugging), the
    `app.vm_debug_logs' variable can be set to `true'.
  * [Android] Fixed a bug where Fixnum#* would cause a runtime crash if the
    receiver was zero.
  * [Android] Fixed a bug where an `ensure' statement would cause the project
    to fail to build, due to a linking error.
  * [Android] Fixed a bug in the Java method dispatcher where it would fail
    to call methods returning arrays of non-object types (ex. the `getBytes'
    method of java.lang.String).
  * [Android] Fixed a bug where trying to set/assign a value to a Java object
    field would cause a NoMethodError.
  * [Android] Fixed Enumerable#{each_with_index, select} to return an Enumerator
    when if no block is given.
  * [Android] Fixed a bug where Enumerable methods would be taken in priority
    over Hash methods (ex. `select'), due to the fact that the module was
    included in the wrong class.
  * [Android] Fixed a bug where the use of the `break' keyword inside a block
    would cause a compilation crash.
  * [Android] Fixed a bug in the spec framework where the `main_activity'
    helper method would only work as expected in the first spec file, and
    return nil in other spec files.


= RubyMotion 3.3 =
  * [iOS] Fixed a bug where a WatchKit application could be launched on an iOS
    8.1 simulator, which does not actually support WatchKit and would crash.
  * [iOS] Fixed a bug where the compiler would no longer emit proper DWARF
    metadata for ARM64 due to an Xcode / clang change.
  * [iOS] Print an informative error when no simulator devices are configured.
  * [iOS, OSX] Fixed a bug where the #== method in a pure Ruby object would
    not resolve WeakRef operands.
  * [iOS, OSX] Fixed a bug where small structure cannot be passed into
    Objective-C funcitons with 64-bit app.
  * [iOS, OSX] Fixed a bug where the #kind_of? method in an ImmediateRef would
    not compare against the reference object's class.
  * [iOS, OSX] Fixed a memory leak in Array#{uniq, uniq!, compact, compact!,
    select, select!, keep_if}.
  * [iOS] Fixed a bug where it would trigger a crash when Ruby method which has
    5 or more arguments will be called from Objective-C code in arm64 device.
  * [OSX] Updated Edit menu to include items generated by Xcode. Thanks to
    Hwee-Boon Yar for the patch (pull request #187).
  * [Android] Introduced app.manifest, which makes it possible to directly
    manipulate the contents of the AndroidManifest.xml file from the Rakefile.
    Read the documentation in the "Providing Custom Values" section of the
    Android Project Management guide on the Rubymotion website. Thanks to
    Daniel Brooker for the patch.
  * [Android] Added String#{[], slice}.
  * [Android] Fixed a bug where projects with an XML file in the 'resources'
    directory would not compile correctly.
  * [Android] Fixed a bug where Object#instance_eval would crash when targeting
    old versions of Android (below 14).
  * [Android] Fixed a bug where Ruby methods and blocks where limited by the
    number of arguments they could accept.
  * [Android] Fixed a bug where Hash would not include Enumerable.
  * [Android] Fixed a bug where Ruby Hash methods (ex. #[]) would not be
    available on Java *Map objects.
  * [Android] Fixed a bug where Hash objects with a default Proc (ex. created
    with `Hash.new {}') would not dispatch the Proc when a key isn't found.
  * [Android] Fixed a bug where Ruby String methods were not available on
    java.lang.String objects.
  * [Android] Fixed a bug where passing java.lang.String objects to Ruby
    String methods expecting String arguments would cause a runtime crash.


= RubyMotion 3.2 =
  * [iOS] Fixed a bug where RubyMotion frameworks could not be loaded due to
    required RubyMotion symbols being stripped from application/extension.
  * [iOS] Pick-up new certificates prefixed with `iOS` instead of `iPhone`.
  * [iOS] Fixed a bug where WatchKit applications did not honor `xcode_dir`.
  * [iOS] Fixed a bug where it couldn't debug with `rake device debug=1' on
    device. Now, debugging only support `armv7' in `app.archs['iPhoneOS']'.
    (i.e. app.archs['iPhoneOS'] = ['armv7'])
  * [iOS] Fixed a bug where it could not deploy app to iOS 8.2 beta 3 device.
  * [iOS] Fixed a bug where it could not deploy app which contained Watch app.
  * [OSX] Fixed a bug where NSString#initWithXXX would trigger a crash by double
    free.
  * [iOS, OSX] Fixed a bug where the view object wouldn't be released when it
    was created by #init(arg) and super() method.
  * [iOS, OSX] Fixed a bug where `nil.isEqual(nil)' would not return `true'.
    was created by #init(arg) and super() method.
  * [iOS, OSX] Fixed a memory leak when invoking blocks with Dispatch::Queue.
  * [iOS, OSX] Fixed a bug where Marshal.dump would trigger a crash.
  * [Android] Added Bignum#{+@,-@,%,modulo,&,|,^,~,<<,>>,<,<=,>,>=,<=>,abs,
    to_i,to_int,to_f}.
  * [Android] Added Time#{to_s, to_i, inspect, <, <=, >, >=, <=>, ==, !=} and
    Time.at.
  * [Android] Improved Fixnum#{%, <=>, &, |, ^, <<, >>} to take a Bignum in
    argument.
  * [Android] Fixed a bug where gen_bridge_metadata would not detect classes
    that implement interfaces.
  * [Android] Fixed a bug where gen_bridge_metadata would not work if the user
    had java 8.0 installed (`javap' was emitting unrecognized syntax). Thanks
    to "Theo" for the detective work and the patch.
  * [Android] Fixed a bug where gen_bridge_metadata would emit template
    information in class/interface names, which would then break the compiler.
  * [Android] Fixed a bug where gen_bridge_metadata would fail to emit proper
    list of methods for a class that had a static initializer.
  * [Android] Added the `:native' parameter for `app.vendor_project' which can
    be used to specify a 3rd-party shared library to include in the app.
    Thanks to René Köcher for the patch.
  * [Android] Fixed the extra-packages argument to work with multiple packages.
    Thanks to Tom Carey for the patch (pull request #185).


= RubyMotion 3.1 =
  * [iOS] Fixed an API validation error when submitting an application that
    contains an extension.
  * [iOS] Fixed a regression that made it impossible to set environment
    variables from a host application and propagate them to extensions.
  * [iOS] Fixed a regression that made extensions crash at startup.
  * [iOS] Fixed a regression where a Info.plist file would be generated
    with wrong details for Background Fetch.
  * [iOS] Fixed a bug where `rake background_fetch=1' for background fetch
    would not work with Xcode 6.x.
  * [Android] Added Fixnum#{~,&,|,^,<<,>>,+@,integer?,odd?,even?}.
  * [Android] Added Float#+@.
  * [Android] Added Bignum#integer?.
  * [Android] Fixed Fixnum#times to return an Enumerator when no block is given.


= RubyMotion 3.0 (Dec 2014) =
  * [Android] RubyMotion for Android support has been merged. Please refer to
    the pre-release NEWS file for past changes, and check out our developer
    guides for more information about this new platform support.
  * [iOS] Added support for WatchKit applications.
    Add a target to your iOS application by creating a WatchKit project with the
    command: `$ motion create MyWatchApp --template=ios-watch-extension` and
    then configure your iOS application by adding:
    `app.target 'path/to/MyWatchApp', :extension`
    Then from the root of your iOS application, *not* the WatchKit application,
    invoke `$ rake watch` to build your iOS and WatchKit applications and launch
    the WatchKit application on the simulator.
    Additional launch options are `type=glance` for Glance applications,
    `type=notification payload=path/to/payload.json` for Notification
    applications, and `display=regular` or `display=compact` to launch the 42mm
    or 38mm Watch displays respectively.
  * [iOS] Added support for specifying launch images from asset catalogs.
  * Added support for iOS 8.2 (beta). You will need to install an Xcode 6.2
    beta to support it.
  * [iOS] Fix `rake crashlog:device' crash report symbolication.
  * [iOS] Fixed a bug where Bundler wouldn't be used when it will build
    Extensions and Frameworks.
  * [iOS] Create a `UIViewController`, `UINavigationController`, and `UIWindow`
    in the default new application template.
  * [OSX] Only build for 64-bit (`x86_64`) by default.
  * [iOS] Enabled arm64 support by default for iOS projects.
  * [iOS] Honour explicit `device_name` or `target` specified by user.
    Specifying both is disallowed, because a device is configured for a
    specific SDK.
  * [iOS] Fixed a regression where Extension and Frameworks could not build for
    the iOS device platform.
  * [iOS] Fixed a bug where `rake spec' would return 0 as exit code even if it
    failed due to a crash.
  * [iOS] Fixed a bug in `rake spec' where #tap and #rotate_device were
    causing a crash when ran in 64-bit mode (simulator).
  * [iOS] Fixed a bug where all rake task could not be run under the root
    directory of Extension or Framework, preventing CocoaPods libraries to be
    installed properly.
  * [iOS] Fixed a bug where shared frameworks would not be built for 64-bit.
  * [iOS] Fixed a bug where it was not possible to customize the Action and
    Share extension's icon. The `app.icons' property can now be set in the
    extension's Rakefile.
  * [iOS] Fixed a bug where extensions could not be built if Bundler was not
    installed due to a Pathname dependency.
  * [iOS] Added launch images for iPhone 6 and iPhone 6 Plus. Thanks to
    Hwee-Boon Yar for the patch (pull request #170).
  * [iOS] Fixed the "ERROR ITMS-9000" error when trying to submit an app that
    contained extensions. Thanks to Hwee-Boon Yar for patch.
  * [iOS] Fixed a bug where the relative path cannot be used in
    `app.provisioning_profile'.
  * [iOS] Fixed a bug where iPad simulator would not launch app as 64-bit even
    if app contains 64-bit binary. Changed default simulator to `iPad Air'.
  * Fixed a regression where a link error would be caused in Xcode when trying
    to use a static library which was generated by `rake static'.
  * Fixed a bug where the wrong Boxed object would be returned from an
    Objective-C method.
  * Fixed the `motion support' command invocation to print both the stable and
    pre-release versions of RubyMotion.
  * Fixed a bug where a "Symbol not found" exception would be triggered when
    trying to use a constant which was not defined in an older SDK version.
  * Fixed a bug which it would not solve framework dependencies in embedded
    frameworks.
  * Fixed a memory leak when invoking blocks passed to Dispatch::Queue.
  * Fixed a bug where `rake profile' could not launch Instruments.app when
    being given the Instruments template with Xcode 6.2 Beta.


= RubyMotion 2.38 =
  * Optimized the app executable size when a project has too many Ruby source
    files, by removing unnecessary internal code. ~30-60% lighter.
  * Disabled armv7s support for iOS projects. If you want to add armv7s support
    back, simply add the 'armv7s' value to the `app.archs['iPhoneOS']' config
    in the project's Rakefile. This architecture is no longer enabled by
    default in Xcode.
  * Fixed a bug where a compiled Core Data model would be removed when cleaning
    when an original `xcdatamodeld' was not available.
  * Fixed a bug where in certain circumstances cleaning would try to be
    performed when the vendor dir, e.g. `vendor/Pods' did not exist.
  * Fixed a few cases where the Yosemite version number was parsed incorrectly.
  * Added support for `axel' as an alternative to `curl' when downloading
    updates, which supports resuming and uses 10 connections to improve speed.
    Axel is available from http://wilmer.gaast.net/main.php/axel.html or can be
    installed through Homebrew: `$ brew install axel'.
  * Fixed a regression where `rake spec' did not work on OS X platform.
  * Fixed a bug where Dispatch.once did not work correctly with x86_64 on
    iPhone simulator and i386 on OS X platforms.
  * Fixed a bug where `:cflags' for `:static' vendored projects could not
    override those set by the toolchain by default. E.g. `-fno-modules'.
  * Fixed the `motion --version' command invocation to print both the stable
    and pre-release versions of RubyMotion.
  * [OSX] Fixed a bug where embedded frameworks would not be codesigned as per
    the current requirements for the App Store.
  * [iOS] Removed `Symbols not found...' message when app will be deployed into
    iOS device if Xcode dumped device symbols into user directory.
  * [iOS] Fixed a bug which it could not recognized Provisioning Profile which
    is generated with "iOSTeam Provisioning Profile".
  * [OSX] Fixed a bug where BigDecimal#inspect would return invalid string on
    Yosemite.


= RubyMotion 2.37 =
  * Fixed a regression where Dispatch.once did not work correctly when it was
    invoked in some points.
  * Fixed a bug where the compiler would crash with an assertion message
    `[BUG] Object: SubtypeUntil ...' when compiling certain Ruby files.
  * Fixed a bug in the compiler when compiling for ARM64 where certain types
    would still be emitted with a 32-bit architecture in mind.
  * Fixed a bug in the compiler when compiling for ARM64 where certain structs
    would not be properly available (such as NSDecimal).


= RubyMotion 2.36 =
  * Added ARM64 support (64-bit) for iOS. It is not yet enabled by default for
    applications that do not embed Frameworks or App Extensions. In order to
    enable it on other builds add the following line to your project's Rakefile:
    app.archs['iPhoneOS'] |= ['arm64']
  * iOS 4.3 and OS X 10.7 are no longer supported, due to internal changes
    that require us to use a newer C++ standard library.
  * [iOS] Fixed a bug where the `app.provisioning_profile' setting would not be
    configurable in the Rakefile of App Extensions projects.
  * Fixed a bug when copying an `ImmediateRef', which isn't needed anyways,
    because a tagged pointer can not be duplicated either.
  * Fixed a bug where Xcode 6 would cache precompiled headers in a
    hidden location and subsequent vendored builds could fail after cleaning.
  * Fixed a bug where a failed vendored build could cause subsequent builds to
    never actually start.
  * Fixed the build system to remove Xcode 6 noise from vendored build output.
  * Fixed a bug where the #supportedInterfaceOrientations method would be not
    properly included.
  * Fixed a race condition bug in the runtime where a crash would occur if
    the same Objective-C constant was being resolved at the same time from
    different threads.
  * Fixed the `motion changelog' command to honor the `--pre' flag, which will
    open the pre-release NEWS file instead.
  * Fixed the `motion update --pre' command to print a reference to the
    `motion changelog --pre' command.
  * Improved IO#.read performance to read from files. ~4 times faster.


= RubyMotion 2.35 =
  * Added support for iOS 8.1 (beta). You will need to install Xcode 6.1 GM
    Seed in order to target it.
  * Fixed a bug that could occur when the only available SDKs are newer than the
    available BridgeSupport metadata.
  * [iOS] Fixed a bug where it would not symbolicate with `rake profile:device`.
    The dSYM file path was changed to fix a bug.
  * [iOS] Fixed a bug where the RubyMotion shared framework would not update
    even if it changed the code in framework.
  * [OSX] Fixed a bug that would always cause the REPL to crash.
  * Fixed a bug where GLKit functions would trigger a crash when it will run
    app on iOS simulator.


= RubyMotion 2.34 =
  * All iOS and OS X versions of the runtime have been recompiled with Xcode 6.
  * [iOS] Add support for iPhone 6/6+ launch images. Unless explicitly
    specified, the Info.plist `UILaunchImages' key is populated from all PNG
    files in the resource directories that start with Default. For iPhone 6/6+
    use the `-667h' and `-736h' filename modifiers.
  * [OSX] Fix a bug that made it impossible to build a OS X app on Yosemite
    with Xcode 6 GM, even when targeting 10.9.
  * Fixed a bug that ommitted class and protocol methods from the ctags.
    Patch by Rakesh BS.
  * Improved exception backtrace symbolication performance by ensuring the dSYM
    bundle is used when available.
  * Improved Enumerable#inject performance. ~40% times faster.
  * Fixed a bug that could cause `clang++' to be called with too many arguments
    for a shell to handle.
  * Fixed a bug that could cause `gen_bridge_metadata' to be called with too
    many arguments for a shell (on Yosemite) to handle.
  * [OSX] Fixed a bug that made it impossible to use a `NSApplication' subclass.
  * [OSX] Fixed a bug where it would trigger a crash when it will evaluates a
    expression on REPL on Yosemite.
  * [OSX] Fixed a bug where the build directory for 3rd-party library wouldn't
    be removed with `rake clean' command.
  * [OSX] Fixed a bug where it didn't handle `NSTaggedPointerString' objects
    when it configured lower OS X version as deployment target on Yosemite.
  * [OSX] Fixed a bug where `rake debug=1' freezes lldb with Xcode 6 GM.
  * [iOS] Changed default simulator to 'iPhone 6' which it would be introduced
    by Xcode 6 GM.
  * Fixed a bug where Instruments didn't launch if it would specify a template
    name with "rake profile template='xxx'".
  * Fixed a bug where Method#owner will return incorrect owner if the method
    in inherited class would be overrided.
  * Fixed a bug where wrong method would called when it would include module
    which have #viewWillAppear and #viewWillDisappear implementations.
  * Fixed a bug where method would not called when it would include some module
    which have #viewWillAppear implementations.
  * Fixed a bug where #method_missing would receive incorrect arguments after
    calling was cached.
  * Fixed a bug where the build system would ping the update server for each
    target an application project includes.
  * Fixed a memory leak which was created when huge splat would be passed into
    the methods since second argument.
  * Improved Regexp.last_match performance. ~20% faster.


= RubyMotion 2.33 =
  * Added support for installing pre-releases of RubyMotion. The
    `sudo motion update --pre' command will install a pre-release build in
    `/Library/RubyMotionPre'. Currently, the pre-release channel contains
    the first beta of RubyMotion for Android. Enjoy! ^_^


= RubyMotion 2.32 =
  * The iOS 8.0 and OS X 10.10 versions of the runtime have been recompiled
    with Xcode 6 Beta 6.
  * [iOS] Depracted rake options `device_family' and `retina' in favor of
    `device_name' which takes the name of one of the configured device-sets
    found in Xcode -> Window -> Devices or the `simctl' tool (its location can
    be found in the message shown when using one of the deprecated options).
  * [iOS] Added support for iOS 8 App Extensions. See the `motion create --help'
    output for a list of available templates and configure your host application
    with the following: `app.target("path/to/extension", :extension)'.
  * [iOS] Added support for frameworks that allow you to share code between your
    host application and its extensions. Use the `ios-framework' template for
    `motion create' and configure your host application with the following:
    `app.target("path/to/framework", :framework)'.
  * [iOS] Fixed a bug where backtraces could not be symbolicated on the iOS 8
    Simulator.
  * [iOS] Fixed a bug where the iOS 8 Simulator could not be launched with the
    default device config.
  * [iOS] Fixed a bug where the iOS 8 Simulator could not be used to select
    views in the REPL.
  * [iOS] Fixed a bug where the REPL view selection would incorrectly invert the
    coordinates for the landscape orientation on iOS 8.
  * [iOS] Fixed a bug where "xcodebuild: error:" message would be displayed
    when it will configure `app.xcode_dir' for Xcode6 path.
  * [iOS] Fixed a bug where Instruments.app does not launch with `rake profile'
    on iOS 8.
  * [iOS] Fixed a bug where `iPhone 4s / iOS 7' simulator was always launched
    if Xcode 6 location path was specified through `app.xcode_dir'.
  * [iOS] Fixed a bug in iOS 8 where Hash objects could not be passed as an
    object of an NSUserDefaults.
  * [iOS] Added `app.embedded_frameworks' configuration to support dynamic
    framework on iOS 8.
  * Fixed a bug where headers in nested symlinked directories could not be used
    with `vendor_project' and an Xcode project.
  * Fixed a regression where a crash would happen when calling user defined
    method if the same method was already defined in some classes in Apple SDK.
  * Fixed a regression where a crash would happen when calling methods after
    used a method with variadic arguments.
  * Fixed a bug where a "not precompiled" error would happen when calling the
    SKPhysicsWorld method which takes with Objective-C Blocks.
  * Fixed a bug which superclass method would be called if method was removed
    through Module#remove_method.
  * Fixed a bug which it would trigger crash when the method for KVO was called.
  * Fixed a bug where overrode Time#+ would not be called.
  * Fixed a bug which it would trigger random crash when #method_missing will be
    called.
  * Fixed a bug where it would cause a "Permission denied" error if vendor
    library directory was not writable.
  * Improved Module#define_method performance. ~3 times faster.
  * Improved Object#method_missing performance. ~8 times faster.
  * Reduced the app boot time. ~40% faster.


= RubyMotion 2.31 =
  * The iOS 8.0 and OS X 10.10 versions of the runtime have been recompiled
    with Xcode 6 Beta 4.
  * Fixed a regression where a crash would happen when calling methods with
    variadic arguments.
  * Fixed a bug where Unicode characters outside the BMP of a String object
    would not be properly extracted when passed to an Objective-C API.
  * Fixed a bug where a "not precompiled" error would happen when calling the
    NSURLSessionDownloadTask#cancelByProducingResumeData method.
  * Fixed a bug where a crash would happen when trying to override a method that
    has `MKOverlayRenderer' arguments (ex. #drawMapRect:zoomScale:inContext:).
  * Fixed a bug where trying to retrieve a value from a Hash object using a
    key wrapped as a WeakRef would not work as expected.
  * [iOS] Fixed a bug where ^C would not terminate the `rake debug=1' debugging
    session immediately.
  * [iOS] Fixed a bug where custom debug commands (ex. `pro', `pri') would not
    work in a remote/device debugging session.
  * [iOS] Fixed a bug which user-defined debug commands would not be loaded
    in a remote/device debugging session.


= RubyMotion 2.30 =
  * The iOS 8.0 and OS X 10.10 versions of the runtime have been recompiled
    with Xcode 6 Beta 2.
  * Added the `device_name' parameter in order to select iOS 8 simulater device.
    You can use "iPhone 4s", "iPhone 5", "iPhone 5s", "iPad 2" ,"iPad Retina",
    "iPad Air", "Resizable iPhone" and "Resizable iPad" for device name.
    (Ex rake device_name="Resizable iPhone")
  * Improved the compiler to optimize the app executable size, by removing
    unnecessary internal Objective-C stubs. Apps should be 10-30% lighter,
    depending on how much native calls they use.
  * Added the BigDecimal#{to_i, to_int, to_f, to_s, coerce, +@, -@, modulo, quo,
    power, floor, ceil, round} methods.
  * Added the Kernel#BigDecimal method.
  * Improved String interpolation performance. ~10% faster.
  * Improved the NoMethodError exception message to include the full
    Objective-C selector. Also, #method_missing will now receive the full
    Objective-C selector as the method name.
  * Fixed a bug where spec helpers nested in sub-directories were being
    considered spec files instead of helpers. Thanks to Ignacio Piantanida for
    the patch.
  * Fixed a bug where a crash due to an assertion would be happening when using
    #layout on a MIDIPacketList object on iOS 8.
  * Fixed a bug where a crash would happen when calling a Objective-C method
    supposed to return a block, but instead returning nil.
  * Fixed a bug where a crash would happen when a Symbol object was used with
    the NSCoding interface methods.
  * Fixed a bug where shortcut selectors would not work when the method name
    was begining or ending with a number.
  * Fixed a bug where the `scrollViewWillEndDragging:withVelocity:
    targetContentOffset:' delegate method would not be defined properly.
  * Fixed a bug where a crash would happen when a Struct object was used with
    the NSCoding interface methods.
  * Fixed a bug where the `NSJSONSerialization' interface would return a
    BigDecimal object if the `0.0' value was stored in the original JSON data.
  * Fixed a bug where dynamically-defined methods would not be removed properly.
  * Fixed a bug where typedef parameters would cause a "not precompiled" error.
  * [OSX] Fixed the runtime to recognize `NSTaggedPointerString' objects that
    were introduced in Yosemite.
  * [OSX] Fixed a bug with the `NSManagedObjectModel#entitiesByName' method of
    the CoreData framework where it would return an NSDictionary that was not
    expected on 10.9.
  * [OSX] Fixed a bug where the default value for `app.deployment_target' was
    wrong and would cause a build error on an old version of OS X.
  * [OSX] Fixed a bug where a "not precompiled" error would happen when
    specifying an older version OS X version for `app.deployment_target' when
    building on Yosemite.


= RubyMotion 2.29 =
  * Added support for Xcode 6 Beta 1 and iOS 8.0 / OS X Yosemite (10.10).
  * Fixed a bug where objects removed by Array#delete would not released.
  * Fixed a bug where a `not precompiled' error would happen when calling an
    alias to an Objective-C method with a C-level block argument.


= RubyMotion 2.28 =
  * Added support for `BigDecimal'. This class is implemented on top of
    `NSDecimalNumber' and currently adds all the `BigDecimal' operator methods.
    It can be passed to APIs that require `NSDecimalNumber *', `NSDecimal', and
    pointers to `NSDecimal'.
  * Fixed a bug with framework search paths that contain spaces.
  * Fixed a bug with Objective-C methods that expect a void-pointer to an object
    (`id'/`CFTypeRef') and thus a `Pointer'. The object is now passed as-is.
  * Fixed a bug with the CoreMIDI BridgeSupport metadata on platforms that have
    64-bit support where the MIDI types would be unavailable.
  * Fixed a bug where empty `.strings' files would lead to a build failure.
  * Fixed a bug where methods returning NSNotFound would return an incorrect
    value to Ruby.
  * Fixed a bug where a crash would happen when trying to call a Proc object
    generated by Method#to_proc.
  * Fixed a bug where an NSNumber object would not be converted to a Ruby
    Numeric object in the context of Objective-C Subscripting.
  * Fixed a bug where `super' couldn't be used with keyword arguments.
  * Fixed a bug where an incorrect cache would be used internally and would
    trigger an exception when shortcut selectors were used.
  * Fixed a performance issue when deallocating many objects.
  * Reduced the app boot time. ~15% faster.
  * Improved Object#method_missing performance. ~10% faster.
  * Improved performance where creating Objective-C selectors internally.
    As an example, Object#{send, respond_to?} is now ~30% faster.
  * Improved String interpolation performance. ~10% faster.


= RubyMotion 2.27 =
  * Added support for localization `.strings' files which will be compiled as
    binary files. Thanks to Hwee-Boon Yar for the patch (pull request #154).
  * Added support for `NSLocalizedString' and friends. These are now available
    on `Kernel'.
  * Added missing AudioUnit bridgesupport metadata.
  * Improved the file dependencies detection code to spend less time when
    working on a project that has a significant number of dependencies.
    Thanks to Ignacio Piantanida for the detective work.
  * Fixed a regression introduced in RubyMotion 2.25 that was causing a
    build error in environment using Ruby 1.8.
  * Fixed a regression introduced in RubyMotion 2.25 that was causing a
    `not precompiled' error if the method would handle a BOOL pointer as an
    argument.
  * Fixed a bug where Boxed subclasses could not be re-opened safely.
  * Fixed a bug which shortcut for the method which was implemented on Ruby
    would not respond.


= RubyMotion 2.26 =
  * Fixed a regression introduced in the previous release that was causing a
    crash when checking if a class supports weak references on iOS 6.


= RubyMotion 2.25 =
  * Added support for Xcode 5.1 and iOS 7.1 final.
  * Added support for OSX 10.6 as deployment target (experimental).
  * Improved user feedback by printing a warning when overriding a protocol
    method that was previously defined with one of the `attr_*' methods. This
    may print false positives.
  * Improved `rake ctags' to index the application's .rb files. Thanks to
    Hwee-Boon Yar for the patch (pull request #152).
  * Improved use of `WeakRef' to raise an exception when trying to create a
    weak reference to one of the unsupported classes. For more information, see
    `Which classes don’t support weak references?' at http://bit.ly/1iiSOaU.
  * Added some introspection support to `ImmediateRef'. It can now report the
    actual class, its methods, and a inspect description string.
  * Added gemspec call to Gemfile for gem template. Thanks to Mark Rickert for
    the patch (pull request #151).
  * Fixed a bug where `rake device debug=1' did not work with Xcode 5.1.
  * Fixed an error in `rake device debug=1' if it would use UTF-8 as app name.
  * Fixed a bug where an application could not be installed and launched on the
    Simulator or a device due to the application bundle containing a directory
    called `Resources'. This will now fail the build with a descriptive error.
  * Fixed a bug where the OS X REPL did not work on 10.7 Lion.
  * Fixed a bug where KVC property validation methods defined in Ruby would not
    be compiled with the appropriate (Pointer) types.
  * Fixed a bug where Ruby methods defined on Objective-C tagged pointer
    objects could not call methods on itself.
  * [iOS] Made `tap' test helper work with `UISwitch'.
  * Fixed a bug where methods with BOOL arguments would not be handled properly.
  * Fixed a bug where the cycle detector did not work for Array/Hash objects.
  * Fixed a memory leak in Object#{method, public_method, instance_method,
    public_instance_method}.
  * Fixed a bug where Boxed#copy would cause a crash.
  * Fixed a bug where Range#copy would cause a malloc_error_break error.
  * Improved Object#instance_variable_set performance. ~20% faster.
  * Improved Object#method performance. ~50% faster.
  * Improved method dispatcher performance. ~5% faster.
  * Improved fine-grained lock performance. ~20% faster.
  * Improved memory management performance. ~25% faster.


= RubyMotion 2.24 =
  * Fixed a regression introduced by the last build where environments running
    versions of Ruby not handling source files as unicode by default would be
    broken due to the presence of a unicode character in one of the files.


= RubyMotion 2.23 =
  * Added support for objects conforming to the Subscripting interface
    (Objective-C Literals).
  * Fixed a bug with the `motion activate' CLI command. Thanks to Joffrey
    Jaffeux for the patch.
  * Fixed a regression when specifying external templates to `motion create'.
  * Fixed a bug where WeakRef.new would cause a crash when nil, true, false,
    Fixnum or Float objects were passed.
  * Fixed a bug where `vendor_project' with `:static' did not reuse `:cflags'
    for the BridgeSupport generation.
  * Fixed a bug where manually created BridgeSupport metadata files were no
    longer being used by the compiler. Now if one exists in the root of the lib
    dir, that will be used instead of one in the platform-specific build dir.
  * Added temporary files that are sometimes generated by the REPL to the
    default `gitignore' file. Thanks to Mark Rickert for the patch (pull
    request #150).
  * Added support for "value of def-expr" feature (ex. `def foo; end' returns
    the `:foo' symbol).
  * Fixed a bug where NSDate.distantFuture returns a wrong value.
  * Fixed a memory leak when an exception message is created.
  * Fixed a bug where the cycle detector would be activated during asynchronous
    Dispatch::Queue blocks even if ARR_CYCLES_DISABLE was set.
  * Fixed a bug where #send would freeze the app when passed a method name
    which accepts a bool if the method would be used with #send only.
  * Optimized methods converting implicitely types using #to_str etc.
  * Improved String#to_sym performance. ~40% faster.
  * Improved performance in dispatcher. ~20% faster.
  * Improved performance where allocates internal memory of String objects.
    ~10% faster.
  * Improved performance of methods where accepts Regexp object. ~20% faster.
  * Improved String literals performance. ~60% faster.
  * Improved String performance where it handles short strings. ~25% faster.
  * Improved String#{strip, rstrip, lstrip} performance. ~70% faster.
  * Improved String#{[], []=, +, =~} and Array#+ performance. ~20% faster.
  * Improved String#{==, !=} performance. ~50% faster.
  * Improved String#include? with UTF-8 strings performance. ~15% faster.
  * Improved String#{==, <=>}, NSString#== and Hash#== performance if it would
    compare other class object. ~8 times faster.
  * Improved Time#{+, -} performance. ~25% faster.
  * Improved Time#{==, !=, <, <=, >, >=} performance. ~2 times faster.
  * Improved Time#+ with float performance. ~80% faster.
  * Improved Array#{==, !=} performance. ~25% faster.
  * Improved Hash#{==, !=} performance. ~50% faster.
  * Improved Range literals performance. ~20% faster.
  * [iOS] Fixed a bug with the `flick' UI test helper not working with
    `UISwitch' on iOS 7.
  * [iOS] Added support for launching an application for background fetch in
    the iOS Simulator with the `background_fetch=1' rake option.
  * [iOS] No longer query the simulator application for its window metrics when
    it is connected to a REPL but not the active application.
  * [iOS] Improved the automatic selection of codesign certificates.
  * [iOS] Improved error reporting when specifying the rake `target' option
    with a version lower than the configured deployment target and when
    specifying `retina=false' when targeting iOS 7.
  * [OSX] Fixed a bug where the REPL wouldn't work in development mode if the
    app is sandboxed.
  * [OSX] Removed backtrace symbolication when an application is sandboxed and
    print the command to allow the user to symbolicate themselves instead.
  * Jim Weirich, 1956 - 2014. Without you I would not exist. Rest in Peace.


= RubyMotion 2.22 =
  * Fixed a bug with `vendor_project' and prebuilt libraries, where the
    BridgeSupport file could not be created, as the build directory wouldn’t
    exist yet.
  * Fixed a bug with `vendor_project' and Xcode projects, where the
    BridgeSupport files were being searched in the wrong location.


= RubyMotion 2.21 =
  * Added reference zeroing to `WeakRef' starting from iOS 5 and OS X 10.7. It
    will now raise an exception in case a message is sent after the reference
    has been deallocated. Use the `WeakRef#weakref_alive?' method to check if
    it has been deallocated or not.
  * Improved performance where Array elements would be converted from Ruby to
    Objective-C instance. ~10% faster.
  * Fixed a bug where incorrect SDK version values were being used in the
    Info.plist file resulting in iOS App Store submissions being rejected.
  * Fixed a bug where `motion update --cache-version=X' is broken.
  * Fixed a bug where vendored Xcode OS X projects were build with the
    IPHONEOS_DEPLOYMENT_TARGET option instead of MACOSX_DEPLOYMENT_TARGET.
  * Fixed a memory leak where the objects with a cyclic reference would not
    be released when used inside an asynchronous Dispatch::Queue.
  * Fixed a bug where BridgeSupport files for external projects included via
    `vendor_project' were being shared across platform and not removed with
    `rake clean'.


= RubyMotion 2.20 =
  * Improved command-line interface, e.g. `$ motion create --help' will now no
    longer create an application called ‘--help’. This deprecates the interface
    for any command plugins and this will fully be removed with RubyMotion v3.
  * Added support for loading plugins through RubyGems. Libraries that used to
    use `~/Library/RubyMotion' to load commands and/or templates should no
    longer do so, but instead add a `lib/motion_plugin.rb' file (see Joybox for
    an example). The `~/Library/RubyMotion' is from now on only meant for local
    usage, i.e. outside of the scope of a gem.
  * Added the Proc#owner method, which returns a reference to the object the
    block was created from (the `self' reference).
  * Improved Rational performance. ~4 times faster.
  * Improved Proc#new performance. 15% faster.
  * Improved performance of Range objects created with the literal syntax.
    ~80% faster.
  * Improved Object#inspect performance. ~25% faster.
  * Improved Object#!~ performance. ~3 times faster.
  * Improved Object#{send, respond_to?} performance. ~30% times faster.
  * Improved performance in dispatcher. ~25% faster.
  * Improved performance of arithmetic methods with Float objects in 32-bit.
    ~80% faster.
  * Fixed a bug where methods accepting variadic arguments would not be working
    as expected when a method of the same signature was used before.
  * Fixed a bug in the build system with Ruby 2.1 where an application whose
    name contains UTF-8 characters could not be built.
  * Fixed a race condition bug in the runtime where a crash would occur if
    the same Objective-C constant was being resolved at the same time from
    different threads.
  * Fixed the runtime to be able to deal with all tagged pointers from the
    Objective-C world. For instance, using NSTaggedManagedObjectID would lead
    to a runtime crash.
  * Fixed a bug where the user defined bang (!) method would be not called.
  * Fixed a memory leak when creating compile time constants.
  * Fixed a memory leak in Dispatch::Queue.new.
  * Fixed a memory leak in Array#shift.
  * Fixed a bug where Method#to_proc would not return a lambda block.
  * Fixed a bug where CFType structures in AudioToolbox could not be used.
  * Fixed a bug which Kernel.raise could not raise an NSException object.
  * Fixed a bug where #alias and #respond_to? methods would cause a race
    condition.
  * Fixed a bug in the compiler that would ignore BridgeSupport enum values if
    they only have a 64-bit value.
  * Fixed a bug where NSMutableArray#delete_at would immediately release an
    object.
  * Made `vendor_project' accept glob patterns for the `source_files' option.
  * Made BridgeSupport metadata generation for `vendor' projects by default use
    the `:cflags` option.
  * [iOS] Made the UI test helper search for views from the `keyWindow' instead
    of the `current' window that was created specifically for the test. This
    makes it easier to interact with modal views such as `UIAlertView'.
  * [iOS] Fixed a bug in the build system where a link error would be caused
    when building for arm64 with Xcode 5.1. Thanks to Andrew Larssen for the
    patch (pull request #146).
  * [OSX] Fixed a bug where an NSDate object convered to a Time object would
    cause a calculation error.
  * [OSX] Fixed the `rake crashlog' task.
  * [OSX] Added `external_frameworks' config variable, which is used for
    frameworks that are outside of `/System/Library/Frameworks`, but are not
    meant to be embedded inside the application.
    E.g. `/Library/Frameworks/iTunesLibrary.framework'.
  * [OSX] Fixed a bug where method types of NSOpenPanel and NSSavePanel were
    not being cached for their private counterparts that are substituted at
    runtime in case the application is running in a sandbox.


= RubyMotion 2.19 =
  * [iOS] Fixed a regression related to the sim launcher changes for Xcode 5.1
    that broke `rake simulator debug=1`.
  * [OSX] Fixed a regression where #eval support was not working anymore.
  * Improved Hash#{default, shift} when Hash#default_proc returns a block.
    2 times faster.
  * Improved comparison iterator blocks that return Float objects.
    (Ex. Array#sort{|a,b| return float_object }). 2 times faster.


= RubyMotion 2.18 =
  * Added the `rake crashlog:device' task which will download crash reports
    generated by the app on the device, symbolicate them and save them on the
    local file system. The latest generated file will then be automatically
    opened in Console.app.
  * Improved the terminal output when using `vendor_project` with an Xcode
    project so that it matches the build system output. This feature is using
    the XCPretty project. Thanks a lot to Marin Usalj and Delisa Mason for it.
  * [iOS] Fixed a bug where applications could not be launched on the simulator
    when using Xcode 5.1. Due to this change, Xcode 4 is no longer supported.
  * [OSX] Fixed a bug where apps generated on i5/i7 machines would fail to run
    on older machines (ex. core2) due to the use of a new instruction.
  * Fixed a bug where Hash#{[]=, clear, removeObjectForKey} will immediately
    release an object.
  * Fixed a bug where Array#{delete, clear} will immediately release an object.
  * Fixed a bug where Struct#[]= and setter of Struct member will immediately
    release an object.
  * Fixed a bug where setter of Boxed member will immediately release an object.
  * Fixed a bug where Kernel#instance_variable_set will immediately release an
    object.
  * Fixed a bug in the cycle detector where weak Proc objects would have their
    `self' reference scanned, resulting in a double-release crash at runtime.
  * Fixed a bug where Kernel#block_given? would not work as expected if a Proc
    object was passed as a method argument.
  * Fixed a bug in the spec runner app that could cause the test suite to be
    started multiple times. Thanks to Jason W. May for the patch (pull request
    #145).
  * Improved Range.new performance. 20% faster.
  * Improved Array#flatten performance. 70% faster.
  * Improved Time#strftime performance. ~30% faster.
  * Improved Numeric#{div, to_int} performance. 20-60% faster.
  * Improved Fixnum#== and Float#== performance when it would compare an object.
    2.5-3 times faster.
  * Improved Enumerable#grep performance. 2 times faster.
  * Improved the build system to compile as many spec files in parallel as
    possible.


= RubyMotion 2.17 =
  * Added the `Proc#weak!' method which transforms the strong reference to the
    block `self' variable into a weak reference. Once the `self' variable is
    weakly referenced there is no coming back to a strong reference. This
    method can be used to break cyclic references that the cycle detector is
    not able to handle yet.
  * Defined implementations of NSObject methods, such as `conformsToProtocol:',
    that take Ruby semantics into account on all classes created by RubyMotion.
  * Fixed a bug in compiler where boxed types would not be properly registered
    if a structure was only used for a pointer.
  * Fixed the dispatcher to let methods expecting a structure of type A accept
    a structure of type B who has the exact same fields signature, as in C
    (ex. MKCoordinateRegion and CGRect).
  * Added support for dynamic name directory in project templates. Thanks to
    Toshiwo for the patch (pull request #144).
  * Fixed a bug in NSArray#{take,drop} where nil could be returned instead of
    an empty Array object in certain cases.
  * Fixed a bug where NSDate objects would be wrongly converted to Time objects.
  * Fixed a bug where certain structures of the same signatures could not be
    used. (Ex. NSRect and CGRect in a 64-bit OS X app)
  * Improved Range.new performance. 20% faster.
  * Improved Array performance where finalizes object and expands internal
    memory. 15% faster.
  * Fixed bugs where ARC's rules related to method names starting with `new` or
    containing `copy` or `Copy` where not being followed. This lead to objects
    returned from Objective-C methods that matched these rules not being
    autoreleased and objects returned from Ruby to Objective-C not being
    retained.
  * Fixed the runtime to prefix certain kernel symbols we export (ex. selCopy)
    in order to avoid clashes at link time with certain 3rd-party libraries.
  * Fixed a bug in in the build system where duplicated entries in the
    app.resource_dirs array would mess up the resource-copying process.
  * Fixed a bug where nested WeakRef objects (WeakRef.new(WeakRef.new(...)))
    would not be properly resolved at dispatch time.
  * Fixed a bug in {NSObject,Boxed}#== with a WeakRef object operand where said
    operand would not be resolved.
  * Fixed a compiler bug where `not precompiled' errors when it uses structure
    of GLKit framework.
  * [iOS] Fix various bugs in the UI test helpers, like `tap`.
  * [OSX] Fixed #eval to honor the self binding when evaluating the string.
  * [OSX] Introduced the `app.codesign_for_release' variable, which controls
    whether code-signing should occur during `rake build:release'. The default
    value for this variable is `true'.


= RubyMotion 2.16 =
  * Fixed a heap overflow in floating point parsing (CVE-2013-4164).
  * Improved Time#{<, >, ==, eql?} performance. 9 times faster.
  * Improved the performance when NSDate objects are converted to Time objects.
    10 times faster.
  * Fixed regression in the REPL that made it impossible to use block local
    variables.


= RubyMotion 2.15 =
  * Added support for Xcode 5.1 Developer Preview and iOS 7.1 Beta.
  * Improved REPL to recognize Simulator at any scale and orientation. The only
    unsupported variant at this time is a Simulator window with scroll bars.
  * Fixed REPL<->Simulator coordinate translation when run on a Retina Mac.
  * Fixed undefined behaviour in REPL such as local variables not being stored.
  * Improved dispatching of shortcut methods (ex foo= is shortcut of setFoo:).
    20 times faster.
  * Improved the performance where Fixnum and Float are returned. 20% faster.
  * Improved Array#concat performance. About 2 times faster.
  * Improved Array#reverse performance. 2 times faster.
  * Improved Array#reverse! performance. 8 times faster.
  * Improved Array#rotate performance. 5 times faster.
  * Improved Array#rotate! performance. 40 times faster.
  * Improved iterators performance (ex Array#{each, map}). 2-3 times faster.
  * Fixed a bug where Array#rotate! causes a crash in REPL.
  * Fixed a bug where the objects created by "CFxxxCreate(args)" are not
    released.
  * Fixed a bug in dispatcher where #super cannot look up the shortcut method.
    (ie #foo=)
  * Improve the precision of Float value.
  * Raise error if cleaning a build artefact fails.
  * [iOS] Fixed and optimized remote debugging (`rake device debug=1').
  * [iOS] Fixed a bug where `rake device' would no longer print the application
    logs from the device.
  * [OSX] Fixed a bug on OSX platform where compiler flags for iOS are passed
    when it generates bridgesupport file for vendor library.
  * [OSX] Added missing bridgesupport metadata for Carbon, OSServices and
    ApplicationServices frameworks.
  * [iOS] Deprecated optional block that can be passed to the `tests` method
    when making use of the view test helpers. This can be done with normal
    `before` filters.


= RubyMotion 2.14 =
  * Really fix the inline function problem described in the previous update.


= RubyMotion 2.13 =
  * Fixed a bug where the methods which are defined as inline functions in
    iOS/OSX framework are not working properly.
  * Fixed a bug where using the mouse-over functionality in the REPL would
    lead to an internal deadlock and hang the process.
  * Fixed a bug in the REPL where the result of evaluated expressions could be
    prematurely released before being sent back to the command-line.
  * [iOS] Work around an issue where Instruments.app wants an integer
    UIDeviceFamily value and App Launcher wants a string.
  * [iOS] Fixed a big where the running the REPL in 64-bit mode would result
    in an error related to the fact that the REPL library was i386-only.


= RubyMotion 2.12 =
  * Added support for OS X Mavericks (10.9). The toolchain is now fully usable
    on a Mavericks machine and can also be used to create Mavericks OS X apps.
  * Added `profile' rake tasks that launch builds through Instruments.app for
    iOS (both simulator and device) and OS X applications. Run a `rake clean'
    before using the task on an existing project.
  * [OSX] Added optional support for the #eval method. To enable it, you can
    set the `app.eval_support' variable to true (default is false). Support
    is currently experimental and will increase your application bundle size
    by about 28MB.
  * Fixed a internal memory leak in the Enumerator object.
  * Added support to compile the Objective-C source codes which uses Modules
    syntax in `app.vendor_project'.
  * Added a custom `gen_bridge_metadata' which enables recursive function
    pointer parsing to support Objective-C blocks that yield blocks.
  * Added support for functions/methods that return Objective-C blocks by
    wrapping those as Proc's.
  * Fixed a memory leak when ObjC #initXXX methods will return internal class
    object (ex NSMutableData#initWithLength, NSArray#initWithArray).
  * Fixed where #new method doesn't work for GLKKit structure.
    (ex GLKMatrix2.new, GLKVector2.new).
  * Fixed a bug in Array#sample where it would return duplicated elements when
    a value greater than self length was passed into argument.
  * Fixed a bug where `motion update' might cause an error when it displays the
    changelog on OSX 10.9.
  * Fixed a compiler bug where it causes a crash with `rake device' when it
    overrides the method which has structure as argument.
  * [iOS] Fixed a crash when using certain NSIndexPath objects (64-bit only).
  * [iOS] Fixed `rake debug=1` on OS X 10.9 not working.
  * [iOS] Fixed a bug in the build system where it would generate invalid
    values for the UIDeviceFamily key (was using strings instead of integers).


= RubyMotion 2.11 =
  * Added the `rake clean:all' task which deletes all build object files
    (ex. those in ~/Library/RubyMotion/build). We recommend using that task
    before building an App Store submission.
  * Added support for Xcode asset catalogs. This can be used to manage all your
    image assets in a visual way, including your application’s icons. You can
    create and edit a new catalog like so:
    $ mkdir resources/Images.xcassets && open -a Xcode resources/Image.xcassets
  * Fixed a long standing limitation in the compiler where overriding in Ruby
    an Objective-C method that accepts a C-level block was not possible.
  * Fixed a regression where `return' from a block would terminate the app.
  * Improve the build system to always copy embedded.mobileprovision. Thanks to
    Jan Brauer for the patch (pull request #121).
  * Fixed a bug where a boxed struct would incorrectly be interpreted as a
    object type, leading to the dispatcher not recognizing a signature.
  * Fixed a bug where compiled object files of a vendored project were not
    actually being cleaned when running `rake clean`.
  * Fixed a bug where defining a singleton method on an object inside a method
    with named parameters (Objective-C-style selector) would result in that
    method being defined in the runtime with a wrong selector.
  * Fixed a bug where Range objects created with non-literal begin/end points
    would never be released, and therefore leaking memory.
  * Added `context` method as `describe` alias in spec.  Thanks to Ryo Katsuma
    for the patch (pull request #134).
  * Fixed a small internal memory leak in the dispatcher when sending the
    #method_missing message.
  * Fixed a bug in the compiler where providing nil as the value of a C-level
    block argument would not actually pass NULL but an empty Block structure
    instead. Thanks to Ruben Fonseca for the detective work.
  * [iOS] Fixed a bug where device log is wrong filtered with `rake device'
    when performed day is 1-9.
  * [iOS] Added support to launch the app as 64-bit in simulator.
  * [iOS] Fixed where non-retina iPad simulator does not launch as default.
    Thanks to Fabio Kuhn for the patch (pull request #133).
  * [iOS] Fixed a regression where certain GameKit class properties could not
    be used (ex. GKMatchRequest#minPlayers).
  * [iOS] Fixed a link error where "ld: framework not found IOKit" is caused
    with iOS 7 SDK when it will run `rake device'.
  * [OSX] Fixed the wrong default settings of short cut key in menu. Thanks to
    Kazuhiro NISHIYAMA for the detective work.


= RubyMotion 2.10 =
  * Fixed a critical regression in the compiler where DWARF metadata would not
    be generated, causing .dSYM bundles to miss debugging symbols for Ruby
    code. The regression was introduced in 2.8. If you submitted apps built
    with 2.8 or 2.9 to Apple and need to symbolicate crash reports, you can
    rebuild them with 2.10 and use the new .dSYM bundle.
  * Fixed a bug where `motion changelog' does not work.
  * Fixed a regression introduced in 2.9 that could lead to a compiler crash
    when using the GLKit framework.
  * Fixed a bug in `rake device' where it could sometimes crashes when
    retrieving console logs.
  * Fixed a bug in the build system where the build would fail when generating
    BridgeSupport metadata if the Xcode path contained a space character.
    Thanks to Michal Jirku for the detective work.
  * Fixed a warning in the build system when creating a universal static
    archive for a vendored project.
  * [iOS] Fixed the build system to really not build for 64-bit by default.
  * [iOS] Fixed a regression where exceptions could be not rescued in GCD
    blocks on device, apparently due to an underlying change in iOS 7.
    Thanks to Mark Frawley for the detective work.
  * [iOS] Fixed a bug where `rake device' would cause an Assertion Failed when
    `app.name' contains non-ascii characters.


= RubyMotion 2.9 =
  * Work around what is very likely a bug in the App Store verification
    process which would reject RubyMotion apps based on the fact that certain
    __builtin__xxx_chk() functions of the C runtime are marked as private API.
    These functions are called by the compiler in certain scenarios in order
    to detect overflows. So far we know Apple rejects __strlcpy_chk() and
    __strlcat_chk() calls, so we removed them from the RubyMotion runtime.


= RubyMotion 2.8 =
  * Added support for iOS 7.0 GM and Xcode 5.0 GM.
  * Added support for building 64-bit iOS apps for iPhone 5S (experimental).
    The toolchain is now able to create x86_64 apps for the simulator and
    arm64 apps for the device. Given the fact that 64-bit iOS has just been
    announced and that many 3rd-party projects have not yet been updated, the
    support is disabled by default. To enable, you can edit your Rakefile and
    set the following lines: app.archs['iPhoneOS'] << 'arm64';
    app.archs['iPhoneSimulator'] << 'x86_64'
  * Improved the compiler to emit assembly instead of LLVM bitcode, which
    results in a significant performance improvement (~3x faster builds).
  * Upgraded the toolchain to LLVM 3.3 and to use clang compilers by default.
    Xcode 4 (llvm-gcc) is no longer required to exist in the file system.
  * Fixed a bug in build system where it could not build an app that was using
    Korean characters in the name.
  * Fixed a bug in the `motion update' command where a non-ASCII character was
    wrongly used in the source code, causing the process to fail in certain
    versions of Ruby. Thanks to Clay Allsopp for the patch (pull request #125).
  * Fixed the compiler to emit debugging (DWARF) annotations for expressions
    that weren't covered before (ex. variables assignments).
  * Fixed a bug where Time#{==, eql?} would return the wrong value when using
    duplicated object from #copy.
  * Fixed a bug in the build system in the `app.vendor_project' method where
    providing custom compiler flags (:cflags => '...') wouldn't work if the
    project was being built twice  (ex. `rake build' which builds for both the
    simulator and the device). Thanks to Nick Quaranto for finding the bug.
  * [iOS] Development builds for the device will now compile for the lowest
    architecture possible, in order to create faster builds.
  * [iOS] Fixed a malloc error bug when retrieving a NSDate object from the
    ABRecordCopyValue() function.
  * [iOS] Fixed a bug where methods of the ABPersonViewController,
    ABNewPersonViewController and ABUnknownPersonViewController would cause
    crashes in iOS 7.
  * [iOS] Fixed a bug where the platform/SDK key in Info.plist would indicate
    `iphoneos' even for simulator builds. It has now been changed to
    `iphonesimulator', like Xcode. Thanks to Hwee-Boon Yar for the patch
    (pull request #129).
  * Fixed a bug where template working trees would not be updated upon git pull
    with `motion create [AppName] -template=[git repository path]'.
    Thanks to Jamon Holmgren for the patch (pull request #128).


= RubyMotion 2.7 =
  * Added support for iOS 7.0 Beta 6 and Xcode 5.0 DP 6.
  * Bundler is now integrated in new iOS and OS X projects. A default Gemfile
    will be created and the Rakefile file will require and initialize the
    bundler gem. In case Bundler is not to be found in the Ruby distribution
    that is being used, the build system keeps working as usual.
  * Added the `--cache-version' flag to the `motion update' command which lets
    you keep multiple versions of RubyMotion in your computer. Cached versions
    are installed as `/Library/RubyMotion<XXX>' (where XXX is the version
    number). A project can use an older version of RubyMotion by changing its
    Rakefile to point to `/Library/RubyMotion<XXX>/lib'. The `--force-version'
    flag previously available in `motion update' has been removed.
  * Added the `motion device:console' command to print the logs of the USB
    connected device. New messages will be printed in real-time. Use ^C to
    disconnect from the device.
  * Added the `motion changelog' command to open the NEWS file in the terminal.
    Thanks to Dan Loewenherz for the patch (pull request #107).
  * Added the `String#to_fourcharcode' method which converts the receiver into
    a FourCharCode type (used when doing Carbon/AppleEvent programming). The
    receiver must have exactly 4 characters.
  * Added `*.gem' into .gitignore in gem template.
  * Removed calls from the String/Encoding/Regexp classes to ICU functions that
    Apple has marked as non-public API. As a result, certain operations on
    UTF-32 encodings are not possible anymore, until we figure out a solution.
  * Fixed a memory crasher in Range.new.
  * Fixed a bug in `rake crashlog' where it would fail with a missing
    Shellwords constant, and also when it was not able to locate any crash
    report file.
  * Fixed the wording of the message printed when an application terminates
    with a non-zero status code.
  * Fixed a bug in `rake spec' where it would always return exit(0) status.
  * Fixed the default value of app.short_version to be the same value as in
    app.version. Thanks to Justin Campbell for the patch (pull request #62).
  * Improved the `Boxed#to_a' to recursively send the `#to_a' message on fields
    of the Boxed class (ex: CGRectMake(1, 2, 3, 4).to_a #=> [[1, 2], [3, 4]]).
  * Improved Time class implementation in order to follow Ruby 1.9, so far it
    was based on a Ruby 1.8. This would handle a time that exceeds the value of
    the 32 bit. Added Time#{round, subsec, to_r} methods and changed Time#{new,
    localtime, getlocal} methods to allow the variable arguments.
  * Fixed a minor bug in the cycle detector where it would scan the instance
    variable slots of a pure-Ruby object that have not been initialized yet.
  * Fixed a memory crasher in the REPL that would happen when attempting to
    set the libedit prompt from another thread, leading to a race condition.
  * Fixed a bug, apparently caused by a change in the Objective-C runtime in
    Xcode 5, that would make certain methods (ex. MKAnnotationView#image) not
    returning a proper type at runtime but a pointer to a structure instead.
  * Fixed the build system to make the content of the ARR_CYCLES_DISABLE
    environment variable persistent when distributing an app.
  * [iOS] The `rake device' task will now start the application (without the
    need to attach a debugger). Logs emitted by the app will be redirected in
    the terminal. ^C quits the app. In order to just install the app, the
    `install_only' option can be given (ex. `rake device install_only=1').
  * [iOS] Fixed the REPL/mouse-over functionality when using the simulator in
    retina mode (which is the default when targetting iOS 7).
  * [iOS] Added experimental support for remote debugging with lldb (Xcode 5).
  * [iOS] Added support for the compilation of SpriteKit texture atlas files.
    The build system will now compile directories with the `.atlas' extension
    into one large file inside the app bundle, similar to how Xcode does it.
  * [iOS] Added `:light_content' as new possible value for the
    `app.status_bar_style' Rakefile variable. Thanks to Chris Radford for the
    patch (pull request #116).
  * [iOS] Fixed a bug in `rake debug=1' with Xcode 5 where builtin commands
    (ex. `pro') where not available. We ported the commands from gdb to lldb.
  * [iOS] Fixed a bug where the Accelerate framework was not covered by the
    compiler. Note that the framework is C-only, might be tough to use from
    RubyMotion, and should probably be called in vendored-C code for better
    performance results.
  * [OSX] Added the `app.category' variable which can be used to specify the
    AppStore category. The default value is `utilities'. Thanks to Mark Rickert
    for the patch (pull request #115).
  * [OSX] Fixed the REPL/mouse-over functionality to be able to select views in
    the key window, if the application has multiple windows opened.
  * [OSX] Fixed a bug in Dispatch.once where only the first occurence of the
    call in the code would work as expected.
  * [OSX] Added the `app.codesign_for_development' variable that can be set to
    true to enable codesigning for development builds. The default value for
    this variable is false, and only release builds are codesigned by default.


= RubyMotion 2.6 =
  * Added support for iOS 7.0 Beta 4 and Xcode 5.0 DP 4.
  * Improved the build system so that spec files are also compiled in parallel.
  * Fixed a bug in the cycle detector where it would try scanning objects that
    have already been released. Thanks to Nick Quaranto for the help.
  * Fixed a bug in the cycle detector where instance variables on scanned
    objects would disappear, because of a problem in the WeakRef class.
  * Fixed a bug in `rake crashlog' with application names containing space
    characters. Thanks to Clay Allsopp for the patch (pull request #112).
  * Fixed a bug in the debugger where the debugged process would be terminated
    if ^C was pressed while the app was running.
  * Fixed a bug in the spec framework where a spec that raises a pure
    NSException would cause a runtime error as it would try to send the
    #backtrace message to the object.
  * [iOS] Fixed a bug in the REPL (iOS 7 only) where local variables would not
    be preserved.


= RubyMotion 2.5 =
  * The runtime is now able to detect and break basic circular references
    (when two objects point to themselves). Only objects created from Ruby
    classes (including Objective-C subclasses) are scanned. Cycle detection
    happens when draining the nearest autorelease pool and has a limited number
    of depth iterations, to preserve acceptable runtime performance. To disable
    the cycle detector, set the ARR_CYCLES_DISABLE environment variable to any
    value. To enable debug logging, set the ARR_CYCLES_DEBUG environment
    variable to any value. Many thanks to Joe Noon for pre-testing this feature.
  * Fixed a bug where C-level blocks allocated by the compiler would never be
    released at runtime, as well as the Proc object linked to it. C-level
    blocks are now allocated on the stack, keep a weak-reference to the
    Proc object, and properly implement the Blocks ABI copy/dispose handlers
    to retain/release the associated Proc object when required.
  * The Exception class is now rewritten on top of the NSException class,
    and properly implements its primitive methods. Exceptions are no longer
    being converted. Exception handlers written in Ruby will still catch
    NSException objects by default.
  * Fixed memory leaks in NSMutableArray#{first(n), last(n), pop(n), shift(n)}.
  * Fixed a bug where nested block variables would not be properly synchronized
    if the block terminated early with the `break' or the `return' construct.
    Thanks to Greg Fodor for the report.
  * Fixed a bug where local variables created inside a loop (ex. `while') and
    used inside a nested block would cause the previous value to be released
    twice during the next iteration. Thanks to Daniel Dickison for the report.
  * Fixed Dispatch::*.{sync,async} methods to not catch exceptions inside the
    given blocks, and simply let the process crash naturally.
  * Fixed the build system to not compile default exception handlers in the
    main() entry-point function, as we want the process to crash naturally.
  * Fixed a bug where block variables passed to Dispatch::Queue#async could
    be released twice, leading to a crash.
  * Fixed a bug in the build system where app.deployment_target and
    app.sdk_version were compared as text. Thanks to Andrew Babichev for the
    patch (pull request #108).
  * Changed the `rake simulator' task to print a message when an application
    crashes due to a signal (ex. SIGSEGV) and suggest the user to read the
    crash report file that has been generated by the system.
  * Added the `rake crashlog' task to automatically open the latest crash
    report file that was generated by the system for the current app.
  * Fixed a bug in the REPL where using the <tab> key to enable auto-completion
    could result in a crash due to a missing symbol.
  * Fixed a bug where an object implementing the NSCoding protocol as well as
    #init and #initialize(arg) methods would cause a crash during creation.
  * [iOS] Fixed a warning message from the linker that would be displayed when
    using Xcode 5 to build the app.
  * [iOS] Fixed a bug in the debugger where built-in debug commands weren't
    installed within the simulator.
  * [iOS] Fixed a bug in the build system where an app cmpiled for iOS 5.x
    would immediately crash on the device.
  * [iOS] Fixed a bug where the NSUIntegerMax constant was not properly
    exposed when targeting iOS 7.x.


= RubyMotion 2.4 =
  * Added support for iOS 7.0 Beta 3 and Xcode 5.0 DP 3.
  * Fixed a long-standing set of memory-related bugs related to lambdas.
    Dynamic variables (shared by lambdas and calling scope) are now allocated
    as heap memory inside the Proc data structure. Local variables are properly
    synchronized. Proc objects are properly reclaimed by the system once they
    are no longer used. Changes have been added to both the compiler and the
    runtime.
  * [iOS] Fixed a bug in `rake device' where it could not build an app using
    Xcode 5.x with a deployment target less than iOS 7.0.
  * [iOS] Reduced the size of the Default-568h@2x.png file. Thanks to Gant
    Laborde for the patch (pull request #100).
  * [iOS] Fixed a bug where `rake retina=3.5' would not work with Xcode 5.x.
  * [iOS] Fixed a bug where `rake simulator' would re-launch an iOS 7 simulator
    with Xcode 5.x every time.
  * [OSX] Fixed a bug in the build system where APIs of 3rd-party libraries
    would not be properly handled in 64-bit mode.
  * Fixed a memory crasher when trying to use the old value of an instance
    variable slot as a local variable.
  * Fixed memory leaks in NSMutableArray#insert.
  * Fixed memory leaks when parsing bridgesupport file during compilation.
  * Fixed a bug in NSMutableDictionary#delete where it will cause a crash if it
    would use the result of NSMutableDictionary#delete on the receiver object
    which was created by NSJSONReadingMutableContainers.
  * Fixed a bug where 3rd-party libraries would fail to build if the file path
    of the app contained space characters.
  * Fixed a bug in Kernel#Array() where it would return an incorrected value
    if an NSArray object was passed as argument.
  * Fixed a compiler bug where `not precompiled' errors would sometimes happen
    at runtime when using APIs dealing with BOOL types.
  * Added a block to setup controller in the spec API. Thanks to Katsuyoshi Ito
    for the patch (pull request #104).
  * Fixed the `rake build' task to honor the `keep_temps' environment variable.
    If set, temporary files (such as LLVM bitcode and assembly) will not be
    removed from the build directory. To be used for debugging only.


= RubyMotion 2.3 =
  * Added support for iOS 7.0 Beta 2 and Xcode 5.0 DP 2.
  * Fixed a bug where the `RUBYMOTION_ENV' constant would not be defined before
    executing the main scope of .rb application files, resulting in a const
    lookup error in case the constant was trying to be accessed within a file
    or module scope.
  * [iOS] Fixed a bug where `rake simulator' would open 2 simulator apps at
    the same time, due to the fact that the application name changed between
    Xcode 4.x and Xcode 5.
  * [iOS] Fixed a bug where certain NSObject methods would be missing in the
    Foundation framework compiler file.
  * [iOS] Fixed a warning message from the linker that would be displayed when
    building for iOS 7.0.
  * Fixed a bug in defined?(super) where it would return an incorrect value
    when used from an included module.
  * Improve string interpolation performance. 40% faster.
  * Improve String#delete performance. 5 times faster.
  * Improve Objective-C methods performance in String object. 50% faster.
  * Added `output=colorized' in `rake spec'.
  * Added `skip_build' option to `rake simulator' (iOS) and `rake run' (OSX) to
    to run the program without recompiling (ex. `rake skip_build=1').
  * Added git repository support for templates. (ex. `motion create
    --template=https://github.com/IconoclastLabs/smart-ios.git test').
    Thanks to Gant Laborde and Matt Garrison for the patch (pull request #92).
  * Fixed a build error that was happening with Xcode 3.
    Thanks to Matt Garriott for the patch (pull request #97).
  * Added callback after created controller in spec. Thanks to Katsuyoshi Ito
    for the patch (pull request #96).
  * Fixed the build system to set `spec_mode' before running the `setup' block
    in Rakefile. Thanks to Clay Allsopp for the patch (pull request #84).
  * Added the `app.exclude_from_detect_dependencies' Rakefile variable. Thanks
    to Clay Allsopp for the patch (pull request #81).
  * Fixed a bug in the build system where it would remove `.nib' ressource
    files even corresponding `.xib' files did not exist. Thanks to Kristian for
    the patch (pull request #98).
  * Added back `motion ri' support, which was incidentally removed due to a
    mistake on the build machine.


= RubyMotion 2.2 =
  * Added iOS 7.0 and OS X 10.9 support. Xcode 5.0 DP must be installed and
    activated as the default (using `xcode-select'). Xcode 4.x must remain in
    /Applications/Xcode.app as RubyMotion will still be using it, until we
    properly migrate to the new compilers. You can revert to Xcode 4.x (using
    `xcode-select') for stable development. *WARNING* iOS 7.0 and OS X 10.9
    are Apple confidental and cannot be discussed online. Do not post code
    using the new APIs online.


= RubyMotion 2.1 =
  * Improved the `rake simulator' (iOS) and `rake run' (OSX) tasks to honor the
    `args' environment variable, which can be used to provide command-line
    arguments that will be passed to the app executable when launching.
    (ex. rake simulator args="-com.apple.CoreData.SQLDebug 1").
  * [iOS] Improved `rake archive' to generate a `manifest.plist' file that can
    be used for Ad-Hoc distribution. Added the `app.manifest_assets' Rakefile
    variable which can be set to an array of hashes describing the assets to be
    included in the file. The default is an empty array, and no file is then
    generated. (ex. app.manifest_assets << { :kind => 'software-package',
    :url => 'http://hipbyte.com/foo.ipa' }).
  * [iOS] Fixed `rake simulator' to show a warning message in case the user is
    running tmux without `reattach-to-user-namespace', which is necessary.
  * [iOS] Fixed compilation issues with 6.0 SDK.
  * [OSX] Fixed a bug in `rake debug=1' where the debugger would not properly
    start in case the application name includes a space character.
  * [OSX] Added `rake ctags' task to generate `tags' file.
  * [OSX] Added `rake static' task to create a static .a archive file.
  * [OSX] Added `rake build' task as a shortcut for both `build:development'
    and `build:release'.
  * [OSX] Fixed `rake archive' to honor the content of the `app.entitlements'
    project variable when code-signing the binary.
  * [OSX] Added the `app.embedded_frameworks' Rakefile variable that can
    include paths to 3rd-party frameworks that should be copied in the app
    bundle's 'Frameworks' directory (ex. app.embedded_frameworks +=
    ['~/src/MyFramework.framework']). The build system will also fix the
    install name of the executable. The default value is an empty array.
  * [OSX] Fixed `rake archive:distribution' to properly codesign the app
    executable twice, necessary for App Store submissions.
  * [OSX] Fixed the Info.plist file generation to include the minimum OS
    requirement key, necessary for App Store submissions.
  * Fixed a bug in `Dispatch.once' where it would sometimes not yield the block.
  * Fixed the require statement in the `gem' template Rakefile. Thanks to
    Devon Blandin for the patch (pull request #88).
  * Fixed the `iOS' template warning message to print the right library path.
    Thanks to Tom Milewski for the patch (pull request #86).
  * Fixed a bug in `app.files_dependencies' where it would not allow a path
    containing "../" (ex. app.files_dependencies 'foo.rb' => '../bar.rb').
    Thanks to Jeremy Ruppel for the patch (pull request #90).
  * Fixed a bug in `app.vendor_project' to properly set the
    CONFIGURATION_BUILD_DIR variable for non-standard Xcode projects. Thanks to
    Jack Chen for the patch (pull request #94).
  * Fixed `app.vendor_project' with Xcode projects to rebuild the project in
    case a file changed. Thanks for Jack Chen for the idea and initial work.
  * Fixed a bug where the .gitignore file would not be generated anymore when
    creating a new project.
  * Added the .gitignore file into the `gem' template.
  * Added the BasicObject#__id__ method for CRuby compatibility.
  * Fixed a bug in `undef' and Module#remove_method where it would raise an
    'undefined method' error if the method was called before being removing.
  * Fixed a memory bug where an object would be prematurely released if an
    #initXXX method was called right from within #initialize.
  * Fixed a bug in #respond_to? where WeakRef objects would not be properly
    handled.
  * Fixed a bug in detecting file dependencies where it will not detect file
    dependencies if the files contain nested constants.


= RubyMotion 2.0 (May 2013) =
  * Added OSX development support. Use `motion create --template=osx' to create
    an OSX project. Use `rake -T' inside to see the available tasks and
    `rake config' to see the application config variables. RubyMotion OSX apps
    are built for both i386 and x86_64 architectures and can support OSX v10.7
    and v10.8 as deployment targets. Check out the HipByte/RubyMotionSamples
    repository on GitHub for sample code and the devcenter for documentation.
  * Added command-line plugin system, which lets developers extend the
    `/usr/bin/motion' command-line tool with new commands (ex. `motion foo').
    Builtin commands have been extracted as plugins and 3rd-party plugins can
    be created inside the `~/Library/RubyMotion/command' directory.
  * Added a RubyMotion gem project template. Use `motion create --template=gem'
    to create one and check `rake -T' inside to see the available tasks.
  * Added project templates system (usage: `motion create --template=xxx').
    RubyMotion comes with 3 templates: `ios' (default), `osx' and `gem'.
    3rd-party project templates can be created inside the
    `~/Library/RubyMotion/template' directory.
  * Deprecated `require "motion/project"' in project Rakefiles. Existing iOS
    projects should now require `motion/project/template/ios' instead. We
    preserve compatibility for now but please do migrate.
  * Added the `motion account' command to open the license account page.
  * Added the `WeakRef' class to create weak references. Usage is
    `WeakRef.new(obj)' and follows CRuby's WeakRef stdlib class. Passed
    references will not be retained. Use with caution as sending a message
    to a WeakRef object whose reference has been prematurely collected will
    cause a runtime crash. The `WeakRef' class will be replaced by a no-op
    once the runtime is able to deal with cyclic references.
  * Improved the detection of file dependencies to handle absolute paths.
    Thanks to Clay Allsopp for the patch (pull request #82).
  * Improved the build system by using a separate build directory for source
    files that resides outside of the project (ex. gems) in order to reduce
    the compilation time.
  * Fixed a bug where a crash would happen when calling a method defined using
    #define_method that was contained in an extended module or in an inherited
    class that includes a module.
  * Fixed a bug where a crash would happen when trying to override the
    `drawMapRect:zoomScale:inContext:' method in a MKOverlayView subclass.
  * Improve `rake spec' to display an error message if there are no spec files
    in the `spec' project directory.
  * Fixed a bug where trying to set a constant inside another constant that is
    not a Module object would not raise an exception (ex. `A=42; A::B=42').
  * Fixed a bug where Module#include? would not be raising an exception if the
    receiver was not a Module object.
  * Fixed a bug where `return' on a yielded block that used `ensure' would not
    work.
  * Fixed a bug where `catch' and `throw' would not work on an iOS device.
  * Fixed a bug where a crash would happen when using a variadic method from
    the Cocos2D framework.
  * Fixed a bug where a memory leak would happen when creating an object and
    passing an arbitrary expression to the initializer method.
  * Fixed a bug in build system where a "stack level too deep" exception could
    happen.
  * Fixed a bug when detecting file dependencies where classes or modules
    defined using the `XXX::YYY' syntax could not be properly parsed.
  * Fixed a limitation in Struct where creating a struct with more than 10
    fields was not possible. We moved the limit to 100 fields.
  * Fixed a limitation in the dispatcher where dynamically sending a message
    or yielding a block with more than 10 arguments was not possible. We moved
    the limit to 100 arguments.
  * Fixed a bug in the REPL where it would get corrupted when receiving too
    much input from the evaluator (ex. when using auto-completion).
  * Fixed a bug where a compilation error would happen when parsing a
    BridgeSupport structure that included a very large field.
  * Improved the `motion ri' command to honor the $PAGER environment variable.
  * Improved the `app.vendor_project' method to honor the :bridgesupport_cflags
    and :bridgesupport_exceptions options, which will be appropriately passed
    to the BridgeSupport generator. Thanks to Juan Karam for the patch.
  * RubyMotion is one year old! Thanks all for your support.

                          |\      _,,,---,,_
                          /,`.-'`'    -.  ;-;;,_
                         |,4-  ) )-,_..;\ (  `'-'
                        '---''(_/--'  `-'\_)


= RubyMotion 1.35 =
  * Added support for string constants defined in 3rd-party header files using
    the macro system (ex. #define MyConstant @"SomeValue").
  * Added the `no_start' option to `rake device debug=1' to let the user attach
    a custom debugger. This is for the RubyMine integration.
  * Fixed a bug in the REPL where the history could not be saved if it included
    UTF-8 characters.
  * Fixed a caching bug in Object#respond_to? which could return true for a
    method that did not exist.
  * Fixed a bug in REPL where an error message was often printed after using the
    `quit' or `exit' command.
  * Fixed a bug where the AVPlayer#currentTime method caused a `{?=qiIq}@:' not
    precompiled' error.
  * Improved `rake spec' error messages to include more details. Thanks to
    Steven Webb for the patch (pull request #68).
  * Improved `rake spec files=...' to make the `_spec' suffix optional. Thanks
    to Dave Lee for the patch (pull request #71).
  * Fixed a bug where using the AudioQueueBuffer structure would cause a crash.
  * Added the `:force_load' option for the `app.vendor_project' Rakefile method.
    This flag has a default value of `true' and can be set of `false' when
    vendoring 3rd-party libraries that include duplicated symbols.
  * Added the Dir#to_path method for CRuby compatibility.
  * Fixed a bug where calling #alias on a new method would cause a crash.
  * Fixed a bug where defining a method with #define_method on a module then
    messaging the method would cause a crash.
  * Fixed a bug where 'rake device debug=1' would cause a crash if the project
    name included UTF-8 characters.
  * Fixed a bug in the build system where framework dependencies would not
    properly be loaded.
  * Fixed a rare bug in the `super' dispatcher.


= RubyMotion 1.34 =
  * Fixed a regression where command + mouse-over would not work in the
    simulator window.
  * Fixed a regression in the build system where updated resource files would
    not be copied.


= RubyMotion 1.33 =
  * Fixed a bug where certain Float object would be losing 2-bits of precision.
    This was happening because the compiler optimized floats to fit in a 30-bit
    data structure. The runtime will now allocate 32-bit floats on the heap
    when they cannot be accurately stored as 30-bit.
  * Added a feature to support multiple resource directories. Introduced the
    `app.resources_dirs' variable which defaults to `['./resources']' and can
    be modified to specify another resource directory to the build system. The
    previous `app.resources_dir' variable is now deprecated.
  * Added a feature to automatically create the `Default-568h@2x.png' file in
    the resources directory during `motion create', in order to support 4-inch
    screens.
  * Fixed a bug in the build system where apps whose names include an UTF-8 or
    UTF8-MAC character would not compile.
  * Fixed a bug in the simulator mouse-over which could not properly select
    views if the iOS simulator was rotated.
  * Fixed a bug where the iOS simulator would not launch on OSX 10.6.
  * Fixed a bug in `NSDate.alloc.init.timeIntervalSince1970' which would cause
    a malloc_error_break error.
  * Fixed memory leaks in NSDate.new and NSDate.alloc.init.
  * Fixed a bug in Dir.entries and Dir.foreach where an exception was always
    raised.
  * Added the NSData#to_s method which is alias for NSData#to_str.
  * Fixed a bug in Hash#delete where the deleted object would be prematurely
    released by the table.
  * Fixed a bug where the iOS simulator would not launch if `app.xcode_dir'
    pointed to a path other than the '/Applications' folder.
  * Fixed a bug where the iOS simulator would be relaunched every time with
    `rake' command.


= RubyMotion 1.32 =
  * Added support for Xcode 4.6 and iOS 6.1 SDK.
  * Improved Array#hash performance.
  * Fixed a bug in IO#closed? and File#closed? where an exception wasn't raised
    if the receiver wasn't initialized.
  * Fixed a bug in IO#gets where a memory heap overrun would be triggered.
  * Fixed a bug in IO#close where it would close the wrong stream when opened
    in both read/write mode by IO#open.


= RubyMotion 1.31 =
  * Fixed a bug in Kernel.sprintf and NSDate.new which would cause a
    malloc_error_break error.
  * Added .sass-cache, .idea and app/pixate_code.rb to the default .gitignore
    file.
  * Fixed memory leaks in Complex and Rational classes.
  * Improved String#{[]=, index} performance when a String object has only
    ASCII code range characters. 5-14 times faster.
  * Improved String#{==, eql?} performance when the length of the strings do
    not match. 15 times faster.
  * Improved String#+ performance by pre-allocating heap memory.
  * Fixed a bug in MatchData where it caused a crash due to an assertion when
    used on an uninitialized MatchData object.
  * Fixex a bug in the automatic dependencies checker where it would cause a
    build error when `app.files' contained a non-flat Array.
  * Improved the automatic dependencies checker in the build system to be way
    faster. Thanks to Yury Korolev for the patch.
  * Fixed a memory crasher that would happen when symbolicating large exception
    backtraces (simulator only). Thanks to Doug Puchalski for the help.
  * Fixed a bug in `rake spec' where an ArgumentError exception would be raised
    when `it' clauses in spec files would not be defined with a block.
  * Improved the `tap' format of `rake spec' to print the number of each test
    instead of the total number, and also a better description.


= RubyMotion 1.30 =
  * Fixed a bug in the build system where it could not detect file dependencies
    using nested classes (ex. `module M; class C' and `class C2 < M::C').
  * Fixed a bug where MapKit annotation pins would disappear, because certain
    Ruby objects (in this case, MKAnnotations) would use a Bignum value as the
    return value of the `hash' method, which would not work properly when used
    within MapKit.
  * Added formatter for RubyMine tests runner. Thanks to Dennis Ushakov for the
    patch.
  * Fixed a bug in Float#hash where (-0.0).hash returned a different value with
    (0.0).hash.
  * Fixed a bug in Float#** and Fixnum#** which would return a Complex object
    when the receiver was a negative value.
  * Fixed a bug in Float#round which would return an inaccurate value.
  * Fixed a bug in Numeric#div which would not call the super `floor' method.
  * Fixed a bug in Range#step where it would return an object of the wrong type
    when a float value was given as range.
  * Fixed a bug in Range#{inspect, eql?, ==, hash} where crashes would happen
    when using cyclic range objects.
  * Fixed a bug in Range#each where it would not work if the receiver was
    created using #to_str for the beginning of the range.
  * Fixed a bug in Range#first(n) where it returned (n + 1) elements.
  * Added the Object#singleton_class method.
  * Fixed a bug in String#upto where it did not return an Enumerator object
    when a block was not given.
  * Fixed a bug in MatchData#[] where it would return a wrong value when a
    negative Fixnum object was passed as the index.
  * Fixed a bug in Regexp#options where it was returning a wrong value.
  * Fixed a bug in Range#{min, max} where it would not evaluate the block.
  * Fixed a bug in {File::Stat, Dir, StructClass}.new where it was crashing.
  * Fixed memory leaks in the following classes: Boxed classes (ex. `CGRect'),
    Pointer, Range and Time.
  * Fixed memory leaks where the following methods would return an object that
    would be leaking: Object#{dup, clone}, Time#{gm, getgm} Time._load,
    Object#enum_for, NSDictionary#{inspect, dup, to_a, keys, values, value_at,
    select, reject, merge}, NSMutableDictionary#{delete_if, select!},
    NSArray#{dup, inspect, [], select, values_at, +, *},
    NSMutableArray#{select!, uniq!}, Pointer.magic_cookie, Boxed#dup.
  * Fixed memory leaks where some internal data in following classes and
    methods would be leaking: Bignum, Random, Symbol, File::Stat, StructClass,
    Dispatch::Queue, Marshal.{dump, load}, Kernel.sprintf, Regexp.{new, quote},
    Hash.new, String#{split, count, delete, tr, tr!, tr_s, tr_s!}, Array#hash,
    Symbol#inspect.


= RubyMotion 1.29 =
  * Fixed a loading error with the ripper library when using Ruby 1.8.
  * Fixed a bug where the files that only contained constants were not detected
    by the file dependencies system.
  * Fixed a bug where cyclic file dependencies would cause a `stack level too
    deep' error.
  * Fixed a bug where detecting file dependencies would cause a build error
    when the list of files would not be given as a flat array.


= RubyMotion 1.28 =
  * Added the `motion ri' command to access to API information on command line.
    Ex: motion ri Dispatch::Queue#sync
  * Improved the build system to detect file dependencies automatically.
    This feature is experimental, if you encounter any problem you can disable
    it by setting `app.detect_dependencies = false' in the Rakefile.
  * Fixed the build system to set a 5 seconds timeout when accessing the
    software updates server. Thanks Nick Quaranto for the patch.
  * Improved `rake simulator' to honor the SIM_STDOUT_PATH, SIM_STDERR_PATH
    and SIM_WAIT_FOR_DEBUGGER environment variables, to respectively set the
    path of the stdout and stderr streams and to tell the simulator launcher
    that it should wait for a debugger before starting the application. These
    variables will be used in the RubyMine integration.
  * Fixed a bug in Dispatch::Object#dispatch_object on iOS versions below 6.0
  * Fixed a bug in NSDictionary#select which always raised an exception.
  * Fixed a bug in String#<< which raised an ArgumentError exception instead of
    RangeError if the given object was is out of range.
  * Fixed a bug in Kernel.catch when no argument was given.
  * Fixed a bug in Kernel.Rational which was not raising a TypeError exception
    if a Symbol object was passed.
  * Fixed a bug in Symbol#clone and Sybmol#dup which didn't raised TypeError
    exceptions.
  * Fixed a bug in Symbol#match and Symbol#=~ which did not properly return
    an index of the beginning match.
  * Fixed a bug in Symbol#succ and Symbol#next which returned a String object.
  * Added the following methods: Complex#rationalize, ENV#select! and
    ENV#keep_if.
  * Fixed a bug in Complex#/ which raised an exception when passed 0.0.
  * Fixed a bug in Complex.rect and Complex.polar which raised an ArgumentError
    exception instead of TypeError when a wrong value was given.
  * Fixed a bug in Regexp.last_match which raised an IndexError exception when
    an index out of the matched range was given.
  * Fixed a bug in ENV#[]= which did not raise an Errno::EINVAL exception if
    the given String object included the '=' character.
  * Fixed an error message in `rake target' when it cannot find iOS simulator.
  * Fixed a bug when using TWTweetComposeViewController's methods on iOS 6.0
    below would trigger a crash at runtime.


= RubyMotion 1.27 =
  * Fixed a bug where NSDecimalNumber.decimalNumberWithDecimal would not work
    since 1.24 in development mode, because of a regression introduced after
    changing the default set of optimization passes.
  * Fixed a bug where the `dispatch_object' method would not return a proper
    value on iOS 6.0, because it wasn't conforming to the new os/object.h
    structure.
  * Fixed a bug in `rake spec' where certain UIAutomation-based methods would
    not be callable because of a regression introduced in the previous update.
  * Fixed a bug in the compiler to compile references to C functions using the
    weak linkage. If the symbol of a C function is not available at runtime,
    the function will not be defined and respond_to? will return false.
    This fixes applications linking against AddressBook.framework on 6.0 and
    making conditional use of the new ABAddressBookCreateWithOptions().
  * Fixed a bug in the runtime where calling `super' in certain methods
    (ex. UISlider's thumbRectForBounds:trackRect:value:) would crash the
    program due to an assertion.
  * Fixed a bug in the compiler where certain structures could be returned as
    an object of the wrong class (ex. MKCoordinateRegion.region returning
    AudioValueRange instead of CLLocationCoordinate2D).
  * Fixed a bug in Object#{dup,clone} where #{initialize_dup,initialize_clone}
    would not be called.
  * Fixed a bug in Object#instance_eval where the receiver object was not
    properly yield to the block.
  * Fixed a bug in Array#== and Marshal.dump where unnecessary private methods
    were being looked up.
  * Fixed a bug in Array#{rotate,rotate!} where it would not raise a TypeError
    exception if nil was given.
  * Fixed Array#{uniq, uniq!} and NSArray#{uniq, uniq!} to support blocks.
  * Fixed a bug in Range#dup where the begin/end values were not copied.
  * Fixed a bug in Range#step which would not behave like Numeric#step if given
    a Float argument.
  * Fixed a bug in String#<< with a codepoint argument where an exception would
    be raised when called on US-ASCII/BINARY strings.
  * Added .DS_Store, temporary files and project files into the default
    .gitignore file. Thanks to Mark Rickert and Eric Summers for the patch.


= RubyMotion 1.26 =
  * Fixed a bug in the build system where the Info.plist file would not be
    generated with the right DT* values when targetting iOS 6.0. This fixes
    AppStore submissions for apps made for the iPhone 5 new retina format.
  * Fixed a bug in the build system when building .bridgesupport files where
    it would fail to process header paths including space characters.
  * Fixed a bug where the `rake static' task would not work with iOS 6.0.
  * Fixed a compiler bug when using the
    `TWTweetComposeViewController#setInitialText' method on iOS 5.1 or below
    would trigger a crash at runtime.
  * Fixed a bug in Pointer#cast! where symbol arguments could not be given to.
  * Fixed a bug where methods that take variable arguments do not call
    the appropriate function if an ArgumentError exception if raised.
  * Fixed a bug where calling super from a #define_method block would fail.
  * Fixed a bug in the compiler when compiling references to C constants which
    might already exist in the kernel module (ex. kCFBooleanTrue).
  * Fixed a bug when starting the simulator with the 'retina=true' option.
    Thanks to Scott Pierce for the patch.
  * Fixed the build system to build vendored Xcode projects into the `.build'
    directory instead of `build', as some projects come with such a directory.
  * Fixed a memory bug when calling `File.open' with a splat Array argument.
  * Fixed a regression introduced in 1.21 which prevented the OCMock framework
    to work, because the dispatcher was performing one additional selector on
    NSProxy-based receivers and OCMock counts the number of messages.
  * Fixed a bug in `rake spec' where the simulator launcher would exit with an
    error status even if the spec suite was successful.
  * Improved Hash#[]= performance when an Array is used for key to use a
    MurmurHash function instead of hashing on the length. 400 times faster.
  * Added the Pointer#value method which is alias for Pointer#[0].
  * Added the `app.framework_search_paths' variable that lets you configure
    the custom framework paths for the project build.
  * Added the `RUBYMOTION_VERSION' Ruby constant at runtime which points to the
    version of RubyMotion, as a String. Cleaned up other RUBY_ constants.
  * Added the `spec:device' Rake task which will run the spec/test suite on the
    device via the debugger.


= RubyMotion 1.25 =
  * Fixed a bug when using Objective-C properties implemented using message
    forwarding (ex. GKMatchRequest's maxPlayers).
  * Fixed a bug in build system where the app.info_plist dictionary would not
    be re-generated if app.info_plist is called before changing other settings
    (ex. app.name).
  * Fixed a bug in the build system where vendored Xcode projects (including
    projects via CocoaPods) would not be built honoring the Rakefile
    app.deployment_target variable.
  * Fixed a bug in the `rake device' debugger task where the debugger would
    fail to attach if the application name includes a space character.
  * Fixed a bug in the build system where a project whose path includes a space
    character would fail to build the second time.
  * Fixed a bug in the runtime where methods defined with `define_method' that
    are either aliased or created via a module inclusion would crash when
    called at runtime.
  * Fixed a bug in the build system where the `get-task-allow' entitlement
    which is set to true by default could not be set to false. Thanks to
    @andreas for the patch.
  * Fixed a bug in `rake simulator' where a stty-related warning would be
    printed in case the task is launched from a process where stdout is not a
    tty. Thanks to Dennis Ushakov for the patch.
  * Fixed a bug in Range's evaluation order, where the beginning part would not
    be evaluated at first (ex. (x = 0)..(x + 1)).
  * Improved the Regexp class to support octal literals and '\[hH]' matchers.
  * Fixed Math.atan2 to follow the Ruby 1.9.3 specs when both arguments are 0.0.


= RubyMotion 1.24 =
  * Added support for the GM version of the iOS 6 SDK.
  * Added support for the iPhone5 architecture (armv7s).
  * Added new values for the `retina' option of `rake simulator': `3.5' (for
    iPhone4) and `4' (for iPhone5). A `true' value will default to `3.5' in
    case the simulator target is lesser than 6.0, otherwise, `4' will be used.
  * Added debugging support (experimental) for both simulator and device.
    Simply set the `debug' parameter to any value to attach the debugger
    (ex. `rake debug=1' for simulator and `rake device debug=1' for device).
    The Ruby code compiles with relevant DWARF metadata and the debugger
    used is gdb. Note that the debugger experience is a work in progress and
    will be significantly improved in future releases.
    Check out http://www.rubymotion.com/developer-center/articles/debugging
  * Fixed the `development' mode to not compile with LLVM optimizations. This
    results in faster compilation times and also better debugging support,
    but the code might run a bit slower. The `release' mode builds with the
    entire optimization passes.
  * Added to the build system the `mode' option which can be used to specify
    the build mode, either `development' (default) or `release'. You can now
    test your app in release mode by using `rake mode=release' for simulator
    and `rake device mode=release' for device.
  * Fixed the build system not to execute the user-defined application setup
    block twice, which is no longer necessary with the new `mode' option.
  * Removed the `archive:development' and `archive:release' tasks which are
    no longer necessary with the new `mode' option.
  * Added the `archive:distribution' task which builds an .ipa with distribution
    settings (certificate, default entitlements, symbols stripped).
  * Fixed `rake spec' to produce an .app bundle that uses a different bundle
    identifier than the regular app. This is necessary in Xcode 4.5 to avoid
    simulator installation issues.
  * Fixed a bug in the simulator launcher when output to stdout would not be
    displayed in case the rake process was piped to another process
    (ex. `rake spec | ...').
  * Added the Dispatch.once method, which wraps the dispatch_once() function,
    that can be useful to implement singletons. Usage: Dispatch.once { ... }.
  * Added support for `define_method'. Like `attr_*', it cannot be used to
    overwrite existing Objective-C methods due to limitations of the compiler.
  * Fixed a bug when converting Bignum objects into 'long long' types.
  * Fixed a bug in the build system where relative source paths pointing to the
    parent directory would not properly be expanded and would trigger build
    failures.
  * Fixed several bugs in String#% related to arguments and precision format.
  * Improved String#[]= performance. 50 times faster.
  * Improved String#length performance with multibyte characters. If String
    includes multibyte characters, its length will be cached and reused.
    500 times faster.
  * Improved String#reverse performance with ASCII-compatible string. 30 times
    faster.
  * Improved Fixnum/Float modulo performance. 2 times faster.
  * Fixed memory leaks in String#{reverse, reverse!}
  * Fixed a bug when calling a method on an uninitialized Regexp object.
    (ex. Regexp.allocate.to_s).
  * Fixed a bug when calling NSArray#flatten(level) with 0.
  * Fixed bugs in NSArray#rindex, NSArray#values_at, NSArray#values_at,
    NSDictionary#values_at and Kernel.#sprintf which could raise uncatchable
    exceptions.
  * Fixed a bug in Dispatch::Source.timer which couldn't handle the
    Dispatch::TIME_FOREVER constant for interval.
  * Fixed a bug in NSArray#delete_if where nil could not be returned if the
    receiver did not change.
  * Added the following methods: NSArray#rotate, NSMutableArray#rotate!,
    NSMutableArray#sort_by!, NSMutableArray#select!, NSMutableArray#keep_if,
    NSMutableDictionary#select!, NSMutableDictionary#keep_if.


= RubyMotion 1.23 =
  * Fixed a bug where conformsToProtocol: would not return true on objects
    implemented in Ruby for protocols using required/optional sections (ex.
    AQGridView).
  * Fixed a bug in the compiler metadata file for the CMSampleBufferRef type
    which would prevent methods accepting this type to be called.
  * Fixed a bug in the runtime where certain classes (ex. Random) would create
    instances released twice, triggering malloc errors later on. Thanks to
    Hugues Lismonde for the detective work.
  * Changed `rake device' to honor the `id' environment variable that can be
    used to specify the ID of the device where the app should be installed.
    This is useful when you have several iOS devices connected on your machine
    and don't want `rake device' to deploy to the first one.
  * Fixed a bug in String#strip where certain multibyte characters would be
    considered as whitespace. Thanks to Watson for the patch.
  * Fixed vendor_project (:static) to create static libraries with an object-
    file index, which is mandatory as of Mountain Lion.
  * Fixed the build system to support nested directories containing xib and
    storyboard files. Patch by Mike Kelley.
  * Fixed a bug in the `tap' method of the `spec/ui' library to properly handle
    the `at' option. Patch by Clay Allsopp and Marc Schwieterman.
  * Added the RuntimeError#nsexception method which, in case the exception
    comes from an Objective-C method, contains the original NSException object.
    This can be useful when you need to access specific NSException-level
    information (such as the `userInfo' dictionary).
  * Fixed a bug where the REPL methods (ex. `sessions') were added on the
    Kernel module, making them available to all objects. This was causing
    collisions (ex. when creating a CoreData `Session' entity).
  * Fixed the build system to pass -fobjc-arc to the linker in case the app
    is built for the 4.3 deployment target. This is necessary so that the ARC
    runtime is properly linked into the app, when vendoring 3rd-party projects
    that are ARC-only (ex. SVPullToRefresh). Patch by Satoshi Ebisawa.
  * Fixed the build system to no longer re-build all .rb files in case the
    project's Rakefile changed.


= RubyMotion 1.22 =
  * This release adds support for iOS 4.3 and 5.0 back which wasn't present in
    1.21 due to a bug in the build system. Sorry folks!


= RubyMotion 1.21 =
  * Fixed a regression in the BridgeSupport generator in Mountain Lion where
    APIs dealing with CFTypeRef would accept or return Pointer objects instead
    of genuine objects.
  * Fixed a bug where C structures starting with a lower-case character could
    potentially be registered more than once in the runtime, leading to weird
    memory issues (ex. many cocos2d structures).
  * Fixed a bug where certain bignums (ex. ALAssetsGroupAll) could not be
    passed as `unsigned int' arguments.
  * Fixed a bug in `rake static' where the static archives would not be created
    with an object-file index, which is now mandatory in Mountain Lion.
  * Fixed a bug in the runtime where Objective-C properties implemented using
    message forwarding could not be called (ex. GKPlayer's alias or playerID).


= RubyMotion 1.20 =
  * Fixed a bug in the runtime where apps compiled for iOS5 calling into APIs
    using certain C typedefs would raise an exception in iOS6 because of an
    ABI incompatibility (introduced by clang's new enumerator_attributes
    extension).
  * Fixed a bug in the runtime where an exception would occur when Objective-C
    code would try to allocate a new instance of a class defined in Ruby using
    the +new method (ex. RestKit).
  * Fixed a memory bug in Hash.[] when a Hash was passed (ex. Hash[a:'a']).
  * Fixed a bug in certain Dispatch APIs when the main Dispatch::Queue object
    was passed causing an ArgumentError exception.
  * Fixed a bug in #public_send where an exception would not be raised if the
    method is marked private.
  * Fixed a bug when preparing blocks for libdispatch where dynamic variables
    could be prematurely collected.
  * Fixed a bug when certain methods implemented using message forwarding
    would not be properly precompiled and would be raising an exception at
    runtime (ex. UITextInputTraits enablesReturnKeyAutomatically).
  * Removed a dyld warning that was printed on stderr when generating the
    backtrace of an exception (dyld: DYLD_ environment variables being ignored
    because...). Mountain Lion only.
  * Fixed the runtime to be able to use Objective-C classes whose names start
    with a lower-case character by capitalizing the name, similar to how C
    constants and enumerations are mapped. (Ex. ICarrousel.new for the
    iCarrousel class).
  * The iOS 6.0 version of the runtime has been recompiled for iOS 6.0 Beta 3.


= RubyMotion 1.19 =
  * Fixed a compiler bug (segfault) that could happen when compiling files
    using C opaque types.


= RubyMotion 1.18 =
  * Fixed a problem introduced in 1.16 that was causing objects returned from
    certain initializers to be autoreleased twice.
  * Added the `motiondir' project variable that can be used to specify the path
    of the RubyMotion distribution (defaults to /Library/RubyMotion/lib).
    Patch by Marc Schwieterman.
  * Added support to test Storyboards in the testing layer. Patch by Marc
    Schwieterman.
  * Added the `--force-version=X' argument to `motion update' which can be used
    to downgrade to a specific version of RubyMotion. This can be useful to
    reduce bugs. Ex: motion update --force-version=1.15
  * Fixed the iOS 6.0 Rakefile to use Xcode 4.5 DP2 by default.


= RubyMotion 1.17 =
  * Removed the Bundler support as it's apparently causing issues on certain
    environments. It will be added back once we figure out the edge cases.


= RubyMotion 1.16 =
  * Fixed a compiler bug in the way certain opaque types in the CoreMIDI
    framework would not properly be handled, causing crashes at runtime.
  * Fixed a regression in the build system where spec files in nested
    directories would not be taken into account. Patch by Marc Schwieterman.
  * Bundler is now optionally required by the build system. If you use bundler,
    you do not need to require it in the project's Rakefile anymore. Patch by
    Vladimir Pouzanov.
  * Disabled exception logging when running in spec mode.
  * Fixed a bunch of memory leaks due to a bug in the compiler that was not
    properly autoreleasing objects returned from overloaded initializers.
    Thanks to Satoshi Ebisawa for the detective work.
  * Fixed a memory bug in Array that was happening when re-allocating the
    storage after a #shift call.
  * Fixed a compiler bug where C or Objective-C APIs returning 32-bit integers
    whose values cannot fix in 30-bits would not be properly converted into
    Bignum types.
  * Fixed a bug in the simulator launcher where iPad projects could be started
    in the iPad simulator but using an iPhone simulator frame.
  * The iOS 6.0 version of the runtime has been recompiled for iOS 6.0 Beta 2.


= RubyMotion 1.15 =
  * Improved the spec framework to leverage UIAutomation's functionality. This
    lets you write functional tests on views and controllers by using the same
    event generators, but in pure Ruby (and not Javascript).
    Check http://www.rubymotion.com/developer-center/articles/testing for more
    information about the new API. Feature contributed by Eloy Duran.
  * Introduced spec helpers. `rake spec' will now honor the files inside the
    `spec/helpers' directory (if it exists) and compile them before the spec
    files.
  * Introduced the `files' option to `rake spec', which can be used to filter
    the spec files that should be run. Filters can be either the basename of
    a spec file or its full path, and are separated by a comma.
    Example: rake spec files=main_spec,kvo_spec,spec/foo_spec.rb
  * Introduced the RUBYMOTION_ENV constant in the runtime which can have one of
    the following string values: 'test', 'development' and 'release'.
  * Introduced the `rake static' task which creates a universal static library
    containing the project's object files and the RubyMotion runtime, which is
    suitable for inclusion in Objective-C/Xcode projects.
  * Introduced weak frameworks support. The `app.weak_frameworks' setting can
    be set to an array of framework names, similar to how `app.frameworks'
    works (ex. app.weak_frameworks += ['Twitter']). Patch by Satoshi Ebisawa.
  * Fixed a bug in the build system where  files within symlinks inside of the
    resources directory would not be copied. Patch by Nick Quaranto.


= RubyMotion 1.14 =
  * Fixed a bug in the Struct class where certain instances would be released
    twice and triggering a malloc error.
  * Fixed a bug where aliasing a method generated by attr_* would trigger an
    assertion at runtime when being called.
  * Fixed a bug where calling methods generated by attr_* from Objective-C
    would return NSNull instead of nil in case the attribute is nil.
  * Fixed a bug in the random number generator where the generator would not be
    properly initialized in certain cases (ex. Array#sample), therefore always
    returning the same values.
  * Fixed a bug where using C structures containing bitfields (ex. NSDecimal)
    would trigger an exception at compilation time.
  * Added support for pointers to C strings (needed for glShaderSource()).
    Usage: Pointer.new(:string, n) where n is the number of C strings, then
    simply assign Ruby strings with #[]=.
  * Changed the runtime to log all raised exceptions via NSLog(). This behavior
    can be controlled via the Exception.log_exceptions variable (which is true
    by default, but can be set to false).
  * Introduced new project variables: short_version, background_modes and
    status_bar_style. Patch by Francis Chong.


= RubyMotion 1.13 =
  * Fixed a regression in `rake simulator' introduced by the last update.
    Also, the environment variable used to set the SDK target is renamed to
    `target' (ex. rake target=4.3).
  * Fixed a bug in the build system where certain .rb files would be rebuilt
    every time `rake build' was executed, because the object directory was not
    touched.
  * Fixed a bug in the build system where the RUBYOPT variable would not be
    cleared when calling the gen_bridge_metadata tool, which would cause some
    issues later on. Patch by Satoshi Ebisawa.


= RubyMotion 1.12 =
  * Fixed a bug where sending an `init' message alone (without using `alloc'
    before) would lead to a memory crash. This was possible when overloading
    an initWith* method and doing `self.init' inside.
  * Fixed a bug where performing Objective-C methods that accept CFType objects
    would crash the program (ex. [ABPersonViewController setDisplayedPerson:]).
  * Switched to clang++ to link the executable bits. This fixes linker crashes
    on iOS 6.0.
  * Added `fast' output for `rake spec'. Fixed a bug in the other outputs.
    Patch by Marin Usalj.
  * Improved the build system to let the user specify CPU archs that should be
    used for a certain platform. The `app.archs' method returns a Hash that one
    can tweak. This is so far only useful when you target 4.3 (which is armv6
    and armv7) and want to link with a 3rd-party library that only supports
    armv7 (ex. app.archs['iPhoneOS'] = ['armv7']).
  * Improved `rake simulator' to honor the `deployment_target' environment
    variable (ex. rake deployment_target=4.3). Patch by Satoshi Ebisawa.
  * Fixed a bug in the build system where the compiler would not use the right
    BridgeSupport files when using a lower deployment_target.
    Patch by Satoshi Ebisawa.
  * Fixed the build system to re-link the .app executable in case one of the
    vendored libraries changed.
  * Fixed bugs in both ARM/simulator compilers where structures smaller than
    64 bits would not be following the ABI and causing unexpected behavior in
    certain cases (ex. cocos2d). Thanks to Aaron Hurley for the detective work.
  * Removed Kernel#select as it clashes with a private `select' method defined
    by iOS and triggered when hitting the select button in a paste action.
    Thanks to Francis Chong for the detective work.


= RubyMotion 1.11 =
  * Fixed a bug where the runtime would not allow `nil' to be passed as a
    C-level block argument.
  * Fixed a bug where methods defined by attr_* would abort the program when
    called by Objective-C.
  * Improved `rake spec' to honor the `output' environment variable, which can
    be used to select a different output format. Available formats: spec_dox,
    test_unit, tap and knock (ex. rake spec output=test_unit).
  * Support for the iOS 6.0 Beta 1 SDK can be generated after having installed
    Xcode 4.5 by typing the following command:
    $ cd /Library/RubyMotion/data/6.0; rake update


= RubyMotion 1.10 =
  * Fixed the build system to validate the content of the `app.icons' variable,
    since a wrong value may trigger an "unrecognized selector" exception in
    Application Loader when trying to submit the app to the App Store.
  * Fixed the Rakefile created by `motion create' to include the magic utf8
    comment, as the file may contain multibyte characters and be parsed by
    Ruby 1.9. Patch by @pchw.
  * Fixed a memory bug when using symbols as Hash keys.
  * Exposed iOS 4.3 (or greater) libdispatch APIs.
  * The following NSString methods that used to raise a "does not work on
    NSStrings" exception are no longer defined: byte_size, get_byte, set_byte,
    force_encoding, valid_encoding?, ascii_only?, bytes, each_byte, to_data,
    pointer. This allows the developer to use respond_to?. These methods
    however are available on strings created in Ruby.
  * Fixed a bug in `rake simulator' where the value of `deployment_target'
    would be used as the SDK version, causing a `system_root != nil' assertion
    in some cases.
  * Fixed the compilation of empty symbols (:'').
  * Fixed the generation of .bridgesupport files on Snow Leopard by not
    passing the '--no-64-bit' flag (which was added in Lion).
  * Fixed `motion create' to accept dash or underscore characters in the app
    name. Patch by Mark Villacampa.
  * Added a workaround for an iOS 5.1 bug that causes write(2) to return EBADF
    when writing to stdout. The bug seems to happen on devices not configured
    for development. Writing to stdout (using p/puts) in this scenario becomes
    a no-op.
  * Fixed the simulator launcher to properly propagate exit(2) status codes
    from the simulated app. This fixes `rake spec' to properly exit with 1 in
    case one or more specs failed to run.
  * Fixed the RUBY_ENGINE constant to be 'rubymotion' (was 'macruby' before).
  * Objective-C objects conforming to the NSFastEnumeration protocol can now be
    iterated using the #each method. The method is created on demand on these
    objects.
  * Fixed a bug in the simulator REPL where hitting the Home button would
    trigger an insane CPU usage.


= RubyMotion 1.9 =
  * Fixed a bug in the build system where the paths of vendored libraries
    would not be properly quoted and cause a build failure in case they
    contain space characters.
  * Fixed a bug in the build system where using a lower deployment_target
    version would cause a link error at runtime because the application was
    linking against a framework that does not exist (ex. CoreImage on 4.3).
  * Fixed the `rake spec' task to not move the simulator window to the
    foreground.
  * Fixed a bug in the compiler where APIs accepting pointers to
    CoreFoundation types could not be given Pointer objects of the :object
    type (ex. CFErrorRef*).
  * Added support for CoreAudio (experimental). At the very least, constants
    pointing to four-bytes characters should be properly covered.
  * Fixed a typo in "expected array of %d elements, got %d" exception message
    where the numbers were inverted. Thanks Enrico Thierbach.
  * Fixed a bug in the compiler where compiling strings containing only null
    characters (ex. "\x00") would cause a crash.


= RubyMotion 1.8 =
  * Fixed a bug in the generation of BridgeSupport files for multiple headers
    directories.
  * When building vendored projects, unset environment variables that could
    potentially make the build to fail.
    https://github.com/HipByte/motion-cocoapods/issues/12


= RubyMotion 1.7 =
  * Fixed a bug in the compiler where the proper signature would not be used
    when defining informal protocol methods with CF types as arguments.
  * Fixed iOS constants to be looked up at demand (when being used) and not
    when the app starts, because certain constants are not set until a certain
    API is called (ex: the kAB... constants of the AddressBook framework).
    This change should also speed up a little bit the app starting time.
  * Fixed a bug in the compiler where very long selectors would be truncated
    and causing exceptions later at runtime.
  * Fixed a bug in the compiler where memory-related selectors (alloc, dealloc,
    retain, release, etc.) could not be defined in Ruby.
  * Fixed a bug in the compiler where NSObject instance methods could not be
    called on classes (ex. MyClass.performSelector(...)).
  * Fixed a bug in the build system where vendored 3rd-party APIs dealing with
    types defined in iOS headers could not be used (ex: enums or structs).


= RubyMotion 1.6 =
  * Fixed a regression in the build system introduced by the previous update
    (when compiling .xib files).
  * Fixed the vendoring system to include all source code files. Merged patch
    from https://groups.google.com/d/msg/rubymotion/tPCxSMCA2f4/w2DIHFo2AVAJ
  * Fixed the REPL to not crash if you give it an empty expression.


= RubyMotion 1.5 =
  * Improved the REPL to support multi-line expressions.
  * Fixed a bug when compiling Core Data model files where the `momc' utility
    was not given absolute paths.
  * Removed legacy MacRuby code that was using the private `isaForAutonotifying'
    selector and causing a warning during an App Store submission.
  * Fixed a bug in Enumerable#sort_by that would lead to a crash.
  * Fixed a bug in the REPL where it would not detect the iOS Simulator window
    if certain windows were in front or created later.
  * Fixed a bug in the build system where framework dependencies would not be
    properly handled.
  * Added support for .lproj directories (i18n). Thanks Aaron Hurley.
  * Fixed a bug where objects from pure Ruby classes sent to KVO would not be
    properly handled later (because KVO inserts a new singleton class).
  * Fixed attr_writer to emit KVO notifications (will/didChangeValueForKey).


= RubyMotion 1.4 =
  * Added support for the compilation of .xcdatamodeld and .storyboard resource
    files. Thanks Ian Phillips, Andrew Vega and Michail Pishchagin.
  * Fixed a bug when the build system would fail in case the resources dir does
    not exist. Thanks Watson.
  * Fixed a bug in the Xcode project vendoring code when header files at
    different directory levels would not be properly handled. This also fixes
    the motion-cocoapods gem. Thanks Eloy Duran.
  * Added a way to start the simulator in retina mode by setting the `retina'
    environment variable to `true' (other values will be considered false).
    For example: `rake retina=true'. Thanks Marcin Maciukiewicz for the idea.
  * Fixed an ABI bug in the way we compile Ruby methods overloading Objective-C
    methods returning small C structures that can fit in a 64-bit integer.
    Thanks Kristoph Cichocki-Romanov for the report.
  * Added support for the iOS 4.3 SDK.


= RubyMotion 1.3 =
  * Fixed a bug in format strings with width / precision modifiers.
  * Disabled the automatic loading of motion- gems.
  * Added support for the compilation of Interface Builder resource files.
    .xib files present in the `resources' directory will be compiled to .nib
    files then copied in the app bundle. .nib files are added to the default
    .gitignore and removed during `rake clean'. Thanks Ian Phillips.
  * Improved the `rake device' error message to mention that Wi-Fi sync might
    cause device deployments to fail.
  * Fixed a bug in NSArray#reject where the new array would not be returned.


= RubyMotion 1.2 =
  * Fixed a couple bugs in the project vendoring code that would be triggered
    when using the motion-cocoapods gem. The fixes were merged from the
    https://github.com/HipByte/motion-cocoapods/issues/1 discussion.
  * Fixed codesign bugs in `rake archive:release'.
  * Improved the Xcode detection code by printing a warning message in case
    the user installed a recent Xcode in /Applications that has not been
    set as the default Xcode in the system yet.
  * Fixed a typo in the REPL help message (thanks Mike Clark).


= RubyMotion 1.1 =
  * Fixed `rake device' to print a human-readable error message in case the
    deployment might fail because another process is connected to the device.
  * Fixed a bug in `rake simulator' where view detection would not work on
    non-English desktops (error "Cannot locate the Simulator app").
    Make sure to exit the Simulator app after applying this update.


= RubyMotion 1.0 =
  * First release.