Moving from Zerynth r1.0.* to version r2.0.0 some precautions must be taken to avoid incurring in problems. In particular the following recommendations should facilitate the migration:
- In Windows, previous Zerynth installation is disabled but not deleted
- In Mac OS X, the Zerynth folder has changed
- Linux has some dependencies to be satisfied
- Existing projects must be migrated manually
- Remote projects must be downloaded and then migrate manually
Zerynth r2.0.0 is installed in the same folder of the previous installation (usually
C:/Program Files/Zerynth) overwriting the startup file Zerynth.exe. However, all data, packages and configuration files are installed under
C:/Users/username/zerynth2 (or similar) leaving the previous installation untouched (under
C:/Users/username/zerynth). Therefore to go back to Zerynth r1.0.* is sufficient to reinstall and no data will be lost. It is also possible, but not suggested, to rename
C:/Program Files/Zerynth to something else before updating to r2.0.0 in order to keep the old Zerynth.exe.
Mac OS X Issues¶
In Zerynth r2.0.0 the folder containing configuration files, data and packages has changed from
~/.zerynth2/. Since folders starting with a dot are hidden, if needed it is possible to browser it by opening the Finder, pressing Cmd+Shift+G and typing the path manually.
To complete the installation it is necessary for xz utils to be present in the system. Moreover, multilib support is needed to execute the gcc compiler for ARM that comes in a 32 bit fashion only.
Zerynth r2.0.0 completely changes the way of managing projects. They can be saved anywere as a folder with source files and it is up to the user to keep them in order. Therefore, existing projects can not be opened by the new Zerynth. They can however be easily imported manually. Old projects can be found:
Projects are saved under folders with long alphanumeric names (uuids). To manually import such projects:
- Create a new project in Zerynth Studio r2.0.0
- Select all the old project files (and folders) in the system File Manage (Explorer, Finder, etc...) and drag them on the current project view in Zerynth Studio. Alternatively, since a Zerynth r2.0.0 project is a folder, files can be dropped in there directly and Zerynth Studio will refresh accordingly