Migration Notes

From 0.14.0 to 0.15.0

This section applies if MicroEJ SDK 6 0.15.0 is used on a project that was created using MicroEJ SDK 6 0.14.0 or lower.

Unification of VEE dependency declaration

The microejVeePort configuration, used to define a VEE Port, and the microejKernel configuration, used to define a Kernel, have been unified into the microejVee configuration.

  • To use a VEE Port or a Kernel published in an artifact repository, declare a Module dependency in the build.gradle.kts file:

    dependencies {
       microejVee("com.mycompany:myVee:1.0.0")
    }
    
  • To use a VEE Port directory available locally, declare a file dependency in the build.gradle.kts file:

    dependencies {
       microejVee(files("C:\\path\\to\\my\\veePort\\source"))
    }
    
  • To use a VEE Port archive available locally, declare a file dependency in the build.gradle.kts file:

    dependencies {
       microejVee(files("C:\\path\\to\\my\\veePort\\file.zip"))
    }
    
  • To use a Kernel Virtual Device and Executable available locally, declare a file dependency in the build.gradle.kts:

    dependencies {
       microejVee(files("C:\\path\\to\\my\\kernel\\executable.out", "C:\\path\\to\\my\\kernel\\virtual\\device"))
    }
    

From 0.11.1 to 0.12.0

This section applies if SDK 6 0.12.0 is used on a project that was created using SDK 6 0.11.1 or lower.

Use of File Dependencies to Define a Local VEE Port or a Kernel Executable

The veePortPath and the kernelFile properties have been replaced by file dependencies.

  • To use a VEE Port archive available locally, declare a file dependency in the build.gradle.kts file, with the microejVeePort configuration:

    dependencies {
       microejVeePort(files("C:\\path\\to\\my\\veePort\\file.zip"))
    }
    
  • To use a VEE Port directory available locally, declare a file dependency in the build.gradle.kts file, with the microejVeePort configuration:

    dependencies {
       microejVeePort(files("C:\\path\\to\\my\\veePort\\source"))
    }
    
  • To use a kernel Virtual Device and Executable available locally, declare a file dependency in the build.gradle.kts file, with the microejKernel configuration:

    dependencies {
       microejKernel(files("C:\\path\\to\\my\\kernel\\executable.out", "C:\\path\\to\\my\\kernel\\virtual\\device"))
    }
    

From 0.10.0 to 0.11.0

This section applies if SDK 6 0.11.0 is used on a project that was created using SDK 6 0.10.0 or lower.

Gradle mechanism usage for Multiple VEE Ports Support

Using multiple VEE Ports in a project uses Gradle mechanism now instead of relying on in-house feature. This implies: - the veePortPaths property has been renamed to veePortPath and accepts a String value:

microej {
   veePortPath = "C:\\path\\to\\my\\veePort\\source"
}
  • the kernelFiles property has been renamed to kernelFile and accepts a String value:

    microej {
       kernelFile = "C:\\path\\to\\my\\kernel\\file"
    }
    

Refer to the How To Build an Executable With Multiple VEE Ports section to learn how to support multiple VEE Ports using the Gradle mechanisms.

From 0.8.0 to 0.9.0

This section applies if SDK 6 0.9.0 is used on a project that was created using SDK 6 0.8.0 or lower.

Merge of the veePortDirs and veePortFiles properties

The build properties veePortDirs and veePortFiles have been merged into a single property veePortPaths. To define a local VEE Port, set the build property veePortPaths in the microej configuration block to the path of the VEE Port file (.zip or .vde) or to the source folder of the VEE Port:

microej {
  veePortPaths = listOf("C:\\path\\to\\my\\veePort\\source")
}

The veePortPaths property is defined as a list in order to provide multiple VEE Port files or source folders if it is needed:

microej {
  veePortPaths = listOf("C:\\path\\to\\my\\veePort1\\source", "C:\\path\\to\\my\\veePort2\\file.zip")
}