王国保卫战5苹果手机版
1G · 2025-10-14
基于 wxWidgets 框架的桌面应用程序，集成了 WebView 浏览器控件，提供了网页浏览、HTTP 通信、JSON 处理、文件操作和书签管理等功能。项目采用C++作为客户端，Go作为服务端的架构设计。
C++ WebView 项目
├── C++ 客户端
│ ├── 主程序入口
│ │ ├── main.h/cpp - 应用程序类定义
│ │ └── MyFrame.h/cpp - 主窗口类及功能实现
│ ├── 日志系统
│ │ ├── LogManager.h/cpp - 日志管理器实现
│ │ └── app.log - 日志文件
│ ├── 资源文件
│ │ ├── resources/ - 静态资源文件（JS/CSS库）
│ │ └── static/ - 静态资源文件（JS/CSS库）
│ ├── 构建系统
│ │ ├── CMakeLists.txt - CMake构建配置
│ │ └── build.bat - Windows构建脚本
│ └── 其他
│ ├── download/ - 下载文件存储目录
│ └── lib/ - 第三方库
├── Go 后端服务
│ └── goServer/
│ ├── main.go - 主服务器程序
│ ├── resources/ - 静态资源文件（JS/CSS库）
│ └── files/ - 上传/下载文件存储目录
└── 文档及其他
└── *.md - Markdown文档文件功能说明书
Go 后端服务运行在本地端口 8080，为 C++ 客户端提供 RESTful API 和文件服务支持。
graph TD
C++Client[C++ 客户端] -->|POST /post| GoServer[Go 后端服务]
C++Client -->|GET /get| GoServer
C++Client -->|GET /files| GoServer
C++Client -->|POST /upload| GoServer
C++Client -->|GET /download| GoServer
C++Client -->|POST /save-xlsx| GoServer
GoServer -->|JSON 响应| C++Client
graph TD
C++Client[C++ 客户端] -->|上传文件| GoServer[Go 后端服务]
GoServer -->|保存到files目录| FileStorage[文件存储]
C++Client -->|请求文件列表| GoServer
GoServer -->|扫描files目录| FileStorage
GoServer -->|返回JSON文件列表| C++Client
C++Client -->|下载文件| GoServer
GoServer -->|读取files目录文件| FileStorage
GoServer -->|返回文件数据| C++Client
graph TD
C++Client[C++ 客户端] -->|请求预览文件| GoServer[Go 后端服务]
GoServer -->|读取文件| FileStorage[文件存储]
GoServer -->|根据文件类型处理| FileTypeHandler{文件类型判断}
FileTypeHandler -->|Markdown| MarkdownRenderer[Markdown渲染]
FileTypeHandler -->|XLSX| XLSXHandler[XLSX处理]
FileTypeHandler -->|其他文本文件| TextRenderer[文本渲染]
GoServer -->|返回HTML页面| C++Client
这是应用程序的核心类，包含了所有 UI 元素和功能实现：
graph TD
MyFrame --> HttpClient
MyFrame --> JsonHandler
MyFrame --> BookmarkManager
MyFrame --> LogManager
构造函数 MyFrame::MyFrame()
浏览器导航相关方法
HTTP 操作相关方法
文件操作相关方法
书签管理相关方法
负责所有网络请求操作：
graph TD
HttpClient --> libcurl[curl库]
HttpPost() - 发送 POST 请求HttpGet() - 发送 GET 请求HttpUploadFile() - 上传文件HttpDownloadFile() - 下载文件URLEncode() - URL 编码BuildUrl() - 构建完整 URL负责 JSON 数据的解析和格式化：
graph TD
JsonHandler --> nlohmann_json[nlohmann::json库]
负责书签的增删改查操作：
graph TD
BookmarkManager --> wxFileConfig[wxFileConfig]
负责日志的记录和显示：
graph TD
LogManager --> wxLog[wxLog系统]
graph TD
MyApp --> MyFrame
MyFrame --> HttpClient
MyFrame --> JsonHandler
MyFrame --> BookmarkManager
MyFrame --> LogManager
HttpClient --> curl[libcurl库]
JsonHandler --> json[nlohmann::json库]
BookmarkManager --> wx[wxWidgets库]
LogManager --> wx
C++Client[C++ 客户端] <-->|HTTP通信| GoServer[Go 后端服务]
GoServer --> Excelize[excelize库]
整个项目采用模块化设计，C++ 客户端负责用户界面和本地功能，Go 后端服务负责文件处理和数据服务。各功能模块相对独立，通过清晰的接口进行交互。MyFrame 作为核心控制器协调各个模块的工作，HttpClient 负责网络通信，JsonHandler 处理数据格式化，BookmarkManager 管理书签数据，LogManager 负责日志记录。这种设计使得代码结构清晰，易于维护和扩展。
graph TD
A[用户操作] --> B{操作类型}
B -->|输入URL并搜索| C[OnSearch函数]
B -->|点击后退| D[OnPrevPage函数]
B -->|点击前进| E[OnNextPage函数]
B -->|点击主页| F[OnHomePage函数]
B -->|点击本地服务器| G[OnLocalServer函数]
C --> H[获取输入的URL]
H --> I{URL是否为空?}
I -->|是| J[显示错误提示]
I -->|否| K{URL是否包含协议?}
K -->|否| L[添加http://前缀]
K -->|是| M[保持原URL]
L --> N[WebView加载URL]
M --> N[WebView加载URL]
D --> O{WebView是否可以后退?}
O -->|是| P[执行后退操作]
O -->|否| Q[无操作]
P --> R[更新URL显示框]
E --> S{WebView是否可以前进?}
S -->|是| T[执行前进操作]
S -->|否| U[无操作]
T --> R[更新URL显示框]
F --> V[加载掘金网站]
V --> R[更新URL显示框]
G --> W[加载本地服务器]
W --> R[更新URL显示框]
graph TD
A[用户操作] --> B{操作类型}
B -->|点击POST JSON| C[OnPost函数]
B -->|点击GET JSON| D[OnGet函数]
B -->|点击格式化JSON| E[OnFormatJson函数]
C --> F[准备JSON数据]
F --> G[调用HttpClient.HttpPost]
G --> H{请求是否成功?}
H -->|否| I[显示错误信息]
H -->|是| J[获取响应数据]
J --> K[在文本框显示响应]
J --> L[保存原始JSON数据]
J --> M[调用JsonHandler.GenerateJsonHtml]
M --> N[在WebView中显示格式化JSON]
D --> O[调用HttpClient.HttpGet]
O --> H
E --> P[获取保存的原始JSON数据]
P --> Q[调用JsonHandler.GenerateJsonHtml<br/>启用格式化模式]
Q --> N[在WebView中显示格式化JSON]
graph TD
A[用户操作] --> B{操作类型}
B -->|点击选择文件| C[OnSelectFile函数]
B -->|点击上传文件| D[OnUploadFile函数]
B -->|点击获取文件列表| E[OnGetFileLists函数]
B -->|点击下载文件| F[OnDownloadFile函数]
B -->|点击编辑XLSX| G[OnEditXlsx函数]
C --> H[打开文件选择对话框]
H --> I{用户是否选择文件?}
I -->|是| J[获取文件路径]
J --> K[在文本框显示文件路径]
I -->|否| L[无操作]
D --> M[获取文件路径]
M --> N{路径是否为空?}
N -->|是| O[显示错误提示]
N -->|否| P{文件是否存在?}
P -->|否| Q[显示错误提示]
P -->|是| R[调用HttpClient.HttpUploadFile]
R --> S{上传是否成功?}
S -->|是| T[刷新文件列表]
S -->|否| U[显示上传失败信息]
E --> V[调用HttpClient.HttpGet<br/>获取文件列表]
V --> W{请求是否成功?}
W -->|否| X[显示错误信息]
W -->|是| Y[解析JSON响应]
Y --> Z[清空下拉框]
Y --> AA[提取文件列表]
AA --> AB[将文件名添加到下拉框]
F --> AC[获取选中的文件名]
AC --> AD{文件名是否为空?}
AD -->|是| AE[显示错误提示]
AD -->|否| AF[构建下载URL]
AF --> AG[调用HttpClient.HttpDownloadFile]
AG --> AH{下载是否成功?}
AH -->|否| AI[显示下载失败信息]
AH -->|是| AJ{文件类型判断}
AJ -->|Markdown文件| AK[转换为HTML并显示]
AJ -->|其他文件| AL[在WebView中加载文件]
G --> AM[获取选中的文件名]
AM --> AN{文件名是否为空?}
AN -->|是| AO[显示提示信息]
AN -->|否| AP{是否为XLSX文件?}
AP -->|否| AQ[显示提示信息]
AP -->|是| AR[构建编辑器URL]
AR --> AS[WebView加载编辑器]
graph TD
A[用户操作] --> B{操作类型}
B -->|点击添加收藏| C[OnAddBookmark函数]
B -->|点击查看收藏| D[OnShowBookmarks函数]
B -->|点击删除收藏| E[OnDeleteBookmark函数]
C --> F[获取当前页面URL]
F --> G[获取当前页面标题]
F --> H{URL是否为空?}
H -->|是| I[显示收藏失败提示]
H -->|否| J[调用BookmarkManager.AddBookmark]
J --> K[显示收藏成功提示]
D --> L[调用BookmarkManager.LoadBookmarks]
L --> M[调用BookmarkManager.GenerateBookmarksHtml]
M --> N[在WebView中显示书签页面]
E --> O[调用BookmarkManager.ShowDeleteBookmarksDialog]
O --> P[显示删除书签对话框]
P --> Q[用户选择要删除的书签]
Q --> R[执行删除操作]
R --> S[刷新书签显示]
graph LR
A[MyFrame主窗口] --> B[HttpClient网络请求]
A --> C[JsonHandler JSON处理]
A --> D[BookmarkManager书签管理]
A --> E[LogManager日志管理]
B --> B1[HttpPost - 发送POST请求]
B --> B2[HttpGet - 发送GET请求]
B --> B3[HttpUploadFile - 上传文件]
B --> B4[HttpDownloadFile - 下载文件]
B --> B5[URLEncode - URL编码]
B --> B6[BuildUrl - 构建完整URL]
C --> C1[SetRawJsonData - 保存原始数据]
C --> C2[GetRawJsonData - 获取原始数据]
C --> C3[GenerateJsonHtml - 生成HTML]
C --> C4[FormatJsonForHtml - 格式化JSON]
D --> D1[AddBookmark - 添加书签]
D --> D2[LoadBookmarks - 加载书签]
D --> D3[GenerateBookmarksHtml - 生成书签页面]
D --> D4[ShowDeleteBookmarksDialog - 显示删除对话框]
E --> E1[Init - 初始化日志]
E --> E2[Log - 记录日志信息]
cmake_minimum_required(VERSION 3.10)
project(app)
# 17是指C++17
set(CMAKE_CXX_STANDARD 17)
# 使用MSVC编译器
# set(CMAKE_CXX_COMPILER "cl.exe")
# 使用C盘wxWidgets目录
include_directories("C:/wxWidgets/include")
link_directories("C:/wxWidgets/lib/vc_x64_dll")
# # 设置cURL路径（使用系统环境变量CRUL）
set(CURL_ROOT "C:/MinGW/curl-8.15.0_4-win64-mingw")
include_directories(${CURL_ROOT}/include)
link_directories(${CURL_ROOT}/lib)
#自动添加所有源文件
file(GLOB_RECURSE SRC_FILES "*.cpp")
add_executable(app ${SRC_FILES})
# 仅对 MyApp 这个目标添加编译宏,非常重要，app能显示中文，保证中文不乱码
target_compile_definitions(app PRIVATE
_DEBUG
_WINDOWS
UNICODE
_UNICODE
WXUSINGDLL
__WXMSW__
)
# 设置为 Windows 应用程序
set_target_properties(app PROPERTIES WIN32_EXECUTABLE ON)
# set(wxWidgets_USE_UNICODE ON)
# set(wxUSE_UNICODE_UTF8 1) # 强制使用 UTF-8 模式
# find_package(wxWidgets REQUIRED COMPONENTS core base webview)
# 链接库文件 --Debug版本
target_link_libraries(app
libcurl.lib
wxmsw33ud_core.lib
wxbase33ud.lib
wxmsw33ud_webview.lib
)
# # 链接库文件 --Release版本
# target_link_libraries(app
# wxmsw33u_core.lib
# wxbase33u.lib
# wxmsw33u_webview.lib
# )
@echo off
chcp 65001
REM 获取当前批处理文件所在目录，并设为工作目录
pushd "%~dp0"
setlocal
:: 设置程序名称
set APP_NAME=app.exe
:: 检查程序是否正在运行
tasklist /FI "IMAGENAME eq %APP_NAME%" 2>NUL | find /I "%APP_NAME%" >NUL
if "%ERRORLEVEL%"=="0" (
echo 正在结束 %APP_NAME%...
taskkill /F /IM "%APP_NAME%" >NUL
ping -n 2 127.0.0.1 >NUL :: 等待1秒确保进程完全结束
)
:: 获取当前时间（开始时间）
for /f "tokens=1-4 delims=:." %%a in ("%time%") do (
set /a "start_hour=%%a"
set /a "start_min=%%b"
set /a "start_sec=%%c"
set /a "start_hundredth=%%d"
)
:: 将小时转换为 24 小时制（如果需要）
if %start_hour% geq 12 (
set /a "start_hour-=12"
)
echo 正在清理构建文件...
if exist "build" (
rmdir /s /q "build"
)
mkdir "build"
cd "build"
if %errorlevel% neq 0 (
echo 清理失败！
pause
exit /b %errorlevel%
)
echo 清理成功！
echo 生成 VS2022 项目...
:: 记录编译开始时间
for /f "delims=" %%a in ('powershell -command "Get-Date -Format 'yyyy-MM-dd HH:mm:ss'"') do set "start_time=%%a"
:: 输出start_time
echo 编译开始时间: %start_time%
cmake .. -G "Visual Studio 17 2022" -A x64
if %errorlevel% neq 0 (
echo 编译失败！
pause
exit /b %errorlevel%
)
if %errorlevel% neq 0 (
echo 构建失败！
pause
exit /b %errorlevel%
)
@REM echo 编译 Release
@REM cmake --build . --config Release --parallel 4
echo 编译 Debug
@REM --parallel 4 参数，使编译过程能够利用4个CPU核心并行处理，从而显著提高编译速度
cmake --build . --config Debug --parallel 4
if %errorlevel% equ 0 (
echo Build succeeded!
) else (
echo Build failed with error code %errorlevel%!
)
echo 编译app.exe完成
:: 记录编译结束时间
for /f "delims=" %%a in ('powershell -command "Get-Date -Format 'yyyy-MM-dd HH:mm:ss'"') do set "end_time=%%a"
echo 编译结束时间: %end_time%
:: 使用 PowerShell 计算时间差
for /f "tokens=*" %%a in ('powershell -command "(Get-Date '%end_time%') - (Get-Date '%start_time%') | Select-Object -ExpandProperty TotalSeconds"') do set "duration_seconds=%%a"
:: 将总时长转换为小时、分钟、秒
set /a "duration_hours=%duration_seconds%/3600"
set /a "duration_minutes=(%duration_seconds% %% 3600)/60"
set /a "duration_seconds=%duration_seconds% %% 60"
:: 格式化输出
echo -------------------------编译总时长: %duration_hours% 小时 %duration_minutes% 分钟 %duration_seconds% 秒
cd ..
echo 复制APP.exe到项目目录
@REM copy "buildReleaseAPP.exe" "APP.exe"
@REM copy "buildDebugAPP.exe" "APP.exe"
echo 复制lib目录中的debugg下的所有dll到buildDebug中
xcopy "libDebug" "buildDebug" /s /e
@REM xcopy "libRelease" "buildRelease" /s /e
echo 在build目录下Debug目录下创建download目录
if not exist "buildDebugdownload" (
mkdir "buildDebugdownload"
)
echo 在build目录下Debug目录下创建static目录
if not exist "buildDebugstatic" (
mkdir "buildDebugstatic"
)
echo 复制static目录中下的所有文件到buildDebugstatic中
xcopy "static" "buildDebugstatic" /s /e
@REM echo 复制static目录中下的所有文件到buildReleasestatic中
@REM xcopy "static" "buildReleasestatic" /s /e
echo 启动APP.exe
start "" "buildDebugapp.exe"
::pause
本项目基于MIT许可证开源，您可以在遵守许可证条款的前提下自由使用、修改和分发本项目的代码。
如果您发现任何问题或有改进建议，请随时提交问题或拉取请求。我们欢迎所有形式的贡献！
