Forge
Reference

Asset layout

The folder structure the assets repository expects.

The environment tasks read raw assets from a fixed folder structure. publishAsset uploads a local folder in that shape to the assets repository, and downloadJdk, downloadJre and downloadCatiaMagic read it back. A folder that deviates from the layout below makes the environment tasks fail to find their assets.

Required folders

Four folders carry the assets you assemble by hand, each holding its files directly, with no intermediate directory.

your-folder/
├── jre/
│   ├── OpenJDK21U-jre_aarch64_mac_hotspot_21.0.10_7.tar.gz
│   ├── OpenJDK21U-jre_x64_linux_hotspot_21.0.10_7.tar.gz
│   └── OpenJDK21U-jre_x64_windows_hotspot_21.0.10_7.zip
├── jdk/
│   ├── OpenJDK21U-jdk_aarch64_mac_hotspot_21.0.10_7.tar.gz
│   ├── OpenJDK21U-jdk_x64_linux_hotspot_21.0.10_7.tar.gz
│   └── OpenJDK21U-jdk_x64_windows_hotspot_21.0.10_7.zip
├── catia-magic/
│   └── Cameo_Systems_Modeler_2026x_Refresh1_no_install.zip
└── catia-magic-user-presets/
    └── Cameo_Systems_Modeler_2026x_Refresh1_no_install.user.zip

Each CATIA Magic version needs its own JDK and JRE, so a repository serving several versions holds several builds in jdk/ and jre/ side by side. The JDK matrix maps them.

A user preset shares the archive's name and adds the suffix .user.zip. That naming is what pairs the two, so listCatiaMagicVersions can report which archives have a preset.

Generated folders

One further folder appears once AI-docs are in use. You do not assemble it by hand — the catia-magic-ai-docs project publishes it — but the environment tasks read it, so the complete picture is:

your-folder/
└── catia-magic-ai-docs/
    └── Cameo_Systems_Modeler_2026x_Refresh1_no_install.ai-docs.zip

The catia-magic-ai-docs/ folder above is a folder in the assets repository. It shares its name with the project that fills it, which is deliberate; the two are not otherwise related.

It is optional. A digest exists only for the CATIA Magic builds that have been ingested, which is a subset of what the repository carries, and a missing digest never fails an install. The digest follows the same naming rule as the preset, adding .ai-docs.zip to the archive name. See The AI-docs digest.

Vendor resource archives

The archives Dassault ships with the tool live outside this structure, in a folder whose shape does not matter. createExternalZipIndex scans whatever externalZips points at:

your-folder/
├── Cameo_Systems_Modeler_2026x_Refresh1_no_install.zip
└── resources/
    ├── AutoStylerPlugin-2026.1.0.zip
    ├── cameo_datahub-2026.1.0.zip
    ├── com.nomagic.magicdraw.alf-2026.1.0.zip
    ├── md_productlineengineering-2026.1.0.zip
    ├── sysml-2026.1.0.zip
    ├── uaf-2026.1.0.zip
    └── …

Those archives come from data/resourcemanager/distribution inside a tool installation, and their file names are Dassault's own — some carry a build suffix, as in sysml-2024.3.0-55-260588bf.zip. createExternalZipIndex reads the metadata inside each archive rather than parsing its name, so the naming does not matter.

A complete repository needs the archives from every CATIA Magic version you support, not only the newest. See Publish raw assets.

On this page