first
This commit is contained in:
Misaki
@@ -0,0 +1,195 @@
|
||||
## Framework模块说明
|
||||
|
||||
由于嵌入式Linux的硬件差异性导致的不同嵌入式板子的sysroot不同，导致不同的板子环境差异很大，
|
||||
因此对于framework这个模块，需要自行根据自己板子的sysroot或者sdk进行交叉编译。
|
||||
|
||||
#### 如何交叉编译Framework模块
|
||||
在本项目当中，有一个适用于rk3566的framework模块，
|
||||
因为framework模块一般不会使用到一些特别的硬件或者是后端(音频后端之类的)，
|
||||
所以理论上其他rk3566的板子也可以使用我预编译的模块。
|
||||
|
||||
给出交叉编译步骤(以编译我的rk3566为例)：
|
||||
```shell
|
||||
cmake -S ../Framework -B . \
|
||||
-DCMAKE_TOOLCHAIN_FILE=~/MisakiCodes/Env/rk3566-sdk/qt_toolchain.cmake \
|
||||
-DCMAKE_BUILD_TYPE=Debug \
|
||||
-DFRAMEWORK_SOURCE=OpenGL \
|
||||
-DRENDER_INCLUDE_PATH="${CMAKE_SOURCE_DIR}/Framework/src/Rendering/OpenGL" \
|
||||
-DFRAMEWORK_DEFINITIOINS="CSM_TARGET_HARMONYOS_ES3"
|
||||
```
|
||||
|
||||
预期的配置输出：
|
||||
```shell
|
||||
CMake Warning (dev) in CMakeLists.txt:
|
||||
No project() command is present. The top-level CMakeLists.txt file must
|
||||
contain a literal, direct call to the project() command. Add a line of
|
||||
code such as
|
||||
|
||||
project(ProjectName)
|
||||
|
||||
near the top of the file, but after cmake_minimum_required().
|
||||
|
||||
CMake is pretending there is a "project(Project)" command on the first
|
||||
line.
|
||||
This warning is for project developers. Use -Wno-dev to suppress it.
|
||||
|
||||
CMake Warning (dev) in CMakeLists.txt:
|
||||
cmake_minimum_required() should be called prior to this top-level project()
|
||||
call. Please see the cmake-commands(7) manual for usage documentation of
|
||||
both commands.
|
||||
This warning is for project developers. Use -Wno-dev to suppress it.
|
||||
|
||||
-- The C compiler identification is GNU 12.3.0
|
||||
-- The CXX compiler identification is GNU 12.3.0
|
||||
-- Detecting C compiler ABI info
|
||||
-- Detecting C compiler ABI info - done
|
||||
-- Check for working C compiler: /home/misaki/MisakiCodes/Env/rk3566-sdk/toolchain/aarch64--glibc--stable-2023.08-1/bin/aarch64-linux-gcc - skipped
|
||||
-- Detecting C compile features
|
||||
-- Detecting C compile features - done
|
||||
-- Detecting CXX compiler ABI info
|
||||
-- Detecting CXX compiler ABI info - done
|
||||
-- Check for working CXX compiler: /home/misaki/MisakiCodes/Env/rk3566-sdk/toolchain/aarch64--glibc--stable-2023.08-1/bin/aarch64-linux-g++ - skipped
|
||||
-- Detecting CXX compile features
|
||||
-- Detecting CXX compile features - done
|
||||
-- Configuring done (0.5s)
|
||||
-- Generating done (0.0s)
|
||||
-- Build files have been written to: /home/misaki/Downloads/CubismSdkForNative-5-r.4.1/build_framework
|
||||
```
|
||||
|
||||
观察上述命令可知，首先你肯定需要准备Live2D的SDK，这可以在官网下载，不在此过多赘述。
|
||||
|
||||
接着在与Framework的同级目录下新建一个xxx_build目录，如果你不知道这是什么，那么最好借助一下AI来帮助你。
|
||||
|
||||
之后就是cd到build目录里面。
|
||||
|
||||
Framework模块承担了Live2D的很多功能，其中唯一一个平台有关的就是Render模块，
|
||||
也就是渲染功能，不过Live2D的库的渲染部分写的比较好，统一使用了OpenGL ES,同时兼容主机平台和arm移动平台。
|
||||
|
||||
你需要准备一个编译工具链，也就toolchain.cmake脚本的内容，这个编译工具链描述了编译器信息，sysroot信息等等。
|
||||
下面给出我自己的工具链作为参考。
|
||||
```cmake
|
||||
set(CMAKE_SYSTEM_NAME Linux)
|
||||
set(CMAKE_SYSTEM_PROCESSOR aarch64)
|
||||
|
||||
set(TOOLCHAIN_ROOT /home/misaki/MisakiCodes/Env/rk3566-sdk/toolchain/aarch64--glibc--stable-2023.08-1)
|
||||
set(CMAKE_C_COMPILER ${TOOLCHAIN_ROOT}/bin/aarch64-linux-gcc)
|
||||
set(CMAKE_CXX_COMPILER ${TOOLCHAIN_ROOT}/bin/aarch64-linux-g++)
|
||||
set(CMAKE_AR ${TOOLCHAIN_ROOT}/bin/aarch64-linux-ar)
|
||||
set(CMAKE_RANLIB ${TOOLCHAIN_ROOT}/bin/aarch64-linux-ranlib)
|
||||
set(CMAKE_STRIP ${TOOLCHAIN_ROOT}/bin/aarch64-linux-strip)
|
||||
|
||||
set(SYSROOT /home/misaki/MisakiCodes/Env/rk3566-sdk/host/aarch64-buildroot-linux-gnu/sysroot)
|
||||
set(VPET_SDK /home/misaki/MisakiCodes/Env/rk3566-sdk/vpet-deps)
|
||||
set(QT_HOST_PATH /home/misaki/Qt/6.6.3/gcc_64)
|
||||
|
||||
set(CMAKE_FIND_ROOT_PATH ${SYSROOT} ${VPET_SDK})
|
||||
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
|
||||
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
|
||||
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
|
||||
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE BOTH) # 不使用only,否则会导致CMake找不到其他库的包，例如Qt的，会直接导致FindPackage失效，只能找sysroot里面的包
|
||||
|
||||
set(CMAKE_C_FLAGS "-march=armv8.2-a -mtune=cortex-a55 -O2 -pipe --sysroot=${SYSROOT}")
|
||||
set(CMAKE_CXX_FLAGS "${CMAKE_C_FLAGS} -std=c++17")
|
||||
|
||||
# === 关键：强制链接 Mali 驱动和 EGL/GLES ===
|
||||
set(MALI_LIBS "-lmali-hook -Wl,--whole-archive -lmali-hook-injector -Wl,--no-whole-archive -lmali -ldrm")
|
||||
|
||||
set(CMAKE_EXE_LINKER_FLAGS
|
||||
"-Wl,-dynamic-linker=/lib/ld-linux-aarch64.so.1 \
|
||||
-Wl,-rpath,/data/vpet/deps/lib:/usr/lib:/lib \
|
||||
--sysroot=${SYSROOT} \
|
||||
${MALI_LIBS}"
|
||||
)
|
||||
set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS}")
|
||||
set(CMAKE_MODULE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS}")
|
||||
|
||||
# === 包含路径 ===
|
||||
include_directories(
|
||||
${VPET_SDK}/include
|
||||
${VPET_SDK}/include/libdrm
|
||||
${SYSROOT}/usr/include
|
||||
)
|
||||
|
||||
# === 库路径 ===
|
||||
link_directories(
|
||||
${VPET_SDK}/lib
|
||||
${SYSROOT}/usr/lib
|
||||
${SYSROOT}/lib
|
||||
)
|
||||
|
||||
# === pkg-config ===
|
||||
set(ENV{PKG_CONFIG} "/usr/bin/pkg-config")
|
||||
set(ENV{PKG_CONFIG_LIBDIR} "/home/misaki/MisakiCodes/Env/rk3566-sdk/qt-pkgconfig")
|
||||
set(ENV{PKG_CONFIG_SYSROOT_DIR} "${SYSROOT}")
|
||||
set(ENV{PKG_CONFIG_PATH} "")
|
||||
|
||||
# === 线程 ===
|
||||
set(CMAKE_THREAD_LIBS_INIT "-lpthread")
|
||||
set(THREADS_PREFER_PTHREAD_FLAG ON)
|
||||
```
|
||||
|
||||
你需要根据自己的实际情况进行调整。
|
||||
|
||||
之前的命令是配置CMake的，编译还需：
|
||||
```shell
|
||||
cmake --build . --target Framework -j$(nproc)
|
||||
```
|
||||
|
||||
|
||||
预期的编译日志输出：
|
||||
```shell
|
||||
[ 7%] Building CXX object CMakeFiles/Framework.dir/src/CubismModelSettingJson.cpp.o
|
||||
[ 7%] Building CXX object CMakeFiles/Framework.dir/src/CubismDefaultParameterId.cpp.o
|
||||
[ 7%] Building CXX object CMakeFiles/Framework.dir/src/CubismCdiJson.cpp.o
|
||||
[ 10%] Building CXX object CMakeFiles/Framework.dir/src/CubismFramework.cpp.o
|
||||
[ 12%] Building CXX object CMakeFiles/Framework.dir/src/Effect/CubismEyeBlink.cpp.o
|
||||
[ 15%] Building CXX object CMakeFiles/Framework.dir/src/Id/CubismId.cpp.o
|
||||
[ 17%] Building CXX object CMakeFiles/Framework.dir/src/Effect/CubismPose.cpp.o
|
||||
[ 20%] Building CXX object CMakeFiles/Framework.dir/src/Effect/CubismBreath.cpp.o
|
||||
[ 22%] Building CXX object CMakeFiles/Framework.dir/src/Id/CubismIdManager.cpp.o
|
||||
[ 25%] Building CXX object CMakeFiles/Framework.dir/src/Math/CubismMath.cpp.o
|
||||
[ 27%] Building CXX object CMakeFiles/Framework.dir/src/Math/CubismMatrix44.cpp.o
|
||||
[ 30%] Building CXX object CMakeFiles/Framework.dir/src/Math/CubismModelMatrix.cpp.o
|
||||
[ 32%] Building CXX object CMakeFiles/Framework.dir/src/Math/CubismTargetPoint.cpp.o
|
||||
[ 35%] Building CXX object CMakeFiles/Framework.dir/src/Math/CubismViewMatrix.cpp.o
|
||||
[ 37%] Building CXX object CMakeFiles/Framework.dir/src/Math/CubismVector2.cpp.o
|
||||
[ 40%] Building CXX object CMakeFiles/Framework.dir/src/Model/CubismMoc.cpp.o
|
||||
[ 42%] Building CXX object CMakeFiles/Framework.dir/src/Model/CubismModel.cpp.o
|
||||
[ 45%] Building CXX object CMakeFiles/Framework.dir/src/Model/CubismModelUserData.cpp.o
|
||||
[ 47%] Building CXX object CMakeFiles/Framework.dir/src/Model/CubismModelUserDataJson.cpp.o
|
||||
[ 50%] Building CXX object CMakeFiles/Framework.dir/src/Model/CubismUserModel.cpp.o
|
||||
[ 52%] Building CXX object CMakeFiles/Framework.dir/src/Motion/ACubismMotion.cpp.o
|
||||
[ 55%] Building CXX object CMakeFiles/Framework.dir/src/Motion/CubismExpressionMotion.cpp.o
|
||||
[ 57%] Building CXX object CMakeFiles/Framework.dir/src/Motion/CubismExpressionMotionManager.cpp.o
|
||||
[ 60%] Building CXX object CMakeFiles/Framework.dir/src/Motion/CubismMotion.cpp.o
|
||||
[ 62%] Building CXX object CMakeFiles/Framework.dir/src/Motion/CubismMotionJson.cpp.o
|
||||
[ 65%] Building CXX object CMakeFiles/Framework.dir/src/Motion/CubismMotionManager.cpp.o
|
||||
[ 67%] Building CXX object CMakeFiles/Framework.dir/src/Motion/CubismMotionQueueEntry.cpp.o
|
||||
[ 70%] Building CXX object CMakeFiles/Framework.dir/src/Motion/CubismMotionQueueManager.cpp.o
|
||||
[ 72%] Building CXX object CMakeFiles/Framework.dir/src/Physics/CubismPhysics.cpp.o
|
||||
[ 75%] Building CXX object CMakeFiles/Framework.dir/src/Rendering/CubismRenderer.cpp.o
|
||||
[ 77%] Building CXX object CMakeFiles/Framework.dir/src/Physics/CubismPhysicsJson.cpp.o
|
||||
[ 80%] Building CXX object CMakeFiles/Framework.dir/src/Rendering/OpenGL/CubismOffscreenSurface_OpenGLES2.cpp.o
|
||||
[ 82%] Building CXX object CMakeFiles/Framework.dir/src/Rendering/OpenGL/CubismShader_OpenGLES2.cpp.o
|
||||
[ 85%] Building CXX object CMakeFiles/Framework.dir/src/Rendering/OpenGL/CubismRenderer_OpenGLES2.cpp.o
|
||||
[ 87%] Building CXX object CMakeFiles/Framework.dir/src/Type/csmRectF.cpp.o
|
||||
[ 90%] Building CXX object CMakeFiles/Framework.dir/src/Type/csmString.cpp.o
|
||||
[ 92%] Building CXX object CMakeFiles/Framework.dir/src/Utils/CubismDebug.cpp.o
|
||||
[ 95%] Building CXX object CMakeFiles/Framework.dir/src/Utils/CubismJson.cpp.o
|
||||
[ 97%] Building CXX object CMakeFiles/Framework.dir/src/Utils/CubismString.cpp.o
|
||||
In file included from /home/misaki/Downloads/CubismSdkForNative-5-r.4.1/Framework/src/Rendering/OpenGL/../CubismClippingManager.hpp:152,
|
||||
from /home/misaki/Downloads/CubismSdkForNative-5-r.4.1/Framework/src/Rendering/OpenGL/CubismRenderer_OpenGLES2.hpp:11,
|
||||
from /home/misaki/Downloads/CubismSdkForNative-5-r.4.1/Framework/src/Rendering/OpenGL/CubismRenderer_OpenGLES2.cpp:8:
|
||||
/home/misaki/Downloads/CubismSdkForNative-5-r.4.1/Framework/src/Rendering/OpenGL/../CubismClippingManager.tpp: In instantiation of ‘Live2D::Cubism::Framework::Rendering::CubismClippingManager<T_ClippingContext, T_OffscreenSurface>::~CubismClippingManager() [with T_ClippingContext = Live2D::Cubism::Framework::Rendering::CubismClippingContext_OpenGLES2; T_OffscreenSurface = Live2D::Cubism::Framework::Rendering::CubismOffscreenSurface_OpenGLES2]’:
|
||||
/home/misaki/Downloads/CubismSdkForNative-5-r.4.1/Framework/src/Rendering/OpenGL/CubismRenderer_OpenGLES2.hpp:61:7: required from here
|
||||
/home/misaki/Downloads/CubismSdkForNative-5-r.4.1/Framework/src/Rendering/OpenGL/../CubismClippingManager.tpp:66:33: warning: passing NULL to non-pointer argument 1 of ‘Live2D::Cubism::Framework::csmVector<T>::csmVector(Live2D::Cubism::Framework::csmInt32, Live2D::Cubism::Framework::csmBool) [with T = bool; Live2D::Cubism::Framework::csmInt32 = int; Live2D::Cubism::Framework::csmBool = bool]’ [-Wconversion-null]
|
||||
66 | _clearedMaskBufferFlags = NULL;
|
||||
| ^
|
||||
In file included from /home/misaki/Downloads/CubismSdkForNative-5-r.4.1/Framework/src/Rendering/OpenGL/../CubismRenderer.hpp:12,
|
||||
from /home/misaki/Downloads/CubismSdkForNative-5-r.4.1/Framework/src/Rendering/OpenGL/CubismRenderer_OpenGLES2.hpp:10:
|
||||
/home/misaki/Downloads/CubismSdkForNative-5-r.4.1/Framework/src/Type/csmVector.hpp:559:34: note: declared here
|
||||
559 | csmVector<T>::csmVector(csmInt32 initialCapacity, csmBool zeroClear)
|
||||
| ~~~~~~~~~^~~~~~~~~~~~~~~
|
||||
[100%] Linking CXX static library libFramework.a
|
||||
[100%] Built target Framework
|
||||
```
|
||||
Binary file not shown.
Vendored
Executable
BIN
Binary file not shown.
Vendored
Executable
BIN
Binary file not shown.
Reference in New Issue
Block a user