Disable Carotene for Linux aarch64 static builds

bghira · bghira · commit b77200cdef39 · 2026-01-20T11:57:08.000-06:00
Carotene (ARM NEON optimizations) causes undefined symbol errors when
statically linking OpenCV because the runtime library isn't bundled.
Extend the existing macOS workaround to also apply on Linux aarch64.
diff --git a/scripts/build-opencv-static.sh b/scripts/build-opencv-static.sh
@@ -179,8 +179,10 @@ CMAKE_ARGS=(
     -DCMAKE_INSTALL_PREFIX="${INSTALL_DIR}"
 )
 
-if [[ "$(uname)" == "Darwin" ]]; then
-    echo "Detected macOS host; disabling Carotene to avoid linking issue."
+# Disable Carotene (ARM NEON optimizations) to avoid undefined symbol errors
+# when statically linking. Carotene requires runtime library that isn't bundled.
+if [[ "$(uname)" == "Darwin" ]] || [[ "$(uname -m)" == "aarch64" ]] || [[ "$(uname -m)" == "arm64" ]]; then
+    echo "Detected ARM host; disabling Carotene to avoid linking issue."
     CMAKE_ARGS+=(
         -DWITH_CAROTENE=OFF
     )

Original file line number	Diff line number	Diff line change
`@@ -179,8 +179,10 @@ CMAKE_ARGS=(`
`179`	`179`	`-DCMAKE_INSTALL_PREFIX="${INSTALL_DIR}"`
`180`	`180`	`)`
`181`	`181`
`182`		`-if [[ "$(uname)" == "Darwin" ]]; then`
`183`		`- echo "Detected macOS host; disabling Carotene to avoid linking issue."`
	`182`	`+# Disable Carotene (ARM NEON optimizations) to avoid undefined symbol errors`
	`183`	`+# when statically linking. Carotene requires runtime library that isn't bundled.`
	`184`	`+if [[ "$(uname)" == "Darwin" ]] \|\| [[ "$(uname -m)" == "aarch64" ]] \|\| [[ "$(uname -m)" == "arm64" ]]; then`
	`185`	`+ echo "Detected ARM host; disabling Carotene to avoid linking issue."`
`184`	`186`	`CMAKE_ARGS+=(`
`185`	`187`	`-DWITH_CAROTENE=OFF`
`186`	`188`	`)`