Differences

This shows you the differences between two versions of the page.

--- manual:chapter1:buildfromsource [2018/01/01 20:46]
claudio
+++ manual:chapter1:buildfromsource [2018/01/03 12:24]
claudio [Building the Desktop simulator]
@@ Line 24: / Line 24: @@
-Time to install the Qt framework, go to [[http://qt-project.org]] and download the open source version. It will download a file named 'qt-unified-....', change the permissions to allow executing it as a program and run it to install Qt.
+Time to install the Qt framework, go to [[http://qt-project.org]] and download the open source version. It will download a file named 'qt-unified-....', change the permissions to allow executing it as a program and run it to install Qt.\\
 When it's time to select components, it's very important to open the lists and select a library version and target. **The installer will not select a library version by default**, and failing to select one will leave you without a proper library and unable to build newRPL. Select the latest Qt version (5.10.0 at the time of this writing), the only component needed is the one labeled "Desktop gcc 64-bits". Make sure at least that component is checked.
@@ Line 106: / Line 106: @@
 ===== Building the Desktop simulator =====
-Open Qt Creator, select Open Project, and go into newrpl-sources, then select the newrpl-comp.pro project file.
+Open Qt Creator, select Open Project, and go into newrpl-sources, then select the newrpl-ui.pro project file.
 When prompted, just click on 'Configure project'.
@@ Line 148: / Line 148: @@
 If you see that line, everything went well, and your build directory (usually named build-newrpl-fw-Desktop....) will contain the newrplfw.bin file, which is the ROM that needs to be flashed on the calculator.
+===== Updating the source tree to a new version =====
+When updates are made to the source tree, open a terminal session and go inside the main source directory (usually newrpl-sources), and issue:
+git pull
+This will update the source code to the lastest version. Open QtCreator and open the newrpl-comp.pro project. On the  Build menu, "Run QMake" then "Rebuild all". Check the compile output to make sure the new version was copied to newrpl/tools-bin, if not then repeat the steps "Run QMake" and "Rebuild all".
+With the updated compiler in place, close all projects, open newrpl-ui.pro and do "Run QMake" then "Rebuild all". The "Run QMake" step is not optional, needs to be manually executed to make sure the build number is updated, otherwise the VERSION command will report the incorrect build number.
+Finally, close all projects and open newrpl-fw.pro (or the equivalent for other hardware targets), and also "Run QMake" and "Rebuild all".