feat: Service Registry + Bridge 解耦架构 + 全工程代码清理

## 架构升级：Service Registry + Bridge 模式 - 新增 PluginSDK/IPluginServices.h：10 个纯虚服务接口(IDataProvider/ILinkProvider/...) - 新增 MavLinkServiceBridge：单 QObject 实现全部服务，隔离 MavLinkNode 依赖 - 升级 PluginManifest：支持 plugin.json 的 provides/consumes 声明式依赖 - 实现 ExtensionHost::autoWire()：元对象自省自动连接信号槽 - 集成到 AppController：initModules() 中创建桥接器并注册到 ServiceRegistry - CockpitPlugin 演示服务发现：initialize() 中通过 PluginContext 查找服务 ## 代码清理 - Plugins/opmap：~280 行死代码(waypointsetting 100行注释块/tilematrix 54行/等27个文件) - Plugins/MavLinkNode：~200 行 GBK 乱码注释翻译为 UTF-8 + 12 行注释死代码 - Plugins/ToolsUI：~222 行死代码(ECU.cpp 82行/INS.cpp 113行/Parse/ToolsUI 等) - StatusUI/Setting/MissionUI：~65 行注释死代码 - Cockpit/leftladder.cpp：10 处 GBK 乱码翻译为中文 - 清理头文件注释掉的 #include(19 处)、空 if-else 分支、注释变量声明 ## 编译验证 - [100%] Built target GCS 零错误 - 运行时 timeout 3s 正常退出，无崩溃
2026-06-01 09:46:36 +08:00
parent 6fbb96dd9a
commit e7cf44504c
2188 changed files with 549867 additions and 45008 deletions
@@ -0,0 +1,91 @@
+/****************************************************************************
+ *
+ * (c) 2009-2020 QGROUNDCONTROL PROJECT <http://www.qgroundcontrol.org>
+ *
+ * QGroundControl is licensed according to the terms in the file
+ * COPYING.md in the root of the source code directory.
+ *
+ ****************************************************************************/
+
+#ifndef JsonHelper_H
+#define JsonHelper_H
+
+#include <QJsonObject>
+#include <QVariantList>
+
+/// @file
+/// @author Don Gagne <don@thegagnes.com>
+
+class QmlObjectListModel;
+
+/// @brief Json manipulation helper class.
+/// Primarily used for parsing and processing Fact metadata.
+class JsonHelper
+{
+public:
+    /// Determines is the specified data is a json file
+    /// @return true: file is json, false: file is not json
+    static bool isJsonFile(const QByteArray&    bytes,          ///< json bytes
+                           QJsonDocument&       jsonDoc,        ///< returned json document
+                           QString&             errorString);   ///< error on parse failure
+
+    /// Saves the standard file header the json object
+    static void saveQGCJsonFileHeader(QJsonObject&      jsonObject, ///< root json object
+                                      const QString&    fileType,   ///< file type for file
+                                      int               version);   ///< version number for file
+
+    /// Validates the standard parts of a QGC json file:
+    ///     jsonFileTypeKey - Required and checked to be equal to expectedFileType
+    ///     jsonVersionKey - Required and checked to be below supportedMajorVersion, supportedMinorVersion
+    ///     jsonGroundStationKey - Required and checked to be string type
+    /// @return false: validation failed, errorString set
+    static bool validateQGCJsonFile(const QJsonObject&  jsonObject,             ///< json object to validate
+                                    const QString&      expectedFileType,       ///< correct file type for file
+                                    int                 minSupportedVersion,    ///< minimum supported version
+                                    int                 maxSupportedVersion,    ///< maximum supported major version
+                                    int                 &version,               ///< returned file version
+                                    QString&            errorString);           ///< returned error string if validation fails
+
+    /// Validates that the specified keys are in the object
+    /// @return false: validation failed, errorString set
+    static bool validateRequiredKeys(const QJsonObject& jsonObject, ///< json object to validate
+                                     const QStringList& keys,       ///< keys which are required to be present
+                                     QString& errorString);         ///< returned error string if validation fails
+
+    /// Validates the types of specified keys are in the object
+    /// @return false: validation failed, errorString set
+    static bool validateKeyTypes(const QJsonObject& jsonObject,         ///< json object to validate
+                                 const QStringList& keys,               ///< keys to validate
+                                 const QList<QJsonValue::Type>& types,  ///< required type for each key, QJsonValue::Null specifies double with possible NaN
+                                 QString& errorString);                 ///< returned error string if validation fails
+
+    typedef struct {
+        const char*         key;        ///< json key name
+        QJsonValue::Type    type;       ///< required type for key, QJsonValue::Null specifies double with possible NaN
+        bool                required;   ///< true: key must be present
+    } KeyValidateInfo;
+
+    static bool validateKeys(const QJsonObject& jsonObject, const QList<KeyValidateInfo>& keyInfo, QString& errorString);
+
+
+
+    static bool parseEnum(const QJsonObject& jsonObject, QStringList& enumStrings, QStringList& enumValues, QString& errorString, QString valueName = QString());
+    static bool parseEnum(const QJsonObject& jsonObject, QMap<QString, QString>& defineMap, QStringList& enumStrings, QStringList& enumValues, QString& errorString, QString valueName = QString());
+
+    /// Returns NaN if the value is null, or if not, the double value
+    static double possibleNaNJsonValue(const QJsonValue& value);
+
+    static const char* jsonVersionKey;
+    static const char* jsonGroundStationKey;
+    static const char* jsonGroundStationValue;
+    static const char* jsonFileTypeKey;
+
+private:
+    static QString _jsonValueTypeToString(QJsonValue::Type type);
+    static bool _parseEnumWorker(const QJsonObject& jsonObject, QMap<QString, QString>& defineMap, QStringList& enumStrings, QStringList& enumValues, QString& errorString, QString valueName);
+
+    static const char*  _enumStringsJsonKey;
+    static const char*  _enumValuesJsonKey;
+};
+
+#endif