PKSM开发者指南：自定义界面与功能扩展编程教程

PKSM开发者指南：自定义界面与功能扩展编程教程

【免费下载链接】PKSMGen I to GenVIII save manager.项目地址: https://gitcode.com/gh_mirrors/pk/PKSM

PKSM是一款支持从第一世代到第八世代宝可梦游戏的存档管理工具，为开发者提供了丰富的界面定制和功能扩展可能性。本教程将详细介绍如何为PKSM开发自定义界面组件和扩展核心功能，帮助开发者快速上手插件开发。

一、开发环境搭建

1.1 源码获取

首先需要克隆PKSM项目源码到本地开发环境：

git clone https://gitcode.com/gh_mirrors/pk/PKSM

1.2 项目结构解析

PKSM项目采用模块化架构，核心界面组件位于以下目录：

• 界面定义：3ds/include/gui/overlay/- 包含所有覆盖层界面的头文件
• 界面实现：3ds/source/gui/overlay/- 对应覆盖层界面的C++实现文件
• 公共组件：common/include/gui/- 基础UI控件和界面管理类

二、自定义界面开发

2.1 覆盖层(Overlay)开发基础

覆盖层是PKSM的核心界面组件，所有交互界面都基于Overlay类实现。创建新的自定义覆盖层需要继承Overlay基类并实现必要的方法。

在3ds/include/gui/overlay/目录下创建新的头文件，例如CustomOverlay.hpp：

#include "gui/overlay/ViewOverlay.hpp" #include "utils/formatters.hpp" class CustomOverlay : public Overlay { public: CustomOverlay() : Overlay() {} ~CustomOverlay() override = default; void draw() override; void update(touchPosition* touch) override; void load() override; private: int selectedItem = 0; std::vector<std::string> items; };

2.2 绘制界面元素

在对应的C++实现文件（如3ds/source/gui/overlay/CustomOverlay.cpp）中实现draw()方法来绘制界面元素：

void CustomOverlay::draw() { // 绘制背景 C2D_DrawRectSolid(0, 0, 0, 400, 240, C2D_Color32(0x10, 0x10, 0x10, 0xFF)); // 绘制标题 C2D_DrawText(gfx::textToTexture("自定义界面", 24, COLOR_WHITE), C2D_AlignCenter, 200, 10, 0.5f); // 绘制列表项 for (size_t i = 0; i < items.size(); i++) { u32 color = (i == selectedItem) ? COLOR_YELLOW : COLOR_WHITE; C2D_DrawText(gfx::textToTexture(items[i], 20, color), C2D_AlignLeft, 20, 50 + i * 30, 0.5f); } }

2.3 处理用户输入

实现update()方法来处理按键和触摸输入：

void CustomOverlay::update(touchPosition* touch) { // 处理按键输入 u32 kDown = hidKeysDown(); if (kDown & KEY_UP && selectedItem > 0) { selectedItem--; } else if (kDown & KEY_DOWN && selectedItem < items.size() - 1) { selectedItem++; } else if (kDown & KEY_A) { // 处理确认操作 doAction(selectedItem); } else if (kDown & KEY_B) { // 关闭当前覆盖层 parent->removeOverlay(); } }

三、功能扩展实现

3.1 添加新的宝可梦编辑功能

要添加新的宝可梦编辑功能，可以在3ds/include/gui/screen/目录下创建新的编辑界面，例如CustomEditorScreen.hpp，并继承EditorScreen类：

#include "gui/screen/EditorScreen.hpp" #include "utils/PkmUtils.hpp" class CustomEditorScreen : public EditorScreen { public: CustomEditorScreen(const std::shared_ptr<PKX>& pkm) : EditorScreen(pkm) {} protected: void drawBottom() const override; void updateBottom() override; private: void applyCustomChanges(); };

3.2 实现自定义数据处理

在common/include/utils/PkmUtils.hpp中添加自定义数据处理函数声明，并在common/source/utils/PkmUtils.cpp中实现：

// 头文件中添加 namespace PkmUtils { void applyCustomModifier(PKX& pkm, int value); } // 实现文件中添加 void PkmUtils::applyCustomModifier(PKX& pkm, int value) { // 实现自定义数据修改逻辑 pkm.setIV(Stat::HP, std::min(31, pkm.iv(Stat::HP) + value)); pkm.setIV(Stat::ATK, std::min(31, pkm.iv(Stat::ATK) + value)); // ...其他属性修改 }

3.3 集成到主界面

要将新功能集成到主界面，需要修改主菜单相关代码。在3ds/source/gui/screen/MainMenu.cpp中添加新的菜单项：

void MainMenu::load() { // ...现有代码 // 添加新菜单项 buttons.emplace_back(std::make_unique<MainMenuButton>( "自定义功能", [this]() { parent->addOverlay<CustomOverlay>(); }, gfx::loadImage("icon_custom.png") )); }

四、本地化支持

PKSM支持多语言界面，添加新功能的本地化文本需要在assets/gui_strings/目录下的对应语言文件中添加翻译条目。例如，在assets/gui_strings/eng/general.json中添加：

{ "custom_feature": "Custom Feature", "custom_description": "Apply custom modifications to your Pokémon", "custom_button": "Execute" }

在代码中使用本地化文本：

#include "utils/i18n.hpp" // 在绘制文本时使用 C2D_DrawText(gfx::textToTexture(i18n::localize("custom_feature"), 24, COLOR_WHITE), C2D_AlignCenter, 200, 10, 0.5f);

五、编译与测试

5.1 编译项目

在项目根目录执行make命令编译3DS版本：

make -j4

编译产物将生成在3ds/out/目录下。

5.2 测试与调试

将编译生成的.3dsx文件通过Homebrew Launcher加载到3DS主机或模拟器中进行测试。可以使用3DS调试工具查看日志输出：

#include "utils/logging.hpp" // 在代码中添加调试日志 Logging::log("CustomOverlay loaded with %d items", items.size());

六、开发资源

• 官方文档：docs/
• 界面组件：3ds/include/gui/
• 工具类：common/include/utils/
• 本地化文件：assets/gui_strings/

通过以上步骤，开发者可以为PKSM创建自定义界面和功能扩展。建议参考现有界面组件的实现方式，保持代码风格的一致性。如果有任何疑问，可以查看项目中的示例代码或提交issue寻求帮助。

【免费下载链接】PKSMGen I to GenVIII save manager.项目地址: https://gitcode.com/gh_mirrors/pk/PKSM