Troubleshooting

If you notice the following build failure during QNX Software Center package installation, it means that an error was made creating the options_file during step 5 of the Getting started section:

/home/devuser/qnx/qnxsoftwarecenter/qnxsoftwarecenter_clt -mirrorBaseline qnx800 @options_file
Info: Mirroring repositories: remote server https://www.qnx.com/swcenter
Info: Generating metadata for dropins-repo.
Info: Generation completed with success [0 seconds].
Info: Generating metadata for seeds-q2-repo-devuser_-www_qnx_com_80_swcenter.
Error: publishing result: Server synchronization failed: Authentication failed, check credentials and try again; 
Error: Failed to synchronize repositories: Failed to retrieve package metadata from seeds-q2-repo-devuser_org-www_qnx_com_80_swcenter
make: *** [qsc_packages.mk:46: /home/devuser/work/raspberry-pi-4-qnx-8.0/qnx800] Error 1

Re-read the instructions, correct the information, and then run:

make clean

and:

make

to restart the build.

In the course of installing the 8.0 SDP installation at the beginning of the build, an error in the qsc_install_packages.list file, resulting from customization, may result in the deletion of the SDP 8.0 installation directory at $HOME/qnx800. If this happens, please utilize the "Verify and Repair" functionality of QNX Software Center to repair that SDP installation first.

Before trying the build again, double check the changes made to the qsc_install_packages.list file and correct the error(s) that triggered this deletion to prevent it from recurring on your next attempt to build the project.

It's recommended that you run:

make clean

and

make

to rebuild the project.

Fatal errors might occur during the assets or open source integrations in your first attempt to build if you missed one of the prerequisite steps listed above.

Try the following remedy:

1. Repeat the prerequisite installation commands one more time.

2. You may need to run the following command on Linux hosts running older Ubuntu distributions:

   sudo apt install python3-distutils

3. It's recommended that you run:

   make clean

4. Run the following command to try building the image again:

   make

Once you start customizing the project, fatal errors can and will likely happen in the section you're customizing. As you start adding the steps to integrate new open source projects or assets, especially if you miss a step, or something unexpected occurs as you are trying to build a project being integrated. This is normal and expected.

Try the following remedy:

1. Fix the make target by adding the missing step(s).

2. It's recommended that you run the following command to reset back to a clean initial state:

   make clean

   You can also be more precise and clean only certain folders. For example, to clean only the src folder, run:

   make -Csrc clean

3. Run:

   make

The last step of the build generates the SD card image. If something went wrong earlier in the build process, or a snippet change for customization is incorrect, you'll see warnings printed indicating that files that are expected to be integrated are missing.

You shouldn't see these warnings the first time you build with no customizations, so earlier troubleshooting steps may help with first time build errors.

If you see missing file warnings while in the midst of customizing, this indicates that one of your snippets changes is incorrect, likely that the relative path inside the project folder. Recheck your snippets changes, then try the remedy above to proceed.