From b1c6778cfed4e26afe90032ed5b446d97ebebf80 Mon Sep 17 00:00:00 2001 From: jzxc95 <907297917@qq.com> Date: Fri, 1 Apr 2022 09:37:30 +0800 Subject: [PATCH 1/4] update README --- README.md | 203 ++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 189 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index a59ec5ed..d6f31658 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,190 @@ -# NAME - kylin-nm - kylin network monitor used in ubuntu-kylin operation system - -# DESCRIPTION - kylin-nm is a Qt based applet and uses some interface provided by NetworkManager. - It provides a GUI for users to connect or disconnect wired or wireless network which managed by NetworkManager. - Users can also create new wired network and configure a old network. - By click button at left bottom in the main window, a network configure window of NetworkManager will show in the screen. - Users can get some information about network directly by clicking one item in the network list, these information shown in extension area. +#kylin-nm介绍 +##简介 +麒麟网络工具（kylin-network-manager，简称kylin-nm）是操作系统的网络前端，其主要功能有： +1、托盘栏图标及右键菜单 +查看当前网络状态 +左键点击托盘网络图标显示kylin-nm主界面 +右键点击托盘网络图标显示右键菜单 +2、对有线网络的管理 +有线网络界面管理 +连接/断开网络 +网线拔插 +多有线网卡支持 +打开或关闭有线开关 +查看或修改无线网络基本信息 +3、对无线网络的管理 +切换及刷新无线界面 +查看无线网络列表 +连接/断开无需密码的无线网 +连接/断开有密码类型的无线网 +无线网卡插拔 +多无线网卡支持 +打开或关闭无线开关 +查看或修改无线网络基本信息 +4、连接隐藏无线网络 +连接无安全性的无线网络 +连接WPA及WPA2个人安全性的无线网络 +连接WPA及WPA2企业安全性的无线网络 +连接WPA3个人安全性的无线网络 +5、窗口样式调节 +深色与浅色窗口样式切换 +调节网络工具窗口透明度 +普通窗口与具有毛玻璃效果的窗口的切换 +##运行 +麒麟网络工具的进程为kylin-nm，默认开机自启，依赖NetworkManger +##命令行和dbus接口 + +kylin-nm进程的命令行如下： +Usage: kylin-nm + +###dbus接口： +DBUS类型：SESSION BUS +DBUS名称：com.kylin.network +OBJECT路径：/ +接口名称：com.kylin.network + +###dbus方法 +getWirelessList +参数：无 +返回值：QMap> +键:网卡名称 +值:无线网络的集合(第一项为已连接网络信息，若无连接则为"--"，否则为"名称/信号强度/加密类型/Uuid/是否为本机开放热点";其余为未连接的网络信息，为"名称/信号强度/加密类型/是否为本机开放热点" +功能：获取无线列表及每个对应无线网络的信号强度、加密类型等信息。 + +getWiredList +参数：无 +返回值：QMap> +键:网卡名称 +值:有线网络的集合("名称/UUID/对应DBUS路径"），若无已连接网络则第一项默认为"--" +功能：获取有线列表及每个对应的有线网络的uuid及dbus路径 + +setWiredSwitchEnable(bool enable) +参数：(bool）开启有线总开关（true）关闭有线总开关（false） +返回值：无 +功能：打开或关闭有线总开关 + +setWirelessSwitchEnable(bool enable) +参数：(bool）开启无线总开关（true）关闭无线总开关（false） +返回值：无 +功能：打开或关闭无线总开关 + +setDeviceEnable(QString devName, bool enable) +参数：（QString）devName 设备名称，（bool） enable 开启/关闭 +返回值：无 +功能：打开或关闭单个有线网卡开关 + +activateConnect（int type, QString devName, QString ssid） +参数：根据网卡类型 参数1 0:lan 1:wlan 参数2：网卡名称 参数3：uuid/ssid +返回值：无 +功能：激活一个网络连接 + +deActivateConnect(int type, QString devName, QString ssid) +参数：根据网卡类型 参数1 0:lan 1:wlan 参数2：网卡名称 参数3：uuid/ssid +返回值：无 +功能：断开一个网络连接 + +getDeviceListAndEnabled(int devType) +参数：int devType 0:lan 1:wlan +返回值：QMap +键：设备名称 +值：bool 开启（true）关闭 （false） +功能：获取设备列表和启用/禁用状态 + +getWirelessDeviceCap +返回值：QMap +键：设备名称 +值：int 0：不支持热点 3：支持2.4GHz 7：支持5GHz&&2.4Ghz +功能：获取无线设备能力(2.4G/5G) + +showPropertyWidget(QString devName, QString ssid); +参数：QString devName 设备名称 QString ssid 根据网卡类型 有线为uuid/无线为ssid +返回值：无 +功能：唤起对应网络连接的属性页，可以对基础信息的显示或修改 + +showCreateWiredConnectWidget(QString devName) +参数：QString devName 有线网卡名称 +返回值：无 +功能：唤起新建有线连接界面 + +activeWirelessAp(const QString apName, + const QString apPassword, +const QString band, +const QString apDevice) +参数：QString apName 热点名称 + QString apPassword 热点密码 + QString band 频带 + QString apDevice +返回值：无 +功能：开启移动热点 + +deactiveWirelessAp(const QString apName, const QString uuid) +参数：QStringList（名称/密码/设备名称/状态/UUID/频带） +返回值：无 +功能： 断开移动热点 + +getStoredApInfo +参数：QStringList（名称/密码/设备名称/状态/UUID/频带） +返回值：无 +功能：获取已保存的移动热点信息 + +getApInfoBySsid(QString devName, QString ssid) +参数：QString devName 设备名称 QString ssid +返回值：无 +功能： 通过名称获取已保存的移动热点信息 + +reScan() +参数：无 +返回值：无 +功能： 申请重新进行无线扫描 + +keyRingInit() +参数：QString apName 热点名称 QString uuid +返回值：无 +功能： 断开移动热点 + +keyRingClear() +参数：无 +返回值：无 +功能： 断开移动热点 + + +##原理与主要使用的技术 +kylin-nm主要与NetworkManager进行交互，通过对应的dbus信号驱动UI界面的更新。并通过提供的dbus方法来进行网络相关功能的调用。 + +麒麟网络工具按照功能划分成两层：UI层和逻辑层。UI层实现网络资源的显示，以及用户的交互，逻辑层通过NetworkManager提供的Dbus接口，完成网络资源的管理及其配置。 +##配置文件 +kylin-nm的配置文件保存在如下路径： +文件                  文件说明 +~/.config/ukui/kylin-nm.conf 有线无线开关状态 设备状态 +org.ukui.kylin-nm.switch 对应的gsetting值 （有线无线开关状态） +##编译 +cd kylin-nm +mkdir build +cd build +qmake .. +make +sudo make install  +##运行命令 +./kylin-nm +##调试 +kylin-nm目前并采用ukui-log4qt模块的日志功能。日志默认保存在~/.log/kylin-nm.log中 + + + + + + + + + + + + + + + + + + + -# BUILD KYLIN-NM - down the source sode - install dependency packages(see cntrol files in the debian directory) - execute debuild command in the root directory of project - execute sudo dpkg -i packagename.deb to install From 6e1cfc6f4d9f99bc5b675c4b916db2ed7efde10d Mon Sep 17 00:00:00 2001 From: jzxc95 <907297917@qq.com> Date: Fri, 1 Apr 2022 09:47:53 +0800 Subject: [PATCH 2/4] update --- README.md | 287 +++++++++++++++++++++++++++--------------------------- 1 file changed, 143 insertions(+), 144 deletions(-) diff --git a/README.md b/README.md index d6f31658..83f3b745 100644 --- a/README.md +++ b/README.md @@ -1,173 +1,172 @@ -#kylin-nm介绍 -##简介 -麒麟网络工具（kylin-network-manager，简称kylin-nm）是操作系统的网络前端，其主要功能有： -1、托盘栏图标及右键菜单 -查看当前网络状态 -左键点击托盘网络图标显示kylin-nm主界面 -右键点击托盘网络图标显示右键菜单 -2、对有线网络的管理 -有线网络界面管理 -连接/断开网络 -网线拔插 -多有线网卡支持 -打开或关闭有线开关 -查看或修改无线网络基本信息 -3、对无线网络的管理 -切换及刷新无线界面 -查看无线网络列表 -连接/断开无需密码的无线网 -连接/断开有密码类型的无线网 -无线网卡插拔 -多无线网卡支持 -打开或关闭无线开关 -查看或修改无线网络基本信息 -4、连接隐藏无线网络 -连接无安全性的无线网络 -连接WPA及WPA2个人安全性的无线网络 -连接WPA及WPA2企业安全性的无线网络 -连接WPA3个人安全性的无线网络 -5、窗口样式调节 -深色与浅色窗口样式切换 -调节网络工具窗口透明度 -普通窗口与具有毛玻璃效果的窗口的切换 -##运行 -麒麟网络工具的进程为kylin-nm，默认开机自启，依赖NetworkManger -##命令行和dbus接口 +#kylin-nm介绍 +##简介 +麒麟网络工具（kylin-network-manager，简称kylin-nm）是操作系统的网络前端，其主要功能有： +1、托盘栏图标及右键菜单 +查看当前网络状态 +左键点击托盘网络图标显示kylin-nm主界面 +右键点击托盘网络图标显示右键菜单 +2、对有线网络的管理 +有线网络界面管理 +连接/断开网络 +网线拔插 +多有线网卡支持 +打开或关闭有线开关 +查看或修改无线网络基本信息 +3、对无线网络的管理 +切换及刷新无线界面 +查看无线网络列表 +连接/断开无需密码的无线网 +连接/断开有密码类型的无线网 +无线网卡插拔 +多无线网卡支持 +打开或关闭无线开关 +查看或修改无线网络基本信息 +4、连接隐藏无线网络 +连接无安全性的无线网络 +连接WPA及WPA2个人安全性的无线网络 +连接WPA及WPA2企业安全性的无线网络 +连接WPA3个人安全性的无线网络 +5、窗口样式调节 +深色与浅色窗口样式切换 +调节网络工具窗口透明度 +普通窗口与具有毛玻璃效果的窗口的切换 +##运行 +麒麟网络工具的进程为kylin-nm，默认开机自启，依赖NetworkManger +##命令行和dbus接口 -kylin-nm进程的命令行如下： -Usage: kylin-nm +kylin-nm进程的命令行如下： +Usage: kylin-nm -###dbus接口： -DBUS类型：SESSION BUS -DBUS名称：com.kylin.network -OBJECT路径：/ -接口名称：com.kylin.network +###dbus接口： +DBUS类型：SESSION BUS +DBUS名称：com.kylin.network +OBJECT路径：/ +接口名称：com.kylin.network -###dbus方法 -getWirelessList -参数：无 -返回值：QMap> -键:网卡名称 -值:无线网络的集合(第一项为已连接网络信息，若无连接则为"--"，否则为"名称/信号强度/加密类型/Uuid/是否为本机开放热点";其余为未连接的网络信息，为"名称/信号强度/加密类型/是否为本机开放热点" -功能：获取无线列表及每个对应无线网络的信号强度、加密类型等信息。 +###dbus方法 +getWirelessList +参数：无 +返回值：QMap> +键:网卡名称 +值:无线网络的集合(第一项为已连接网络信息，若无连接则为"--"，否则为"名称/信号强度/加密类型/Uuid/是否为本机开放热点";其余为未连接的网络信息，为"名称/信号强度/加密类型/是否为本机开放热点" +功能：获取无线列表及每个对应无线网络的信号强度、加密类型等信息。 -getWiredList -参数：无 -返回值：QMap> -键:网卡名称 -值:有线网络的集合("名称/UUID/对应DBUS路径"），若无已连接网络则第一项默认为"--" -功能：获取有线列表及每个对应的有线网络的uuid及dbus路径 +getWiredList +参数：无 +返回值：QMap> +键:网卡名称 +值:有线网络的集合("名称/UUID/对应DBUS路径"），若无已连接网络则第一项默认为"--" +功能：获取有线列表及每个对应的有线网络的uuid及dbus路径 -setWiredSwitchEnable(bool enable) -参数：(bool）开启有线总开关（true）关闭有线总开关（false） -返回值：无 -功能：打开或关闭有线总开关 +setWiredSwitchEnable(bool enable) +参数：(bool）开启有线总开关（true）关闭有线总开关（false） +返回值：无 +功能：打开或关闭有线总开关 -setWirelessSwitchEnable(bool enable) -参数：(bool）开启无线总开关（true）关闭无线总开关（false） -返回值：无 -功能：打开或关闭无线总开关 +setWirelessSwitchEnable(bool enable) +参数：(bool）开启无线总开关（true）关闭无线总开关（false） +返回值：无 +功能：打开或关闭无线总开关 -setDeviceEnable(QString devName, bool enable) -参数：（QString）devName 设备名称，（bool） enable 开启/关闭 -返回值：无 -功能：打开或关闭单个有线网卡开关 +setDeviceEnable(QString devName, bool enable) +参数：（QString）devName 设备名称，（bool） enable 开启/关闭 +返回值：无 +功能：打开或关闭单个有线网卡开关 -activateConnect（int type, QString devName, QString ssid） -参数：根据网卡类型 参数1 0:lan 1:wlan 参数2：网卡名称 参数3：uuid/ssid -返回值：无 -功能：激活一个网络连接 +activateConnect（int type, QString devName, QString ssid） +参数：根据网卡类型 参数1 0:lan 1:wlan 参数2：网卡名称 参数3：uuid/ssid +返回值：无 +功能：激活一个网络连接 -deActivateConnect(int type, QString devName, QString ssid) -参数：根据网卡类型 参数1 0:lan 1:wlan 参数2：网卡名称 参数3：uuid/ssid -返回值：无 -功能：断开一个网络连接 +deActivateConnect(int type, QString devName, QString ssid) +参数：根据网卡类型 参数1 0:lan 1:wlan 参数2：网卡名称 参数3：uuid/ssid +返回值：无 +功能：断开一个网络连接 -getDeviceListAndEnabled(int devType) -参数：int devType 0:lan 1:wlan -返回值：QMap -键：设备名称 -值：bool 开启（true）关闭 （false） -功能：获取设备列表和启用/禁用状态 +getDeviceListAndEnabled(int devType) +参数：int devType 0:lan 1:wlan +返回值：QMap +键：设备名称 +值：bool 开启（true）关闭 （false） +功能：获取设备列表和启用/禁用状态 -getWirelessDeviceCap -返回值：QMap -键：设备名称 -值：int 0：不支持热点 3：支持2.4GHz 7：支持5GHz&&2.4Ghz -功能：获取无线设备能力(2.4G/5G) +getWirelessDeviceCap +返回值：QMap +键：设备名称 +值：int 0：不支持热点 3：支持2.4GHz 7：支持5GHz&&2.4Ghz +功能：获取无线设备能力(2.4G/5G) -showPropertyWidget(QString devName, QString ssid); -参数：QString devName 设备名称 QString ssid 根据网卡类型 有线为uuid/无线为ssid -返回值：无 -功能：唤起对应网络连接的属性页，可以对基础信息的显示或修改 +showPropertyWidget(QString devName, QString ssid) +参数：QString devName 设备名称 QString ssid 根据网卡类型 有线为uuid/无线为ssid +返回值：无 +功能：唤起对应网络连接的属性页，可以对基础信息的显示或修改 -showCreateWiredConnectWidget(QString devName) -参数：QString devName 有线网卡名称 -返回值：无 -功能：唤起新建有线连接界面 +showCreateWiredConnectWidget(QString devName) +参数：QString devName 有线网卡名称 +返回值：无 +功能：唤起新建有线连接界面 activeWirelessAp(const QString apName, const QString apPassword, const QString band, -const QString apDevice) -参数：QString apName 热点名称 - QString apPassword 热点密码 - QString band 频带 - QString apDevice -返回值：无 -功能：开启移动热点 +const QString apDevice) +参数：QString apName 热点名称 + QString apPassword 热点密码 + QString band 频带 + QString apDevice +返回值：无 +功能：开启移动热点 -deactiveWirelessAp(const QString apName, const QString uuid) -参数：QStringList（名称/密码/设备名称/状态/UUID/频带） -返回值：无 -功能： 断开移动热点 +deactiveWirelessAp(const QString apName, const QString uuid) +参数：QStringList（名称/密码/设备名称/状态/UUID/频带） +返回值：无 +功能： 断开移动热点 -getStoredApInfo -参数：QStringList（名称/密码/设备名称/状态/UUID/频带） -返回值：无 -功能：获取已保存的移动热点信息 +getStoredApInfo +参数：QStringList（名称/密码/设备名称/状态/UUID/频带） +返回值：无 +功能：获取已保存的移动热点信息 -getApInfoBySsid(QString devName, QString ssid) -参数：QString devName 设备名称 QString ssid -返回值：无 -功能： 通过名称获取已保存的移动热点信息 +getApInfoBySsid(QString devName, QString ssid) +参数：QString devName 设备名称 QString ssid +返回值：无 +功能： 通过名称获取已保存的移动热点信息 -reScan() -参数：无 -返回值：无 -功能： 申请重新进行无线扫描 +reScan() +参数：无 +返回值：无 +功能： 申请重新进行无线扫描 -keyRingInit() -参数：QString apName 热点名称 QString uuid -返回值：无 -功能： 断开移动热点 +keyRingInit() +参数：QString apName 热点名称 QString uuid +返回值：无 +功能： 断开移动热点 -keyRingClear() -参数：无 -返回值：无 -功能： 断开移动热点 +keyRingClear() +参数：无 +返回值：无 +功能： 断开移动热点 -##原理与主要使用的技术 -kylin-nm主要与NetworkManager进行交互，通过对应的dbus信号驱动UI界面的更新。并通过提供的dbus方法来进行网络相关功能的调用。 +##原理与主要使用的技术 +kylin-nm主要与NetworkManager进行交互，通过对应的dbus信号驱动UI界面的更新。并通过提供的dbus方法来进行网络相关功能的调用。 -麒麟网络工具按照功能划分成两层：UI层和逻辑层。UI层实现网络资源的显示，以及用户的交互，逻辑层通过NetworkManager提供的Dbus接口，完成网络资源的管理及其配置。 -##配置文件 -kylin-nm的配置文件保存在如下路径： -文件                  文件说明 -~/.config/ukui/kylin-nm.conf 有线无线开关状态 设备状态 -org.ukui.kylin-nm.switch 对应的gsetting值 （有线无线开关状态） -##编译 -cd kylin-nm -mkdir build -cd build -qmake .. -make -sudo make install  -##运行命令 -./kylin-nm -##调试 -kylin-nm目前并采用ukui-log4qt模块的日志功能。日志默认保存在~/.log/kylin-nm.log中 +麒麟网络工具按照功能划分成两层：UI层和逻辑层。UI层实现网络资源的显示，以及用户的交互，逻辑层通过NetworkManager提供的Dbus接口，完成网络资源的管理及其配置。 +##配置文件 +kylin-nm的配置文件保存在如下路径： +~/.config/ukui/kylin-nm.conf 有线无线开关状态 设备状态 +org.ukui.kylin-nm.switch 对应的gsetting值 （有线无线开关状态） +##编译 +cd kylin-nm +mkdir build +cd build +qmake .. +make +sudo make install  +##运行命令 +./kylin-nm +##调试 +kylin-nm目前并采用ukui-log4qt模块的日志功能。日志默认保存在~/.log/kylin-nm.log中 From 0cff2837a47f3617d37484721f8a43591bf70402 Mon Sep 17 00:00:00 2001 From: jzxc95 <907297917@qq.com> Date: Fri, 1 Apr 2022 10:29:04 +0800 Subject: [PATCH 3/4] update --- README.md | 292 +++++++++++++++++++++++++++--------------------------- 1 file changed, 146 insertions(+), 146 deletions(-) diff --git a/README.md b/README.md index 83f3b745..e2c4faff 100644 --- a/README.md +++ b/README.md @@ -1,172 +1,172 @@ -#kylin-nm介绍 -##简介 -麒麟网络工具（kylin-network-manager，简称kylin-nm）是操作系统的网络前端，其主要功能有： -1、托盘栏图标及右键菜单 -查看当前网络状态 -左键点击托盘网络图标显示kylin-nm主界面 -右键点击托盘网络图标显示右键菜单 -2、对有线网络的管理 -有线网络界面管理 -连接/断开网络 -网线拔插 -多有线网卡支持 -打开或关闭有线开关 -查看或修改无线网络基本信息 -3、对无线网络的管理 -切换及刷新无线界面 -查看无线网络列表 -连接/断开无需密码的无线网 -连接/断开有密码类型的无线网 -无线网卡插拔 -多无线网卡支持 -打开或关闭无线开关 -查看或修改无线网络基本信息 -4、连接隐藏无线网络 -连接无安全性的无线网络 -连接WPA及WPA2个人安全性的无线网络 -连接WPA及WPA2企业安全性的无线网络 -连接WPA3个人安全性的无线网络 -5、窗口样式调节 -深色与浅色窗口样式切换 -调节网络工具窗口透明度 -普通窗口与具有毛玻璃效果的窗口的切换 -##运行 -麒麟网络工具的进程为kylin-nm，默认开机自启，依赖NetworkManger -##命令行和dbus接口 +##kylin-nm介绍 +###简介 + 麒麟网络工具（kylin-network-manager，简称kylin-nm）是操作系统的网络前端，其主要功能有： + 1、托盘栏图标及右键菜单 + 查看当前网络状态 + 左键点击托盘网络图标显示kylin-nm主界面 + 右键点击托盘网络图标显示右键菜单 + 2、对有线网络的管理 + 有线网络界面管理 + 连接/断开网络 + 网线拔插 + 多有线网卡支持 + 打开或关闭有线开关 + 查看或修改无线网络基本信息 + 3、对无线网络的管理 + 切换及刷新无线界面 + 查看无线网络列表 + 连接/断开无需密码的无线网 + 连接/断开有密码类型的无线网 + 无线网卡插拔 + 多无线网卡支持 + 打开或关闭无线开关 + 查看或修改无线网络基本信息 + 4、连接隐藏无线网络 + 连接无安全性的无线网络 + 连接WPA及WPA2个人安全性的无线网络 + 连接WPA及WPA2企业安全性的无线网络 + 连接WPA3个人安全性的无线网络 + 5、窗口样式调节 + 深色与浅色窗口样式切换 + 调节网络工具窗口透明度 + 普通窗口与具有毛玻璃效果的窗口的切换 +###运行 + 麒麟网络工具的进程为kylin-nm，默认开机自启，依赖NetworkManger +###命令行和dbus接口 -kylin-nm进程的命令行如下： -Usage: kylin-nm + kylin-nm进程的命令行如下： + Usage: kylin-nm -###dbus接口： -DBUS类型：SESSION BUS -DBUS名称：com.kylin.network -OBJECT路径：/ -接口名称：com.kylin.network +####dbus接口： + DBUS类型：SESSION BUS + DBUS名称：com.kylin.network + OBJECT路径：/ + 接口名称：com.kylin.network -###dbus方法 -getWirelessList -参数：无 -返回值：QMap> -键:网卡名称 -值:无线网络的集合(第一项为已连接网络信息，若无连接则为"--"，否则为"名称/信号强度/加密类型/Uuid/是否为本机开放热点";其余为未连接的网络信息，为"名称/信号强度/加密类型/是否为本机开放热点" -功能：获取无线列表及每个对应无线网络的信号强度、加密类型等信息。 +####dbus方法 + getWirelessList + 参数：无 + 返回值：QMap> + 键:网卡名称 + 值:无线网络的集合(第一项为已连接网络信息，若无连接则为"--"，否则为"名称/信号强度/加密类型/Uuid/是否为本机开放热点";其余为未连接的网络信息，为"名称/信号强度/加密类型/是否为本机开放热点" + 功能：获取无线列表及每个对应无线网络的信号强度、加密类型等信息。 -getWiredList -参数：无 -返回值：QMap> -键:网卡名称 -值:有线网络的集合("名称/UUID/对应DBUS路径"），若无已连接网络则第一项默认为"--" -功能：获取有线列表及每个对应的有线网络的uuid及dbus路径 + getWiredList + 参数：无 + 返回值：QMap> + 键:网卡名称 + 值:有线网络的集合("名称/UUID/对应DBUS路径"），若无已连接网络则第一项默认为"--" + 功能：获取有线列表及每个对应的有线网络的uuid及dbus路径 -setWiredSwitchEnable(bool enable) -参数：(bool）开启有线总开关（true）关闭有线总开关（false） -返回值：无 -功能：打开或关闭有线总开关 + setWiredSwitchEnable(bool enable) + 参数：(bool）开启有线总开关（true）关闭有线总开关（false） + 返回值：无 + 功能：打开或关闭有线总开关 -setWirelessSwitchEnable(bool enable) -参数：(bool）开启无线总开关（true）关闭无线总开关（false） -返回值：无 -功能：打开或关闭无线总开关 + setWirelessSwitchEnable(bool enable) + 参数：(bool）开启无线总开关（true）关闭无线总开关（false） + 返回值：无 + 功能：打开或关闭无线总开关 -setDeviceEnable(QString devName, bool enable) -参数：（QString）devName 设备名称，（bool） enable 开启/关闭 -返回值：无 -功能：打开或关闭单个有线网卡开关 + setDeviceEnable(QString devName, bool enable) + 参数：（QString）devName 设备名称，（bool） enable 开启/关闭 + 返回值：无 + 功能：打开或关闭单个有线网卡开关 -activateConnect（int type, QString devName, QString ssid） -参数：根据网卡类型 参数1 0:lan 1:wlan 参数2：网卡名称 参数3：uuid/ssid -返回值：无 -功能：激活一个网络连接 + activateConnect（int type, QString devName, QString ssid） + 参数：根据网卡类型 参数1 0:lan 1:wlan 参数2：网卡名称 参数3：uuid/ssid + 返回值：无 + 功能：激活一个网络连接 -deActivateConnect(int type, QString devName, QString ssid) -参数：根据网卡类型 参数1 0:lan 1:wlan 参数2：网卡名称 参数3：uuid/ssid -返回值：无 -功能：断开一个网络连接 + deActivateConnect(int type, QString devName, QString ssid) + 参数：根据网卡类型 参数1 0:lan 1:wlan 参数2：网卡名称 参数3：uuid/ssid + 返回值：无 + 功能：断开一个网络连接 -getDeviceListAndEnabled(int devType) -参数：int devType 0:lan 1:wlan -返回值：QMap -键：设备名称 -值：bool 开启（true）关闭 （false） -功能：获取设备列表和启用/禁用状态 + getDeviceListAndEnabled(int devType) + 参数：int devType 0:lan 1:wlan + 返回值：QMap + 键：设备名称 + 值：bool 开启（true）关闭 （false） + 功能：获取设备列表和启用/禁用状态 -getWirelessDeviceCap -返回值：QMap -键：设备名称 -值：int 0：不支持热点 3：支持2.4GHz 7：支持5GHz&&2.4Ghz -功能：获取无线设备能力(2.4G/5G) + getWirelessDeviceCap + 返回值：QMap + 键：设备名称 + 值：int 0：不支持热点 3：支持2.4GHz 7：支持5GHz&&2.4Ghz + 功能：获取无线设备能力(2.4G/5G) -showPropertyWidget(QString devName, QString ssid) -参数：QString devName 设备名称 QString ssid 根据网卡类型 有线为uuid/无线为ssid -返回值：无 -功能：唤起对应网络连接的属性页，可以对基础信息的显示或修改 + showPropertyWidget(QString devName, QString ssid) + 参数：QString devName 设备名称 QString ssid 根据网卡类型 有线为uuid/无线为ssid + 返回值：无 + 功能：唤起对应网络连接的属性页，可以对基础信息的显示或修改 -showCreateWiredConnectWidget(QString devName) -参数：QString devName 有线网卡名称 -返回值：无 -功能：唤起新建有线连接界面 + showCreateWiredConnectWidget(QString devName) + 参数：QString devName 有线网卡名称 + 返回值：无 + 功能：唤起新建有线连接界面 -activeWirelessAp(const QString apName, - const QString apPassword, -const QString band, -const QString apDevice) -参数：QString apName 热点名称 - QString apPassword 热点密码 - QString band 频带 - QString apDevice -返回值：无 -功能：开启移动热点 + activeWirelessAp(const QString apName, + const QString apPassword, + const QString band, + const QString apDevice) + 参数：QString apName 热点名称 + QString apPassword 热点密码 + QString band 频带 + QString apDevice + 返回值：无 + 功能：开启移动热点 -deactiveWirelessAp(const QString apName, const QString uuid) -参数：QStringList（名称/密码/设备名称/状态/UUID/频带） -返回值：无 -功能： 断开移动热点 + deactiveWirelessAp(const QString apName, const QString uuid) + 参数：QStringList（名称/密码/设备名称/状态/UUID/频带） + 返回值：无 + 功能： 断开移动热点 -getStoredApInfo -参数：QStringList（名称/密码/设备名称/状态/UUID/频带） -返回值：无 -功能：获取已保存的移动热点信息 + getStoredApInfo + 参数：QStringList（名称/密码/设备名称/状态/UUID/频带） + 返回值：无 + 功能：获取已保存的移动热点信息 -getApInfoBySsid(QString devName, QString ssid) -参数：QString devName 设备名称 QString ssid -返回值：无 -功能： 通过名称获取已保存的移动热点信息 + getApInfoBySsid(QString devName, QString ssid) + 参数：QString devName 设备名称 QString ssid + 返回值：无 + 功能：通过名称获取已保存的移动热点信息 -reScan() -参数：无 -返回值：无 -功能： 申请重新进行无线扫描 + reScan() + 参数：无 + 返回值：无 + 功能：申请重新进行无线扫描 -keyRingInit() -参数：QString apName 热点名称 QString uuid -返回值：无 -功能： 断开移动热点 + keyRingInit() + 参数：QString apName 热点名称 QString uuid + 返回值：无 + 功能：断开移动热点 -keyRingClear() -参数：无 -返回值：无 -功能： 断开移动热点 + keyRingClear() + 参数：无 + 返回值：无 + 功能： 断开移动热点 -##原理与主要使用的技术 -kylin-nm主要与NetworkManager进行交互，通过对应的dbus信号驱动UI界面的更新。并通过提供的dbus方法来进行网络相关功能的调用。 +###原理与主要使用的技术 + kylin-nm主要与NetworkManager进行交互，通过对应的dbus信号驱动UI界面的更新。并通过提供的dbus方法来进行网络相关功能的调用。 -麒麟网络工具按照功能划分成两层：UI层和逻辑层。UI层实现网络资源的显示，以及用户的交互，逻辑层通过NetworkManager提供的Dbus接口，完成网络资源的管理及其配置。 -##配置文件 -kylin-nm的配置文件保存在如下路径： -~/.config/ukui/kylin-nm.conf 有线无线开关状态 设备状态 -org.ukui.kylin-nm.switch 对应的gsetting值 （有线无线开关状态） -##编译 -cd kylin-nm -mkdir build -cd build -qmake .. -make -sudo make install  -##运行命令 -./kylin-nm -##调试 -kylin-nm目前并采用ukui-log4qt模块的日志功能。日志默认保存在~/.log/kylin-nm.log中 + 麒麟网络工具按照功能划分成两层：UI层和逻辑层。UI层实现网络资源的显示，以及用户的交互，逻辑层通过NetworkManager提供的Dbus接口，完成网络资源的管理及其配置。 +###配置文件 + kylin-nm的配置文件保存在如下路径： + ~/.config/ukui/kylin-nm.conf 有线无线开关状态 设备状态 + org.ukui.kylin-nm.switch 对应的gsetting值 （有线无线开关状态） +###编译 + cd kylin-nm + mkdir build + cd build + qmake .. + make + sudo make install  +###运行命令 + ./kylin-nm +###调试 + kylin-nm目前并采用ukui-log4qt模块的日志功能。日志默认保存在~/.log/kylin-nm.log中 From 7e18c194d364f2f82ad5c72091d0ab9681fda661 Mon Sep 17 00:00:00 2001 From: jzxc95 <907297917@qq.com> Date: Fri, 1 Apr 2022 10:30:59 +0800 Subject: [PATCH 4/4] update --- README.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index e2c4faff..9b77fa00 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ -##kylin-nm介绍 -###简介 +## kylin-nm介绍 +### 简介 麒麟网络工具（kylin-network-manager，简称kylin-nm）是操作系统的网络前端，其主要功能有： 1、托盘栏图标及右键菜单 查看当前网络状态 @@ -30,20 +30,20 @@ 深色与浅色窗口样式切换 调节网络工具窗口透明度 普通窗口与具有毛玻璃效果的窗口的切换 -###运行 +### 运行 麒麟网络工具的进程为kylin-nm，默认开机自启，依赖NetworkManger -###命令行和dbus接口 +### 命令行和dbus接口 kylin-nm进程的命令行如下： Usage: kylin-nm -####dbus接口： +#### dbus接口： DBUS类型：SESSION BUS DBUS名称：com.kylin.network OBJECT路径：/ 接口名称：com.kylin.network -####dbus方法 +#### dbus方法 getWirelessList 参数：无 返回值：QMap> @@ -148,24 +148,24 @@ 功能： 断开移动热点 -###原理与主要使用的技术 +### 原理与主要使用的技术 kylin-nm主要与NetworkManager进行交互，通过对应的dbus信号驱动UI界面的更新。并通过提供的dbus方法来进行网络相关功能的调用。 麒麟网络工具按照功能划分成两层：UI层和逻辑层。UI层实现网络资源的显示，以及用户的交互，逻辑层通过NetworkManager提供的Dbus接口，完成网络资源的管理及其配置。 -###配置文件 +### 配置文件 kylin-nm的配置文件保存在如下路径： ~/.config/ukui/kylin-nm.conf 有线无线开关状态 设备状态 org.ukui.kylin-nm.switch 对应的gsetting值 （有线无线开关状态） -###编译 +### 编译 cd kylin-nm mkdir build cd build qmake .. make sudo make install  -###运行命令 +### 运行命令 ./kylin-nm -###调试 +### 调试 kylin-nm目前并采用ukui-log4qt模块的日志功能。日志默认保存在~/.log/kylin-nm.log中