【亲测免费】 Blender输入法助手插件安装与使用教程

1. 项目的目录结构及介绍

wire_ext_blender_fix_ime/
├── docs/
│   └── 帮助文档.md
├── src/
│   ├── __init__.py
│   ├── main.py
│   └── utils.py
├── .gitignore
├── LICENSE
├── README.md
├── make.py
└── pyproject.toml

目录结构介绍

• docs/: 存放项目的帮助文档，包含详细的使用说明和常见问题解答。
• src/: 存放插件的核心代码，包括初始化文件、主逻辑文件和其他工具函数。
  • __init__.py: 插件的初始化文件，负责加载插件。
  • main.py: 插件的主逻辑文件，包含输入法支持的核心功能。
  • utils.py: 包含一些辅助函数，用于处理输入法相关的操作。
• .gitignore: Git的忽略文件配置，指定哪些文件或目录不需要被版本控制。
• LICENSE: 项目的开源许可证文件，本项目使用GPL-3.0许可证。
• README.md: 项目的介绍文件，包含项目的基本信息、安装方法和使用说明。
• make.py: 用于构建和打包插件的脚本文件。
• pyproject.toml: 项目的配置文件，包含项目的元数据和依赖信息。

2. 项目的启动文件介绍

main.py

main.py 是插件的主逻辑文件，负责初始化插件并处理输入法相关的操作。以下是该文件的主要功能：

• 初始化插件: 在Blender启动时加载插件，并注册输入法支持的相关功能。
• 输入法管理: 自动管理输入法的状态，确保在Blender的输入框、文本物体编辑模式、文本编辑器和控制台中能够正常使用输入法。
• 事件处理: 监听Blender的事件，根据用户的操作调整输入法的状态。

__init__.py

__init__.py 是插件的初始化文件，负责加载插件并注册到Blender中。以下是该文件的主要功能：

• 插件注册: 在Blender启动时自动加载插件，并将其注册到Blender的插件系统中。
• 依赖检查: 检查插件所需的依赖项是否满足，如果不满足则提示用户安装。

3. 项目的配置文件介绍

pyproject.toml

pyproject.toml 是项目的配置文件，包含项目的元数据和依赖信息。以下是该文件的主要内容：

[project]
name = "wire_ext_blender_fix_ime"
version = "3.0.7"
description = "增强 Blender 对 Windows 平台上输入法的支持"
authors = [
    { name="Arius-Cr", email="[e-mail]" }
]
license = { file="LICENSE" }
requires-python = ">=3.7"
dependencies = [
    "blender>=3.0",
    "python-dotenv"
]

[build-system]
requires = ["setuptools>=42", "wheel"]
build-backend = "setuptools.build_meta"

配置文件介绍

• 项目信息: 包含项目的名称、版本、描述、作者和许可证信息。
• Python版本要求: 指定项目所需的最低Python版本。
• 依赖项: 列出项目运行所需的依赖库，如Blender和python-dotenv。
• 构建系统: 指定项目的构建系统，用于打包和发布插件。

通过以上配置文件，开发者可以轻松管理项目的依赖和构建过程，确保插件在不同环境下的一致性和可维护性。