react-native/breaking-changes.md

# Breaking Changes

**Breaking changes are now tracked as part of [Release Notes](https://github.com/facebook/react-native/releases)**.

## 0.16

- Touch events on Android now have coordinates consistent with iOS: [0c2ee5](https://github.com/facebook/react-native/commit/0c2ee5d480e696f8621252c936a8773e8de9f8b6)
- YellowBox enabled by default: [8ab518](https://github.com/facebook/react-native/commit/8ab51828ff077ae0ad10c06f62f9f01d58b9bf85)
- React Native now uses Babel 6 (props to tadeuzagallo for upgrading!). We've been using React Native with Babel 6 at Facebook for quite a while now. Nevertheless, please report any errors related to Babel, such as transforms for some JS features not working as expected and we'll fix them.
- Decorators won't work until [T2645](https://phabricator.babeljs.io/T2645) lands in Babel.
- Exporting default class that extends a base class won't work due to Babel's [T2694](https://phabricator.babeljs.io/T2694).

## 0.15

- React Native now uses [React 0.14](http://facebook.github.io/react/blog/2015/10/07/react-v0.14.html); see the linked blog post for a changelog (at this time, the package split has not been made in RN (i.e., please continue to use `require('react-native')`) and refs to native components have not changed)

## 0.14

- D2533877: `react-native bundle` API changes:
  - API is now `entry-file <path>` based instead of url based.
  - Need to specify which platform you're bundling for `--platform <ios|android>`.
  - Option `--out` has been renamed for `--bundle-output`.
  - Source maps are no longer automatically generated. Need to specify `--sourcemap-output <path>` option to indicate where to put the source maps.
- D2538070:
  - The `--minify` option is now infered based on the `--dev` value. To get a production minified bundle use `--dev false` as `--dev` defaults to true.
- [28f6eb](https://github.com/facebook/react-native/commit/28f6eba22d5bd3dfead3a115f93e37f25b1910ca): `removeClippedSubviews` now defaults to `true` on `ListView`. This is generally the behavior people expect from `ListView` so we're making it default to `true`. If you see any issues please report them.
- [82fad3](https://github.com/facebook/react-native/commit/82fad33af7dac32cd556eea35674aca4dc707f71): Remove redundant script to start packager, it can still be started using `react-native start` or `npm start`
Breaking change: Move `bundle` to `private-cli` Summary: @public We need to start using the `private-cli` for the new asset system. Note this is a breaking change! People will have to upgrade their workflows/scripts to start using the new cli. Otherwise we'd need to build a thin adapter that is aware of both APIs which is something we;d like to avoid. The major API changes are: - API is now `entry-file` based instead of `url` based. - /s/--out/--bundle-output - /s/--out/--sourcemap-output Also these parameters have no longer default values, you need to specify them. For instance, if you want to generate the sourcemaps you need to pass in the `--sourcemap-output` option Lastly, additional project roots or asset roots need to be specified on the `rn-cli.config.js`. Reviewed By: @frantic Differential Revision: D2533877 fb-gh-sync-id: a45f9095fdf9442a9106ea7bb6a6b7f651d25273 2015-10-13 17:44:00 +00:00			`# Breaking Changes`

Update breaking-changes.md 2016-01-16 21:56:57 +00:00			`Breaking changes are now tracked as part of [Release Notes](https://github.com/facebook/react-native/releases).`
Update breaking-changes.md 2015-12-10 15:25:49 +00:00
Update breaking-changes.md 2015-11-23 17:32:59 +00:00			`## 0.16`

Update breaking-changes.md 2015-11-24 15:30:29 +00:00			`- Touch events on Android now have coordinates consistent with iOS: [0c2ee5](https://github.com/facebook/react-native/commit/0c2ee5d480e696f8621252c936a8773e8de9f8b6)`
			`- YellowBox enabled by default: [8ab518](https://github.com/facebook/react-native/commit/8ab51828ff077ae0ad10c06f62f9f01d58b9bf85)`
Update breaking-changes.md 2015-11-24 15:29:14 +00:00			`- React Native now uses Babel 6 (props to tadeuzagallo for upgrading!). We've been using React Native with Babel 6 at Facebook for quite a while now. Nevertheless, please report any errors related to Babel, such as transforms for some JS features not working as expected and we'll fix them.`
Update breaking-changes.md 2015-11-24 17:19:46 +00:00			`- Decorators won't work until [T2645](https://phabricator.babeljs.io/T2645) lands in Babel.`
Update breaking-changes.md 2015-11-25 13:41:40 +00:00			`- Exporting default class that extends a base class won't work due to Babel's [T2694](https://phabricator.babeljs.io/T2694).`
Update breaking-changes.md 2015-11-23 17:32:59 +00:00
Update breaking-changes.md 2015-10-28 01:00:36 +00:00			`## 0.15`

Update breaking-changes.md 2015-11-10 20:17:10 +00:00			- React Native now uses [React 0.14](http://facebook.github.io/react/blog/2015/10/07/react-v0.14.html); see the linked blog post for a changelog (at this time, the package split has not been made in RN (i.e., please continue to use `require('react-native')`) and refs to native components have not changed)
Update breaking-changes.md 2015-10-28 01:01:01 +00:00
Breaking change: Move `bundle` to `private-cli` Summary: @public We need to start using the `private-cli` for the new asset system. Note this is a breaking change! People will have to upgrade their workflows/scripts to start using the new cli. Otherwise we'd need to build a thin adapter that is aware of both APIs which is something we;d like to avoid. The major API changes are: - API is now `entry-file` based instead of `url` based. - /s/--out/--bundle-output - /s/--out/--sourcemap-output Also these parameters have no longer default values, you need to specify them. For instance, if you want to generate the sourcemaps you need to pass in the `--sourcemap-output` option Lastly, additional project roots or asset roots need to be specified on the `rn-cli.config.js`. Reviewed By: @frantic Differential Revision: D2533877 fb-gh-sync-id: a45f9095fdf9442a9106ea7bb6a6b7f651d25273 2015-10-13 17:44:00 +00:00			`## 0.14`

			- D2533877: `react-native bundle` API changes:
			- API is now `entry-file <path>` based instead of url based.
			- Need to specify which platform you're bundling for `--platform <ios\|android>`.
			- Option `--out` has been renamed for `--bundle-output`.
			- Source maps are no longer automatically generated. Need to specify `--sourcemap-output <path>` option to indicate where to put the source maps.
Update breaking-changes.md 2015-10-14 23:14:40 +00:00			`- D2538070:`
			- The `--minify` option is now infered based on the `--dev` value. To get a production minified bundle use `--dev false` as `--dev` defaults to true.
Update breaking-changes.md 2015-10-20 18:20:16 +00:00			- [28f6eb](https://github.com/facebook/react-native/commit/28f6eba22d5bd3dfead3a115f93e37f25b1910ca): `removeClippedSubviews` now defaults to `true` on `ListView`. This is generally the behavior people expect from `ListView` so we're making it default to `true`. If you see any issues please report them.
			- [82fad3](https://github.com/facebook/react-native/commit/82fad33af7dac32cd556eea35674aca4dc707f71): Remove redundant script to start packager, it can still be started using `react-native start` or `npm start`