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.zipEach 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.zipThe 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.