adobe / adobe/USD-Fileformat-plugins
fatal error: pxr/usd/usd/usdaFileFormat.h: No such file or directory when building sbsar plugin
- Dominant language
- C++
- Stars
- 396
- Forks
- 42
- PR merge metrics
- No merged PRs in 30d
Description
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
| ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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](https://developer.adobe.com/console/servicesandapis#): 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
```
Contributor guide
Research direction
Start with sbsar/src/sbsarfileformat.cpp and inspect the failing usdaFileFormat.h include, then review the CMake configuration using -Dpxr_ROOT=/usr/local. Compare the include locations reported under /usr/local and /usr/local/build/OpenUSD, and rerun the documented CMake build; done means the sbsar plugin compiles successfully.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- cmake, cpp
- Domain
- build-system
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100