QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

前言:最近实习要求做一个QGIS插件,网上关于QGIS 3.14插件开发环境搭建的文档不多,而且也不算太全面。正好实习的时候写了一个文档,在这里给大家分享一下。

因为是Word转的Markdown,可能文章格式略有问题,不过没关系啦(。)


一、PyQGIS安装

在windows系统下,QGIS安装包会自动安装PyQGIS模块,本文以windows系统进行讲解。

实际上,如果使用新版本的QGIS for
Linux或Mac也会安装PyQGIS,可以参考QGIS官方文档。

二、Python环境变量配置

(1)配置Path

配置Python环境变量主要是为了从命令行运行python和调用pyqgis库。

先设置系统变量path,最好是放到最前面,防止被其他地方安装的python覆盖,如:

操作过程如系列图:此电脑(右键)—―属性→系统——高级系统设置→系统属性——环境变量→环境变量|系统变量

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

在系统变量中找到Path,点击编辑

添加环境变量:

D:\QGIS 3.14\bin

D:\QGIS 3.14\apps\qgis\bin

D:\QGIS 3.14\apps\Qt5\bin

(其中D:\QGIS 3.14 是你QGIS的安装位置)

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

(2)配置PYTHONPATH

PYTHONPATH主要是为了让Python能够找到PyQGIS的各种依赖模块,保证正常使用。

在系统变量中点击新建,新增名为PYTHONPATH系统变量。

变量值设置为:

D:\QGIS 3.14\apps\Python37;

D:\QGIS 3.14\apps\qgis\bin;

D:\QGIS3.14\apps\qgis\python;

D:\QGIS 3.14\apps\Python37\lib;

D:\QGIS 3.14\apps\Python37\Lib\site-packages;

D:\QGIS 3.14\apps\Python37\DLLs;

D:\QGIS 3.14\apps\Python37\Scripts;

(其中D:\QGIS 3.14是你的qgis安装路径,python37是qgis自带python的版本)

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

(3)检查环境变量配置是否成功

Win+r 打开运行窗口,输入cmd启动命令提示行

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

输入python3或者python,运行python。该python版本应为qgis自带python版本。

然后输入:

import qgis.core

import qgis.user

import qgis.gui

import console

没有提示错误即为配置成功

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

三、使用QGIS构建插件项目

插件安装和构建插件项目的流程如下:

(1) 插件安装

打开QGIS,插件——

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

因为我们后面使用PyCharm开发,QGIS中Remote Debug这个工具可有可无。

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

(2)插件路径设置

在QGIS的设置-选项-系统中,找到环境一栏,勾选“使用自定义变量”,添加插件工作区路径。之后的插件需要生成到这个路径下,QGIS才能自动识别到。

例如我设置为:E:\QGIS_plugin_develop

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

(3)创建插件

https://www.osgeo.cn/qgisdoc/docs/pyqgis_developer_cookbook/plugins/index.html

创建插件工程

重新启动QGIS

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

这里的Class name是插件的类名,Plugin name是你的插件名,Moule
name是python模块的名称。如果只是开发练习,后面那些乱七八糟的随便填就好。

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

如果不想发布插件,只做练习使用,这里建议大家勾选Flag the plugin as
experimental选项

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

这里选择之前设置的插件工作区的路径,自动生成的插件模板就会放置于该目录下。

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

为了避免不必要的麻烦。插件生成完毕后,先不要加载插件,否则会提示缺少:
resources.py 文件

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

如果弹出以下对话框,也暂时先不管,咱们之后再处理。

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

这样插件项目模板创建好了,可以在刚才我们创建的目录下查看

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

四、搭建PyCharm开发环境

PyCharm有两种版本,一种是免费的Community版,一种是Professional版。

其中Pycharm Community版本不支持Remote
Debug。如果想要使用Pycharm的远程调试功能调用Pydev包(Pydevd-pycharm)进行调试,就需要安装Professional版本

JetBrains全家桶提供了学生授权供学生免费使用。只要使用大学的邮箱在其官网注册一个账号,然后申请学生授权就可以免费使用JetBrains的所有产品。

参考:https://jingyan.baidu.com/article/acf728fd862d44f8e510a385.html

当然,如果觉得自己不需要用到调试功能,下载Community版本也可。下面以Community版本讲解PyCharm的环境搭建。Professional版本的搭建过程也是一样的。

安装Pycharm Community流程,如下:

(1) 下载

官方网站 https://www.jetbrains.com/pycharm/

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

选择保存后,等待下载。

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

找到下载文件

(2)安装

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

双击安装文件。

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

选择安装目录,Pycharm需要的内存较多,建议将其安装在D盘或者E盘,不建议放在系统盘C盘:

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

create desktop
shortcut(创建桌面快捷方式):系统32位就选32-bit,系统64位就选64-bit。现在大多数都是64位了,不清楚系统类型:我的电脑=》右键=》属性

update path variable(restart needed)更新路径变量(需要重新启动):add launchers
dir to the path(将启动器目录添加到path中)。这里我建议大家添加到环境变量PATH。

update context menu(更新上下文菜单):add open folder as
project(添加打开文件夹作为项目)。可以不选。

create associations 创建关联:关联.py文件,双击都是以pycharm打开。

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

(3)PyCharm python解释器设置

打开安装好的PyCharm:

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

设置UI颜色

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

直接下一步即可

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

这里选择Open打开我们之前生成插件项目。然后File-Settings打开设置

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

打开设置后,找到python interpreter,点击右上角的设置Add

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

选择System Interpreter(这里不推荐大家自己构建虚拟环境),添加Python解释器:

D:\QGIS 3.14\apps\Python37\python.exe

(其中D:\QGIS 3.14是你的安装路径)

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

可以看到,PyCharm已经帮我们把相关的包引入进来了

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

(4)安装扩展工具

在Settings中选择Tools打开External Tools页面,点击+号添加扩展工具。

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

添加QtDesigner,用于编辑UI

Name:QtDesigner

Program:D:\QGIS 3.14\apps\Qt5\bin\designer.exe

Working directory:你的插件项目的目录

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

添加PyUIC(UI转换工具),用于将ui转换为py模块

Name:Pyuic

Program:D:\QGIS 3.14\apps\Python37\Scripts\pyuic5.bat

Arguments: $FileName$ -o $FileNameWithoutExtension$.py

Working directory:你的插件项目的目录

(其中Arguments相当于一段控制台命令,是调用pyuic5.bat的参数)

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

添加PyRCC(资源转换工具),用于将qrc转换为py模块

Name:Pyrcc

Program:D:\QGIS 3.14\apps\Python37\Scripts\pyrcc5.bat

Arguments: $FileName$ -o $FileNameWithoutExtension$.py

Working directory:你的插件项目的目录

(这里的Arguments也是同样的道理)

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

(5)创建resources.py和图形界面py文件

创建图形界面py文件:

找到项目目录下,扩展名为ui的文件(文件名根据你设置的插件模块名有所不同),右键External
Tools-Pyuic运行扩展工具

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

没有报错,并且在项目目录下出现同名的py文件则为转换成功。

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

同理,对resources.rcc的文件,右键选择右键External Tools-Pyrcc

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

(6)运行插件

万事俱备,打开QGIS,插件栏选择管理并安装插件。

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

在已安装的插件中找到并勾选我们的插件,然后运行我们的插件即可。

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走

上一篇:X Window 的奥秘


下一篇:SQL正则表达式