migrate-to-v0.6.md

Migrate from v0.5 to v0.6

Heta compiler of version 0.6 follows the Heta standard of version 0.4.

The new Heta specifications has several incompatibilities. To use the newer Heta compiler you should make some updates to thee platform files. To see the other updates see change log.

You don't need it for newly created platform.

Update platform

1. Check that your platform can be build without errors in the current builder v0.5.x.

   If you use Git you should commit the latest changes before updating formats.

2. Install the latest version of Heta compiler.

   npm install -g heta-compiler

3. If you use declaration file platform.json update the property builderVersion: ^0.6.0.

   {
       "builderVersion": "^0.6.0",
       "id": "my-platform",
       "notes": "platform notes",
       "version": "v0.1.0",
       ...
   }

4. If you use qsp-units.heta substitute it by the downloaded file qsp-units.heta

5. Update the @UnitDef instances by #defineUnit action.

   // version 0.5
   Da @UnitDef { units: g/mole };  
   

   // version 0.6
   Da #defineUnit { units: g/mole };
   

6. Now the numeration of sheets in module of XLSX type starts from zero. Update the code if you use them.

   include statement for xlsx type

   // version 0.5
   include table.xlsx type xlsx with { sheet: 1, omitRows: 3 }
   include table.xlsx type xlsx with { sheet: 2, omitRows: 3 }
   

   // version 0.6
   include table.xlsx type xlsx with { sheet: 0, omitRows: 3 }
   include table.xlsx type xlsx with { sheet: 1, omitRows: 3 }
   

7. Build and check errors.