Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Tweaked Upgrade Guide
  • Loading branch information
ilexp committed Nov 17, 2018
1 parent 3fd4c97 commit 20e1aa4
Showing 1 changed file with 3 additions and 2 deletions.
5 changes: 3 additions & 2 deletions pages/v3/Changelog.md
Expand Up @@ -43,8 +43,9 @@ If you do choose to upgrade an existing project, here's a rough guideline on the
1. **Update all packages to the latest v3 version**. You can use the Package Manager UI in the editor to do this. Apply the installed updates and let the editor restart itself.
1. **Fix and compile your game plugin** and all other custom plugins with the new v3 Duality dependencies. If you are unsure why something that worked before no longer compiles, take a look at the full changelog and especially the new [v3 sample source code](https://github.com/AdamsLair/duality/tree/29a8a9f4e74e2d158fe3dd558f5037e7f53c23b5/Samples) to find out how you need to adapt your code to v3.
1. **Fix your game resources**. With the editor `Log View` open and clear of errors, select resources in the `Project View` to check if they load correctly. If they don't, errors will be logged.
- The most common error will be unresolved type names, as some Duality types were renamed, or moved to a different namespace. To fix them, you can do a Find / Replace operation over all resource files in the `Data` directory.
- The second most common error will be structural changes in Duality resources. In those cases, you will have to re-import, re-configure or re-create the resources manually in the editor. Affected resources are: `Font`, `Material` and `ShaderProgram`, which was merged into `DrawTechnique`.
- The most common error will be unresolved type names, as some Duality types were renamed, or moved to a different namespace. Some of them can be fixed via Find / Replace in the resource file with a text editor, others have no equivalent in v3 and should be read as a note to manually check on the affected resources and objects.
- The second most common error will be structural changes in Duality resources. In those cases, you will have to re-import, re-configure or re-create the resources manually in the editor. Especially `Font` resources are affected, and `ShaderProgram` resources no longer exist at all, as they were merged into `DrawTechnique`.
1. **Check Scene and Prefab content** for errors, such as missing animations, a wrong camera setup or slightly off depth sorting. Fix those errors manually.
1. **Re-Serialize all game resources** using the top right editor menu to ensure all game data is now up-to-date.

After you completed all of the above steps, you project should now be fully ported to v3.
Expand Down

0 comments on commit 20e1aa4

Please sign in to comment.