Skip to content
Arkueid edited this page Mar 23, 2025 · 4 revisions

对于 3.0 版本

依赖

安装 cmake (>=3.26),gcc/msvc (c++17)

python dev 环境:对于 Windows,安装 Python 时需要勾选 Standard Library 和 Development 选项。对于 Linux ,以 Debian 为例:sudo apt install python3-dev

opengl 环境:对于 Windows,一般不需要配置。Linux 下需要安装对应的 dev 依赖,以 Debian 为例:sudo apt install libgl1-mesa-dev libglu1-mesa-dev

编译

  1. 克隆本仓库到本地文件夹 live2d-py
git clone git@github.com:Arkueid/live2d-py.git
  1. 安装 CMakeVisual Studio CodeVisual Studio

  2. Visual Studio Code 打开本仓库

code live2d-py
  1. 修改 LAppModelWrapper.cpp 同目录下的 CMakeLists.txt

将下面 D:/pydk 修改为对应版本的 Python 安装目录。

# 寻找Python
set(CMAKE_PREFIX_PATH D:/pydk)

d:/pydk 的结构如下:

d:\pydk
|-- DLLs
|-- LICENSE.txt
|-- Lib
|-- NEWS.txt
|-- Scripts
|-- Tools
|-- include
|-- libs
|-- python.exe
|-- python.pdb
|-- python3.dll
|-- python310.dll
|-- python310.pdb
|-- python310_d.dll
|-- python310_d.pdb
|-- python3_d.dll
|-- python_d.exe
|-- python_d.pdb
|-- pythonw.exe
|-- pythonw.pdb
|-- pythonw_d.exe
|-- pythonw_d.pdb
`-- vcruntime140.dll
  1. Visual Studio Code 安装插件:C/C++CMakeCMake Tools

vscode-plugins

  1. Visual Studio Code 中按下 Ctrl + Shift + P 打开选项面板,选择 CMake: Configure

configure-cmake

  1. 执行构建

设置 output 输出日志的编码为 utf-8。

output-encoding

选择构建工具 Visual Studio Community 20XX Release - x86。如果目标平台为 x64,则选择 Visual Studio Community 20XX Release - amd64

select-builder

选择配置为 Release

cmake-config

当配置完毕,生成 build 文件夹后,输出如下:

config-done

构建目标选择 LAppModelWrapper,点击 build 编译生成。

build

编译完毕,输出文件为 package/live2d/live2d.pyd

  1. 使用,将 package 目录下的 live2d 文件夹作为 Python 模块集成即可。

对于 2.0 版本

v2 版本目前使用纯 Python 实现,不需要编译。

如果觉得性能不行,可以尝试编译下面的分支(仅支持 win32):

克隆 v2 分支源码,编译步骤基本相同,但受依赖库限制,只能使用 win32平台下的 Python。

Clone this wiki locally