Main Content

Migrate Projects Developed Using Prior Support Packages

After you install the Vehicle Dynamics Blockset™ Interface for Unreal Engine® 4 Projects support package as described in Install Support Package and Configure Environment, you may need to migrate your project. If your Simulink® model uses an Unreal Engine executable or project developed using a prior release of the support package, you must migrate the project to make it compatible with Unreal® Editor 4.23. Follow these steps:

  1. Open Unreal Engine 4.23. For example, navigate to C:\Program Files\Epic Games\UE_4.23\Engine\Binaries\Win64 and open UE4Editor.exe.

  2. Use the Unreal Project Browser to open the project that you want to migrate.

  3. Follow the prompts to open a copy of the project. The editor creates a new project folder in the same location as the original, appended with 4.23. Close the editor.

  4. In a file explorer, remove the space in the migrated project folder name. For example, rename MyProject 4.23 to MyProject4.23.

  5. Use MATLAB® to open the migrated project in Unreal Editor 4.23. For example, if you have a migrated project saved to the C:/Local folder, use this MATLAB code:

    path = fullfile('C:','Local','MyProject4.23','MyProject.uproject');
    editor = sim3d.Editor(path);
    open(editor);
    

    Note

    The R2020a support package includes changes in the implementation of some actors. Therefore, if the original project contains actors that are placed in the scene, some of them might not fully migrate to Unreal Editor 4.23. To check, examine the Output Log.

    The log might contain error messages. For more information, see the Unreal Engine 4 Documentation or contact MathWorks Technical Support.

  6. Optionally, after you migrate the project, you can use the project to create an Unreal Engine executable. See Package Custom Scenes into Executable.

After you migrate the project, you can create custom scenes. See Customize Scenes Using Simulink and Unreal Editor.

See Also

Related Topics