Miele-LXIV Build System

The purpose of this project is to assist in setting up and configuring all dependencies for the project Miele-LXIV.

In other words, the goal of this project is NOT to build Miele-LXIV, but to create and configure the Xcode project that builds Miele-LXIV.

The directory where this README.md file has been downloaded shall be referred to as EASY_HOME

Additionally, you must define the three top-level directories involved in the process (or conveniently accept the suggested defaults in STEP 1 below):

sources: SRC where all the source files will be downloaded
build: BLD temporary location for intermediate files
install: BIN the Xcode project will reference 3rd party modules installed here

Prerequisite tools:

kconfig-mconf

This is a tool normally used in Linux systems to rebuild the kernel with a custom configuration. It was chosen because it creates configuration files that work well with shell scripts.
It's probably possible to install it from sources, and the dependencies can be installed using brew (gperf ncurses flex bison).
Instead, I found it very convenient to install it like in the NuttX project:
```
$ mkdir -p $SRC/nuttx
$ cd $SRC/nuttx     

$ cd $SRC/nuttx/tools/kconfig-frontends
$ ./configure --disable-shared --enable-static --disable-gconf --disable-qconf --disable-nconf --disable-utils
$ make
$ sudo make install
$ which kconfig-mcon
```
wget
cmake

CMake is the GUI application, whereas cmake is the CLI utility that we need. If the command $ which cmake doesn't return anything, you can install it either with brew:
```
$ brew install cmake
```
or from the GUI package:
```
$ sudo "/Applications/CMake.app/Contents/bin/cmake-gui" --install
```

STEP 1: Once-only configuration

Assuming the file $EASY_HOME/seed.conf hasn't been created yet, do the following:
```
$ cd $EASY_HOME
$ ./build.sh
```
If you are brave or have the need for it, define and select your own version set file. I suggest you don't change anything, to get a default, tried and tested setup.
- Save, Ok, Exit
- Exit

STEP 2: Download sources

This is also a step that should be run once only:
```
$ ./reconfigure.sh
```
- enable "Download sources" and possibly disable all other steps
- Save, Ok, Exit
- Exit
Run the shell script that carries out the downloads:
```
$ ./build.sh
```

STEP 3: Build and install the toolkits

If everything goes smoothly this step is also done once only:
```
$ ./reconfigure.sh
```
- If "Download sources" is enabled, disable it: you don't want to download everything again.
- Enable: Configure, Build, Install
- Save, Ok, Exit
- Exit
Run the shell script. This step will run for about one hour. To capture possible errors and warnings, save the output to a log file:
```
$ script log/$(date +%Y%m%d_%H%M).txt
$ ./build.sh ; exit
```

STEP 4: Make installed toolkits available to Xcode project

This step sets up the Binaries directory of the Xcode project
```
$ ./reconfigure.sh
```
- Enable only "Create Symbolic links"
- Save, Ok, Exit
- Exit
Run the shell script.
```
$ ./build.sh
```

STEP 5: Final "workaround" for Xcode

While STEPS 1..4 are nicely engineered to configure the project, there still remains some fixup to be done manually. This extra step will soon disappear, being replaced by a more elegant behind the scenes action. For the time being, please make the effort of doing what is explained in the link below.

version-set-8.8

Conclusion

Now the goal of setting up the Xcode project that builds Miele-LXIV has been reached. You should be able to build the application from Xcode, make your modifications to the source files, and start your usual development cycle.
If you prefer to work from the Command line, open up Terminal and re-build the project like this:
```
$ xcodebuild -configuration Development -target miele-lxiv
```
Note that one of the advantages of building the Development version is that it will NOT be sandboxed.
If you want to reclaim some disk space you can safely remove the miele-... subdirectory in $BLD.

bettar / miele-lxiv-easy

readme