ENV_VARS (SBUILDER)

Environment Variables for SBUILDER

This is internal documentation meant for the SBUILDER, not for humans writing SBUILD Scripts

• ${SBUILD_SUCCESSFUL}

• Description: If the Build Was Successful or Failed, if It Failed (SBUILD_SUCCESSFUL==false) Bail & Exit Immediately (Still Copy ${SBUILD_OUTDIR} to SOAR_CACHE) (

• Also Copy ${SBUILD_TMPDIR}(PATH: ${SBUILD_OUTDIR}/SBUILD_TEMP) if used -k | --keep

• Values: true | false

• ${PKG}

• Description: The Package Name, used as Prefix for ALL NEEDED Files <ALWAYS Available>

• Value: .pkg

• ${PKG_ID}

• Description: The Package ID (value: .pkg_id)

• Also used as default OutputDir if -o | --outputPATH was NOT Specified (ONLY IF SBUILD_SUCCESSFUL==true)

• ${SBUILD_PKG}

• Description: The Package Name + Package ID

• Value: .pkg+ .pkg_type

• ${PKG_TYPE}

• Description: One of appbundle|appimage|archive|dynamic|flatimage|gameimage|nixappimage|runimage|static

• ALWAYS Re-Checked using Magic Bytes for Utmost Sanity

• dynamic|static are binaries (cli), don't need Integration (Desktop,Icons etc)

• UNKNOWN means, the pkg_type value was empty, Rechecked anyway

• ${SBUILD_OUTDIR}

• Description: The Root (Temporary) Working Directory x_exec.run is Run From <ALWAYS Available>

• All NEEDED Files must exist in this Directory

• This Directory is moved to SOAR_CACHE oafter Build Finishes (Regradless if Successful | Failed) but only depth 1 unless used -k | --keep which would move the entire directory including ${SBUILD_TMPDIR}(PATH: ${SBUILD_OUTDIR}/SBUILD_TEMP)

• After moving to SOAR_CACHE , it is also copied to OutputDir ONLY IF SBUILD_SUCCESSFUL==truespecified using -o | --outputPATH, otherwise this is copied to ${CWD}/${SBUILD_PKG} directory.

• if SBUILD_SUCCESSFUL==false , don't copy it to OutputDir , fetch the logs & show errors along with printing realpath to SOAR_CACHEDir

• ${SBUILD_TMPDIR}

• Description: The SBUILD_TEMP Directory inside ${SBUILD_OUTDIR} (PATH: ${SBUILD_OUTDIR}/SBUILD_TEMP), used for storing NON-NEEDED Files <ALWAYS Available>

• This dir is cleaned (Not Copied to SOAR_CACHE) by Default unless used -k | --keep

• If rebuilding, & this dir already exists (User used -k | --keepduring prevous build), it is cleaned/purged with --clean-build or -c | --clean