x64dbg 插件開發SDK環境配置

x64dbg 是一款開源的應用層反彙編調試器，旨在對沒有源代碼的可執行文件進行惡意軟體分析和逆向工程，同時 x64dbg 還允許用戶開發插件來擴展功能，插件開發環境的配置非常簡單，如下將簡單介紹x64dbg是如何配置開發環境以及如何開發插件的。

預設情況下當你下載好x64dbg時，在pluginsdk目錄下都會包含lib庫，這個庫可以直接引用到項目內的。

插件庫的引入也很簡單，在vs中只需要配置include引用，以及lib庫位置即可，x64dbglib庫的配置非常簡單。

引入後，我們去官方下載好插件模板文件：https://github.com/x64dbg/PluginTemplate

此處為了開發方便，我做了精簡化，你可以直接使用我的方法來新建文件，建出來的文件只有兩個非常簡潔。

首先在頭文件部分新建一個pluginmain.h 並增加PLUGIN_NAME替換成自己項目的名字。

#pragma once

// Plugin information
#define PLUGIN_NAME "LySharkBlog"
#define PLUGIN_VERSION 1

#include "pluginsdk/bridgemain.h"
#include "pluginsdk/_plugins.h"

#include "pluginsdk/_scriptapi_argument.h"
#include "pluginsdk/_scriptapi_assembler.h"
#include "pluginsdk/_scriptapi_bookmark.h"
#include "pluginsdk/_scriptapi_comment.h"
#include "pluginsdk/_scriptapi_debug.h"
#include "pluginsdk/_scriptapi_flag.h"
#include "pluginsdk/_scriptapi_function.h"
#include "pluginsdk/_scriptapi_gui.h"
#include "pluginsdk/_scriptapi_label.h"
#include "pluginsdk/_scriptapi_memory.h"
#include "pluginsdk/_scriptapi_misc.h"
#include "pluginsdk/_scriptapi_module.h"
#include "pluginsdk/_scriptapi_pattern.h"
#include "pluginsdk/_scriptapi_register.h"
#include "pluginsdk/_scriptapi_stack.h"
#include "pluginsdk/_scriptapi_symbol.h"

#include "pluginsdk/DeviceNameResolver/DeviceNameResolver.h"
#include "pluginsdk/jansson/jansson.h"
#include "pluginsdk/lz4/lz4file.h"
#include "pluginsdk/TitanEngine/TitanEngine.h"
#include "pluginsdk/XEDParse/XEDParse.h"

#ifdef _WIN64
#pragma comment(lib, "pluginsdk/x64dbg.lib")
#pragma comment(lib, "pluginsdk/x64bridge.lib")
#pragma comment(lib, "pluginsdk/DeviceNameResolver/DeviceNameResolver_x64.lib")
#pragma comment(lib, "pluginsdk/jansson/jansson_x64.lib")
#pragma comment(lib, "pluginsdk/lz4/lz4_x64.lib")
#pragma comment(lib, "pluginsdk/TitanEngine/TitanEngine_x64.lib")
#pragma comment(lib, "pluginsdk/XEDParse/XEDParse_x64.lib")
#else
#pragma comment(lib, "pluginsdk/x32dbg.lib")
#pragma comment(lib, "pluginsdk/x32bridge.lib")
#pragma comment(lib, "pluginsdk/DeviceNameResolver/DeviceNameResolver_x86.lib")
#pragma comment(lib, "pluginsdk/jansson/jansson_x86.lib")
#pragma comment(lib, "pluginsdk/lz4/lz4_x86.lib")
#pragma comment(lib, "pluginsdk/TitanEngine/TitanEngine_x86.lib")
#pragma comment(lib, "pluginsdk/XEDParse/XEDParse_x86.lib")
#endif //_WIN64

#define Cmd(x) DbgCmdExecDirect(x)
#define Eval(x) DbgValFromString(x)
#define dprintf(x, ...) _plugin_logprintf("[" PLUGIN_NAME "] " x, __VA_ARGS__)
#define dputs(x) _plugin_logprintf("[" PLUGIN_NAME "] %s\n", x)
#define PLUG_EXPORT extern "C" __declspec(dllexport)

//superglobal variables
extern int pluginHandle;
extern HWND hwndDlg;
extern int hMenu;
extern int hMenuDisasm;
extern int hMenuDump;
extern int hMenuStack;

//functions
bool pluginInit(PLUG_INITSTRUCT* initStruct);
void pluginStop();
void pluginSetup();

其次新建一個實現文件pluginmain.cpp並寫入以下代碼，多數情況下我為了方便調試會使用這段代碼，當我們點擊菜單時會觸髮菜單功能，以此可以快速測試特定函數是否正常。

#include "pluginmain.h"
#include <Windows.h>
#include <process.h>

int pluginHandle;
HWND hwndDlg;
int hMenu;
int hMenuDisasm;
int hMenuDump;
int hMenuStack;

// 導出函數
extern "C" __declspec(dllexport) void CBMENUENTRY(CBTYPE cbType, PLUG_CB_MENUENTRY* info);
extern "C" __declspec(dllexport) void plugsetup(PLUG_SETUPSTRUCT* setupStruct);
extern "C" __declspec(dllexport) bool pluginit(PLUG_INITSTRUCT* initStruct);

// 在這裡初始化插件數據。
bool pluginInit(PLUG_INITSTRUCT* initStruct)
{
	// 返回false以取消載入插件。
	return true;
}

// 在此處取消初始化插件數據。
void pluginStop()
{
}

// 在這裡做GUI/菜單相關的事情。
void pluginSetup()
{
}

// 菜單被點擊回調
void CBMENUENTRY(CBTYPE cbType, PLUG_CB_MENUENTRY* info)
{
	// 此菜單用於實現功能，並測試

	for (int x = 0; x < 100; x++)
	{
		_plugin_logprint("hello lyshark");
	}
}

PLUG_EXPORT bool pluginit(PLUG_INITSTRUCT* initStruct)
{
	initStruct->pluginVersion = PLUGIN_VERSION;
	initStruct->sdkVersion = PLUG_SDKVERSION;
	strncpy_s(initStruct->pluginName, PLUGIN_NAME, _TRUNCATE);
	pluginHandle = initStruct->pluginHandle;

	// 插件初始化
	initStruct->sdkVersion = PLUG_SDKVERSION;
	initStruct->pluginVersion = 1;
	const char *name = "CheckME -->";
	memset(initStruct->pluginName, 0, 128);
	memcpy(initStruct->pluginName, name, strlen(name));

	return pluginInit(initStruct);
}

PLUG_EXPORT bool plugstop()
{
	pluginStop();
	return true;
}

PLUG_EXPORT void plugsetup(PLUG_SETUPSTRUCT* setupStruct)
{
	hwndDlg = setupStruct->hwndDlg;
	hMenu = setupStruct->hMenu;
	hMenuDisasm = setupStruct->hMenuDisasm;
	hMenuDump = setupStruct->hMenuDump;
	hMenuStack = setupStruct->hMenuStack;

	// 增加二級菜單
	char sub_menu[] = { "PowerBy LyShark" };
	_plugin_menuaddentry(setupStruct->hMenu, 2, sub_menu);

	pluginSetup();
}

編譯這段代碼，然後我們將其放入到x64dbg目錄下的plugins目錄，然後運行程式，點擊checkme即可測試我們的功能了。