Android NDK环境下ASSIMP编译报错及集成问题咨询

Hey there, let's work through this cannot find -lpthread error you're hitting when building Assimp for your Android NDK project. I've dealt with this exact issue before, so here's a step-by-step fix and integration guide:

Android's Bionic C library already includes full pthread support out of the box — you don't need to explicitly link against -lpthread like you would on Linux desktop. The problem comes from Assimp's default CMake configuration, which tries to link this library automatically, and that fails in the Android NDK environment.

1. Tune Assimp's CMake Compilation Flags #

Before adding the Assimp subdirectory to your CMakeLists, override its default settings to disable pthread linking and optimize the build for Android:

# Add these lines BEFORE calling add_subdirectory(assimp)
# Disable unnecessary Assimp components to speed up builds
set(ASSIMP_BUILD_ASSIMP_TOOLS OFF CACHE BOOL "" FORCE)
set(ASSIMP_BUILD_TESTS OFF CACHE BOOL "" FORCE)
set(ASSIMP_NO_EXPORT ON CACHE BOOL "" FORCE)
set(ASSIMP_BUILD_ALL_EXPORTERS_BY_DEFAULT OFF CACHE BOOL "" FORCE)
set(ASSIMP_BUILD_ALL_IMPORTERS_BY_DEFAULT OFF CACHE BOOL "" FORCE)

# Only enable the importers you actually need (e.g., OBJ, FBX)
set(ASSIMP_BUILD_OBJ_IMPORTER ON CACHE BOOL "" FORCE)

# Critical: Disable explicit pthread linking
set(THREADS_PREFER_PTHREAD_FLAG OFF CACHE BOOL "" FORCE)
set(ASSIMP_BUILD_ZLIB ON CACHE BOOL "" FORCE) # Use Assimp's built-in zlib

The THREADS_PREFER_PTHREAD_FLAG line tells CMake not to try linking -lpthread, which eliminates the error. We also disable unused tools/tests to cut down on compile time and binary size.

2. Full Main CMakeLists.txt Example #

Here's how your complete CMakeLists.txt should look, including integration with your custom C++ code and GLM:

cmake_minimum_required(VERSION 3.18.1)

project("your-android-project")

# Set C++ standard compatible with Assimp (C++17 works well)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# Configure Assimp first (as above)
set(ASSIMP_BUILD_ASSIMP_TOOLS OFF CACHE BOOL "" FORCE)
set(ASSIMP_BUILD_TESTS OFF CACHE BOOL "" FORCE)
set(ASSIMP_NO_EXPORT ON CACHE BOOL "" FORCE)
set(ASSIMP_BUILD_ALL_EXPORTERS_BY_DEFAULT OFF CACHE BOOL "" FORCE)
set(ASSIMP_BUILD_ALL_IMPORTERS_BY_DEFAULT OFF CACHE BOOL "" FORCE)
set(ASSIMP_BUILD_OBJ_IMPORTER ON CACHE BOOL "" FORCE)
set(THREADS_PREFER_PTHREAD_FLAG OFF CACHE BOOL "" FORCE)
set(ASSIMP_BUILD_ZLIB ON CACHE BOOL "" FORCE)

# Add Assimp subdirectory (adjust path to your Assimp location)
add_subdirectory(third_party/assimp)

# GLM is a header-only library, so adding its subdirectory is optional
# but helps with include path setup
add_subdirectory(third_party/glm)

# Compile your custom native code
add_library(
    your-native-lib
    SHARED
    src/main/cpp/your-custom-code.cpp
    # Add other cpp files here
)

# Link libraries to your native library
target_link_libraries(
    your-native-lib
    assimp # Link the static Assimp library we built
    log # Android logging library for debugging
)

3. Verify Gradle Configuration #

Make sure your app-level build.gradle has the right NDK and CMake settings to support the build:

android {
    namespace "com.your.package.name"
    compileSdk 34

    defaultConfig {
        applicationId "com.your.package.name"
        minSdk 24 # Minimum SDK compatible with your Assimp version
        targetSdk 34
        versionCode 1
        versionName "1.0"

        externalNativeBuild {
            cmake {
                cppFlags "-std=c++17 -pthread" # Enable pthread support at compile time
                abiFilters 'arm64-v8a', 'armeabi-v7a' # Only build for needed ABIs
            }
        }
    }

    externalNativeBuild {
        cmake {
            path file('src/main/cpp/CMakeLists.txt')
            version '3.22.1' # Use a CMake version compatible with your NDK
        }
    }
}

The -pthread flag here ensures your code can use pthread features without needing to link the library.

4. Clean and Rebuild #

Old build caches can sometimes cause lingering issues. Run these steps in Android Studio:

• Click Build -> Clean Project
• Click Build -> Make Project

• Use the latest stable Assimp version (e.g., v5.3.1) — older versions may have worse Android NDK compatibility.
• If you still run into issues, double-check that your Assimp subdirectory is fully cloned (including all its submodules, if any).
• For even smaller binaries, disable more importers/exporters you don't need in the CMake flags.

内容的提问来源于stack exchange，提问作者nicolasl