Version: 2018.2 (switch to 2018.3b or 2017.4)
Upgrading to Unity 2017.2
Upgrading to Unity 5.6
Other Versions

Upgrading to Unity 2017.1

This page lists any changes in 2017.1 which might affect existing projects when you upgrade from earlier versions of Unity.

For example:

  • Changes in data format which may require re-baking.

  • Changes to the meaning or behavior of any existing functions, parameters or component values.

  • Deprecation of any function or feature. (Alternatives are suggested.)


UnityWebRequestTexture.GetTexture() nonReadable parameter change

This convenience API had a bug where nonReadable worked the opposite way then it should, that is setting it to true would result in a readable texture and vice versa. Now this has been corrected and parameter works the way it’s documented. Note, that if you create DownloadHandlerTexture directly, you are not affected.


Particle SystemA component that simulates fluid entities such as liquids, clouds and flames by generating and animating large numbers of small 2D images in the scene. More info
See in Glossary
Stretched BillboardA textured 2D object that rotates as it, or the Camera, moves so that it always faces the Camera. See Billboard RendererRenders Billboard Assets, either from a pre-made Asset (exported from SpeedTree) or from a custom-created file that you create using a script at runtime or from a custom editor, for example. More info
See in Glossary

See in Glossary
Pivot parameter change

X axis pivots are now accurate on Stretched Billboards. You may need to reconfigure your pivot settings on affected projects.

Y axis pivots are also accurate now and Unity automatically reconfigures these pivots when you upgrade your project.


ShaderA small script that contains the mathematical calculations and algorithms for calculating the Color of each pixel rendered, based on the lighting input and the Material configuration. More info
See in Glossary
macro UNITY_APPLY_DITHER_CROSSFADE change

The macro was used for implementing the screendoor dithering effect for LODA system for building multiplayer capabilities for Unity games. It is built on top of the lower level transport real-time communication layer, and handles many of the common tasks that are required for multiplayer games. More info
See in Glossary
cross-fading objects in the fragment shaderThe “per-pixel” part of shader code, performed every pixel that an object occupies on-screen. The fragment shader part is usually used to calculate and output the color of each pixel. More info
See in Glossary
. Previously you would need to pass the entire fragment IN structure to it. Now you only need to pass the screen position vector to it.

Remember that since 2017.1 the new dithercrossfade option is added for #pragma surface directive which can automatically generate the dithering code.



* 2018–04–12 Page amended with no editorial review

Did you find this page useful? Please give it a rating:

Upgrading to Unity 2017.2
Upgrading to Unity 5.6