adobe / adobe/USD-Fileformat-plugins

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

Open
#66 4 comments 0 reactions 0 assignees View on GitHub
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.