Skip to content

安装

pip 安装

PyPi

本项目已在 PyPi 上发布,可以通过下面的方式在线安装:

shell
pip install live2d-py -v

GitHub

通过拉取 GitHub 上的最新发布版安装:

shell
pip install live2d-py -v -f https://github.com/Arkueid/live2d-py

Setuptools

利用 Python 进行构建并安装

克隆本仓库到本地:

shell
git clone https://github.com/Arkueid/live2d-py

在仓库根目录执行pip命令

shell
cd live2d-py
pip install . -v

编译

对于 3.0 版本:

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

  2. Visual Studio Code 打开本仓库

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

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

cmake
# 寻找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

插件

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

配置CMake

  1. 执行构建

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

output-encoding

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

选择构建工具

选择配置为 Release

CMake配置

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

配置完毕

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

build

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

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

对于 2.0 版本

详见 v2 分支,编译步骤相同,但 Python 解释器使用 32 位。