企业官网建设流程全解析

国产化环境实战：银河麒麟系统下QGIS 3.26插件开发全流程指南

当你在银河麒麟系统上成功编译QGIS 3.26后，真正的挑战才刚刚开始。作为GIS工程师，我们需要的不仅是一个能运行的QGIS，而是一个完整的开发环境，能够支持自定义插件的创建、调试和部署。本文将带你深入国产化平台的QGIS插件开发全流程，从环境配置到第一个"Hello World"插件的实战测试。

1. 开发环境深度配置

编译完成的QGIS只是第一步，要让Python插件能够正常开发和运行，还需要解决几个关键问题。

1.1 PyQt5与QGIS Python API路径配置

在银河麒麟系统上，即使成功编译了QGIS，Python插件开发环境仍需要手动配置。这是因为自编译的QGIS可能无法自动识别系统Python环境中的PyQt5和QGIS API。

首先检查Python环境是否包含必要的QGIS模块：

python3 -c "from qgis.core import QgsProject; print('QGIS Python API可用')"

如果出现导入错误，需要手动设置PYTHONPATH环境变量。在~/.bashrc文件中添加以下内容：

export QGIS_PREFIX_PATH=/home/$USER/dev/QGIS/QGIS-final-3_26_0/build-master/output export PYTHONPATH=$QGIS_PREFIX_PATH/python:$PYTHONPATH export LD_LIBRARY_PATH=$QGIS_PREFIX_PATH/lib:$LD_LIBRARY_PATH

对于PyQt5，银河麒麟v10默认安装的版本可能与QGIS 3.26不兼容。建议使用pip安装特定版本：

pip3 install PyQt5==5.15.7 PyQt5-sip==12.11.0

验证PyQt5是否正确安装：

python3 -c "from PyQt5.QtWidgets import QApplication; print('PyQt5版本:', QApplication.instance())"

1.2 开发工具链选择与配置

在国产化平台上，我们有两个主要的IDE选择：

VSCode配置方案：

1. 安装VSCode官方麒麟版
2. 添加Python扩展和Qt for Python扩展
3. 配置launch.json调试环境：

{ "version": "0.2.0", "configurations": [ { "name": "Python: QGIS插件", "type": "python", "request": "launch", "program": "${workspaceFolder}/__init__.py", "console": "integratedTerminal", "env": { "QGIS_PREFIX_PATH": "/home/$USER/dev/QGIS/QGIS-final-3_26_0/build-master/output" } } ] }

Qt Creator配置方案：

1. 安装Qt Creator 5.15以上版本
2. 配置Kit使用系统Python 3.7环境
3. 在项目设置中添加自定义环境变量：
   • QGIS_PREFIX_PATH=你的QGIS编译输出路径
   • PYTHONPATH=你的QGIS Python模块路径

2. QGIS插件开发基础

2.1 插件目录结构与核心文件

一个标准的QGIS Python插件包含以下基本结构：

MyPlugin/ │── __init__.py # 插件入口文件 │── metadata.txt # 插件元数据 │── resources.qrc # Qt资源文件 │── resources.py # 编译后的资源文件 ├── ui/ # Qt Designer界面文件 │ └── my_dialog.ui └── icons/ # 插件图标 └── icon.png

metadata.txt是插件的身份证，必须包含以下关键信息：

[general] name=MyPlugin qgisMinimumVersion=3.16 version=1.0 author=YourName email=your.email@example.com description=A simple plugin demo about=This plugin demonstrates basic QGIS plugin functionality

2.2 插件生命周期与核心类

每个QGIS插件都必须实现三个核心方法：

from qgis.PyQt.QtWidgets import QAction, QDialog from qgis.PyQt.QtGui import QIcon from qgis.core import QgsProject class MyPlugin: def __init__(self, iface): self.iface = iface # QGIS接口对象 def initGui(self): """插件初始化，创建菜单和工具栏""" self.action = QAction( QIcon(":/plugins/myplugin/icon.png"), "Run My Plugin", self.iface.mainWindow()) self.action.triggered.connect(self.run) self.iface.addToolBarIcon(self.action) self.iface.addPluginToMenu("&My Plugin", self.action) def unload(self): """卸载插件时清理资源""" self.iface.removePluginMenu("&My Plugin", self.action) self.iface.removeToolBarIcon(self.action) del self.action def run(self): """插件主逻辑""" print("Hello from MyPlugin!")

3. 实战：从零开发Hello World插件

3.1 创建插件骨架

使用QGIS提供的插件模板生成工具可以快速创建插件骨架：

cd ~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/ mkdir HelloWorld cd HelloWorld

创建基本文件结构后，编辑__init__.py：

def classFactory(iface): from .helloworld import HelloWorldPlugin return HelloWorldPlugin(iface)

3.2 实现核心功能

在helloworld.py中实现插件逻辑：

from qgis.PyQt.QtWidgets import QMessageBox from qgis.core import QgsMessageLog class HelloWorldPlugin: def __init__(self, iface): self.iface = iface def initGui(self): self.action = self.iface.addToolBarIcon( QAction("Say Hello", self.iface.mainWindow())) self.action.triggered.connect(self.sayHello) def unload(self): self.iface.removeToolBarIcon(self.action) del self.action def sayHello(self): QgsMessageLog.logMessage("Hello World from plugin!", "HelloWorld") QMessageBox.information( self.iface.mainWindow(), "Hello World", "This is my first QGIS plugin on Kylin!")

3.3 调试与部署

调试插件时，可以使用QGIS的Python控制台实时查看日志输出：

import os import sys sys.path.append("/path/to/your/plugin") from HelloWorld import HelloWorldPlugin plugin = HelloWorldPlugin(iface) plugin.initGui()

部署插件有两种方式：

1. 直接复制到用户插件目录：~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/
2. 打包为zip文件通过QGIS插件管理器安装

4. 高级开发技巧与性能优化

4.1 处理国产化平台的特殊问题

在银河麒麟系统上开发QGIS插件可能会遇到一些特殊问题：

中文字符支持：

# 在插件入口处设置UTF-8编码 import locale locale.setlocale(locale.LC_ALL, 'zh_CN.UTF-8')

图形渲染性能优化：

# 在绘制大量要素时使用缓存 layer = iface.activeLayer() renderer = layer.renderer().clone() renderer.setForceRasterRender(True) # 强制栅格化渲染 layer.setRenderer(renderer) layer.triggerRepaint()

4.2 插件国际化支持

为插件添加多语言支持：

1. 创建翻译文件i18n/myplugin_zh_CN.ts
2. 在代码中使用翻译函数：

from qgis.PyQt.QtCore import QTranslator, QLocale, QCoreApplication class MyPlugin: def __init__(self, iface): # 初始化翻译 translator = QTranslator() translator.load( QLocale.system(), "myplugin", "_", ":/i18n/") QCoreApplication.installTranslator(translator)

4.3 插件性能监控

使用QGIS内置的性能分析工具监控插件性能：

from qgis.core import QgsApplication # 开始性能分析 QgsApplication.startProfiling() # ...执行你的插件代码... # 结束并获取分析结果 results = QgsApplication.profiler().results() for item in results: print(f"{item.function}: {item.elapsed}ms")

5. 插件发布与持续集成

5.1 插件打包规范

创建标准的插件发布包：

cd HelloWorld find . -name "*.pyc" -delete # 清理编译缓存 zip -r ../HelloWorld.zip * -x "*.git*" -x "*.vscode*" -x "*.pyc"

5.2 自动化测试框架

为插件添加单元测试：

import unittest from qgis.testing import start_app, stop_app class TestMyPlugin(unittest.TestCase): @classmethod def setUpClass(cls): start_app() # 初始化QGIS环境 def test_plugin_init(self): from HelloWorld.helloworld import HelloWorldPlugin plugin = HelloWorldPlugin(None) self.assertIsNotNone(plugin) @classmethod def tearDownClass(cls): stop_app() # 清理QGIS环境

5.3 国产化平台适配检查清单

在银河麒麟系统上发布插件前，检查以下项目：

• [ ] 依赖库版本与麒麟系统兼容
• [ ] 文件路径处理使用os.path而非硬编码
• [ ] 图形界面适配国产化主题
• [ ] 内存使用控制在合理范围
• [ ] 插件卸载时彻底清理资源