fatal error: pxr/usd/usd/usdaFileFormat.h: No such file or directory when building sbsar plugin

[sdromero01]

When trying to build the sbsar plugin, I keep getting this error:

[ 95%] Building CXX object sbsar/src/CMakeFiles/usdSbsar.dir/sbsarfileformat.cpp.o
/mnt/share/USD-Fileformat-plugins/sbsar/src/sbsarfileformat.cpp:30:10: fatal error: pxr/usd/usd/usdaFileFormat.h: No such file or directory
   30 | #include <pxr/usd/usd/usdaFileFormat.h>
      |          ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
compilation terminated.
gmake[2]: *** [sbsar/src/CMakeFiles/usdSbsar.dir/build.make:398: sbsar/src/CMakeFiles/usdSbsar.dir/sbsarfileformat.cpp.o] Error 1
gmake[1]: *** [CMakeFiles/Makefile2:157: sbsar/src/CMakeFiles/usdSbsar.dir/all] Error 2
gmake: *** [Makefile:136: all] Error 2

OpenUSD is installed in /usr/local and finding usdaFileFormat.h in it yields the following results:

/usr/local/include/pxr/usd/sdf/usdaFileFormat.h
/usr/local/build/OpenUSD/include/pxr/usd/sdf/usdaFileFormat.h

System Info on Docker

• Ubuntu 24.04.3 LTS
• Python 3.12.3
• cmake version 3.28.3
• Ubuntu clang version 18.1.3 (1ubuntu1), Target: x86_64-pc-linux-gnu, Thread model: posix, InstalledDir: /usr/bin
• gcc (Ubuntu 13.3.0-6ubuntu2~24.04) 13.3.0
• OpenUSD v25.11 (built on Nov 7 2025)

Docker dev.env file:

PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/v25.05/bin:/home/sdromero01/share/USD-Fileformat-plugins/bin/bin:/mnt/share/USD-Fileformat-plugins/bin/plugin/usd
LD_LIBRARY_PATH=/mnt/share/USD-Fileformat-plugins/bin/lib:/usr/local/lib
PYTHONPATH=/usr/local/lib/python
PXR_PLUGINPATH_NAME=/mnt/share/USD-Fileformat-plugins/bin/plugin/usd

Steps to Reproduce:

1. Download the SDK from Adobe Developer Console: substance-ubuntu22-v9.3.1-fb5c0b3b
2. Move the SDK to ~/share then run tar -xf substance-ubuntu22-v9.3.1-fb5c0b3b.tar.bz2
3. git clone git@github.com:adobe/USD-Fileformat-plugins.git
4. docker run --env-file dev.env --rm -it -v /path/to/bolt_server:/bolt_server -e "DISPLAY=$DISPLAY" -v ./share:/mnt/share -v /tmp/.X11-unix:/tmp/.X11-unix boltacr.azurecr.io/lightning_sw_depends:0.1
5. apt update
6. apt install libgl1-mesa-dev mesa-common-dev
7. cmake -S . -B build -DCMAKE_INSTALL_PREFIX=bin -DCMAKE_BUILD_TYPE=Release -Dpxr_ROOT=/usr/local -Dsubstance_DIR=/mnt/share/substance-ubuntu22-v9.3.1-fb5c0b3b -DUSD_FILEFORMATS_ENABLE_SBSAR=ON -DUSD_FILEFORMATS_ENABLE_FBX=OFF -DUSD_FILEFORMATS_ENABLE_GLTF=OFF -DUSD_FILEFORMATS_ENABLE_OBJ=OFF -DUSD_FILEFORMATS_ENABLE_PLY=OFF -DUSD_FILEFORMATS_ENABLE_SPZ=OFF -DUSD_FILEFORMATS_ENABLE_STL=OFF -DUSD_FILEFORMATS_FETCH_GTEST=OFF -DUSD_FILEFORMATS_FETCH_TINYGLTF=OFF -DUSD_FILEFORMATS_FETCH_HAPPLY=OFF -DUSD_FILEFORMATS_FETCH_FMT=OFF -DUSD_FILEFORMATS_FETCH_FASTFLOAT=OFF -DUSD_FILEFORMATS_BUILD_TESTS=OFF
8. cmake --build build --config release

USD Build

The docker image contains the USD build, this is how it was built in the Dockerfile on November 7, 2025:

if cd OpenUSD; then git pull; cd ..
else git clone https://github.com/PixarAnimationStudios/OpenUSD
fi
python3 -m venv py_venv
source py_venv/bin/activate
pip install PySide6 PyOpenGL
sudo env "PATH=$PATH" py_venv/bin/python3 OpenUSD/build_scripts/build_usd.py $PREFIX \
	--no-examples --no-tutorials --usdview --jobs ${BUILD_PARALLEL}
deactivate

[sdromero01]

I found this in OpenUSD's changelog:

[25.08] - 2025-07-31
Deprecated the .sdf file format extension in favor of .usda. Related deprecations will be removed in a future release. (Issue: #3012)

• By default .sdf files with the "#sdf 1.4.32" cookie may still be opened and will be treated as if they were .usda files. This can be disabled by setting the env var SDF_FILE_FORMAT_LEGACY_IMPORT to "error". Support for .sdf files will be fully removed in a future release.
• SdfLayer::CreateAnonymous now creates layers backed by the .usda file format.
• Deprecated SdfTextFileFormat in favor of SdfUsdaTextFileFormat.
• Deprecated file format related utilities in pxr/usd/usd in favor of those same utilities moved to pxr/usd/sdf. UsdCrateInfo, UsdUsdFileFormat, UsdUsdaFileFormat, UsdUsdcFileFormat, UsdUsdzFileFormat, UsdZipFile are deprecated in favor of SdfUsdFileFormat, SdfUsdaFileFormat, SdfUsdcFileFormat, SdfUsdzFileFormat, SdfZipFile respectively.

So OpenUSD v25.08 and newer are not yet supported on the sbsar plugin? Is there a way to get around this or an alternative to converting sbsar data to USD data?

[sdromero01]

Changing #include <pxr/usd/usd/usdaFileFormat.h> to #include <pxr/usd/sdf/usdaFileFormat.h> and UsdUsdaFileFormatTokens to SdfUsdaFileFormatTokens in src/sbsarfileformat.cpp resulted in the plugin building and installing but it would not load:

Coding Error: in _Load at line 243 of /root/3rd-party/setup_tmp/OpenUSD/pxr/base/plug/plugin.cpp -- Failed to load plugin 'usdSbsar': /mnt/share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_26_2__pxrReserved__13TfGetPathNameERKSs in '/mnt/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'
Coding Error: in Create at line 359 of /root/3rd-party/setup_tmp/OpenUSD/pxr/usd/ar/resolver.cpp -- Failed to load plugin usdSbsar for SBSARPackageResolver
Coding Error: in _Load at line 243 of /root/3rd-party/setup_tmp/OpenUSD/pxr/base/plug/plugin.cpp -- Failed to load plugin 'usdSbsar': /mnt/share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_26_2__pxrReserved__13TfGetPathNameERKSs in '/mnt/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'
Coding Error: in Create at line 359 of /root/3rd-party/setup_tmp/OpenUSD/pxr/usd/ar/resolver.cpp -- Failed to load plugin usdSbsar for SBSARPackageResolver
Coding Error: in _Load at line 243 of /root/3rd-party/setup_tmp/OpenUSD/pxr/base/plug/plugin.cpp -- Failed to load plugin 'usdSbsar': /mnt/share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_26_2__pxrReserved__13TfGetPathNameERKSs in '/mnt/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'
Coding Error: in Create at line 359 of /root/3rd-party/setup_tmp/OpenUSD/pxr/usd/ar/resolver.cpp -- Failed to load plugin usdSbsar for SBSARPackageResolver
Warning: in _ReportErrors at line 3254 of /root/3rd-party/setup_tmp/OpenUSD/pxr/usd/usd/stage.cpp -- Could not load sublayer @/mnt/share/USD-Fileformat-plugins/sbsar/data/sbsar/CardBoard.sbsar@ of layer @/mnt/share/USD-Fileformat-plugins/sbsar/data/simplest.usda@ -- Failed to load plugin 'usdSbsar': /mnt/share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_26_2__pxrReserved__13TfGetPathNameERKSs in '/mnt/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'; Failed to load plugin 'usdSbsar': /mnt/share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_26_2__pxrReserved__13TfGetPathNameERKSs in '/mnt/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'; Cannot determine file format for @/mnt/share/USD-Fileformat-plugins/sbsar/data/sbsar/CardBoard.sbsar:SDF_FORMAT_ARGS:target=usd@; skipping. (instantiating stage on stage @/mnt/share/USD-Fileformat-plugins/sbsar/data/simplest.usda@ <0x568c87d3c460>)

[sdromero01]

"Fixed" this problem with the hacky solution from here: #59

[paule-adobe]

Hi @sdromero01, we are aware of this problem with 25.08+ and have a fix that unfortunately hasn't yet been pushed to main. We will be getting the fix out as soon as possible, and I'll post back when we do.

Thanks for your patience!