In this Tutorial, I would help you to update your project created with the ADF Yeoman app generator. Many people have asked on our gitter channel which are the correct steps to update from versions 1.3.0/1.4.0 to version 1.5.0.
In order to understand the possible ways to update a project I did some different experiments with old projects and I finally find out the following two different approaches:
Automatic update of the project using the Yeoman Generator.
Manually update the project.
If you are not using a versioning system on your project I suggest you to execute backup copy of it before to following one of this approach.
1. Automatic update of the project using the Yeoman Generator
If your application is mainly just the output of the generated app, you can try to follow those steps:
At this point, the generator could have maybe overwritten some of your changes. Remember to check the differences with the original source code (this is one of the reasons you should use a versioning system) and, if this is the case, retrofit the changes. Once done, it's time to start the application using the npm run start command.
After starting the app, if everything is working fine, that's all and you don't need to do anything else. On the contrary, if you have bugs and nothing really work, recover the original version of the project and try the manual approach.
2. Manually update the project
Considering that a project generated using the scaffolder is probably customized, its automatic update could not be an option. The following method is more chirurgical and would request a bit of elbow grease. Here (in a gist repository) you can find all the following modifications to the source code.
Below a brief description of the changes for each file.
In the package.json file are specified all the versions of the npm packages used by your project. In this file, you will find two different sections: the development dependencies and the project dependencies. For more information about package.json you can refer to the NPM official documentation.
To update the project, modify the following dependencies to the new version.
The tsconfig.json file specifies the root files and the compiler options required to compile the project. You need to completely replace your currently tsconfig.json with the new below tsconfig.json. For more information about this file, you can refer to the official typescript documentation.
In the app.modules.ts class is described how the application parts fit together. Every application has at least one Angular module, the root module that you bootstrap to launch the application. Because we started to move from material design lite to the official @angular material components library, you need to import it inside your modules.