Step 1: Create Project Directory Шаг 1: Создание директории проекта

Create a workspace folder and a new directory for your Recast Navigation Android test project: Создайте рабочую папку для проектов и новую директорию для вашего тестового Android-проекта Recast Navigation:

Windows (Command Prompt / PowerShell)

mkdir C:\projects\recast-android-test
cd C:\projects\recast-android-test

Step 2: Create Source Files (main.cpp & CMakeLists.txt) Шаг 2: Создание исходных файлов (main.cpp и CMakeLists.txt)

Create the source files in your project directory: Создайте исходные файлы в папке проекта:

Windows (Terminal / Notepad)

notepad main.cpp
notepad CMakeLists.txt

1. File Contents for main.cpp 1. Содержимое файла main.cpp

#include <iostream>
#include <Recast.h>
#include <DetourNavMesh.h>
#include <DetourNavMeshQuery.h>

int main() {
    std::cout << "Initializing Recast & Detour (Android)..." << std::endl;

    // Allocate Recast Context
    rcContext ctx;
    
    // Allocate Detour NavMesh & NavMeshQuery objects
    dtNavMesh* navMesh = dtAllocNavMesh();
    dtNavMeshQuery* navQuery = dtAllocNavMeshQuery();

    if (!navMesh || !navQuery) {
        std::cerr << "Failed to allocate Detour structures!" << std::endl;
        return 1;
    }

    dtStatus status = navQuery->init(navMesh, 2048);
    if (dtStatusSucceed(status)) {
        std::cout << "NavMeshQuery initialized (empty mesh baseline test successful)." << std::endl;
    }

    // Clean up allocated memory
    dtFreeNavMeshQuery(navQuery);
    dtFreeNavMesh(navMesh);

    std::cout << "Recast Navigation Android test completed successfully!" << std::endl;
    return 0;
}

2. File Contents for CMakeLists.txt 2. Содержимое файла CMakeLists.txt

Directly links the compiled shared libraries (libRecast.so, libDetour.so, etc.) and the Android log library: Напрямую подключает скомпилированные динамические библиотеки (libRecast.so, libDetour.so и др.) и системную библиотеку логирования Android:

cmake_minimum_required(VERSION 3.21)

if(NOT CMAKE_BUILD_TYPE)
    set(CMAKE_BUILD_TYPE "Release")
endif()

project(recast-android-test CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# -----------------------------------------------------------------------------
# Library Paths for Android
# -----------------------------------------------------------------------------
set(RECAST_DIR "C:/libs/recastnavigation-android/arm64-v8a")

# -----------------------------------------------------------------------------
# Define Project Source Files
# -----------------------------------------------------------------------------
set(PROJECT_SOURCES
    main.cpp
)

# -----------------------------------------------------------------------------
# Declare Target Type & Sources
# -----------------------------------------------------------------------------
add_executable(app)
target_sources(app PRIVATE ${PROJECT_SOURCES})

target_include_directories(app PRIVATE
    ${RECAST_DIR}/include
    ${RECAST_DIR}/include/recastnavigation
)

# -----------------------------------------------------------------------------
# Link Libraries
# -----------------------------------------------------------------------------
target_link_libraries(app PRIVATE
    # Recast Navigation shared libraries (.so)
    ${RECAST_DIR}/lib/libRecast.so
    ${RECAST_DIR}/lib/libDetour.so
    ${RECAST_DIR}/lib/libDebugUtils.so
    ${RECAST_DIR}/lib/libDetourCrowd.so
    ${RECAST_DIR}/lib/libDetourTileCache.so
    log
)

Step 3: Create Build & Execution Scripts Шаг 3: Создание скриптов сборки и запуска

Create batch scripts to configure, compile, and execute the test on an Android device or emulator via ADB: Создайте пакетные bat-скрипты для конфигурации, компиляции и запуска теста на Android-устройстве или эмуляторе через ADB:

Windows (Batch Scripts)

config-android.bat

@echo off
set NDK=H:/AndroidSDK/ndk/28.2.13676358

cmake -G "MinGW Makefiles" ^
  -DCMAKE_TOOLCHAIN_FILE=%NDK%/build/cmake/android.toolchain.cmake ^
  -DANDROID_ABI=arm64-v8a ^
  -DANDROID_PLATFORM=android-21 ^
  -DCMAKE_BUILD_TYPE=Release ^
  -S . -B dist/android

build-android.bat

@echo off
cmake --build dist/android --config Release --parallel

run-android.bat

@echo off
set ADB=H:/AndroidSDK/platform-tools/adb.exe
set DEVICE_DIR=/data/local/tmp/recast-test
set RECAST_LIB_DIR=C:/libs/recastnavigation-android/arm64-v8a/lib

echo [*] Creating target directory on device...
%ADB% shell "mkdir -p %DEVICE_DIR%"

echo [*] Pushing executable and shared libraries...
%ADB% push dist/android/app %DEVICE_DIR%/
%ADB% push %RECAST_LIB_DIR%/libRecast.so %DEVICE_DIR%/
%ADB% push %RECAST_LIB_DIR%/libDetour.so %DEVICE_DIR%/
%ADB% push %RECAST_LIB_DIR%/libDebugUtils.so %DEVICE_DIR%/
%ADB% push %RECAST_LIB_DIR%/libDetourCrowd.so %DEVICE_DIR%/
%ADB% push %RECAST_LIB_DIR%/libDetourTileCache.so %DEVICE_DIR%/

echo [*] Setting permissions and executing...
%ADB% shell "chmod +x %DEVICE_DIR%/app"
%ADB% shell "export LD_LIBRARY_PATH=%DEVICE_DIR%:$LD_LIBRARY_PATH && %DEVICE_DIR%/app"

Make sure an Android device or emulator is connected (verify with adb devices), then run the scripts sequentially in Command Prompt: Убедитесь, что Android-устройство или эмулятор подключены (проверьте с помощью adb devices), затем последовательно запустите скрипты в командной строке:

config-android.bat
build-android.bat
run-android.bat

Step 4: Expected Output Шаг 4: Ожидаемый результат

After running run-android.bat, the executable will resolve the dynamic libraries and print the following output in your terminal: После запуска run-android.bat исполняемый файл свяжет динамические библиотеки и выведет следующий результат в терминал:

Initializing Recast & Detour (Android)...
NavMeshQuery initialized (empty mesh baseline test successful).
Recast Navigation Android test completed successfully!