Qt軟件開發-QSettings管理用戶環境變量(修改、輸出)

1. 前言

在軟件開發中可能有需求修改用戶環境變量，添加新的值進行。比如：添加某些可執行文件、某些動態庫的路徑到系統環境PATH中，能夠讓可執行文件運行過程中可以找到對應的dll。

在Qt里可以使用QSettings來實現，QSettings類提供一個獨立于平臺的應用程序設置，Qt已經封裝好，修改、讀取用戶的環境變量不需要管理員權限，并且修改也是直接針對系統的環境配置進行修改，并非當前進程有效（所以修改要謹慎操作）。

2. QSettings

QSettings可以修改注冊表，支持存儲自定義數據格式，通?？梢员４鎽贸绦蛟O置，保存和恢復應用程序設置。

QSettings的詳細功能在Qt幫助頁面有詳細的介紹，當前這里只是列出QSettings修改用戶環境變量的一個使用案例，其他功能不做詳細介紹。

下面是來至Qt幫助頁面的介紹:

QSettings類提供持久的獨立于平臺的應用程序設置。
 用戶通常期望應用程序在會話中記住其設置(窗口大小和位置、選項等)。這些信息通常存儲在Windows上的系統注冊表中，以及macOS和iOS上的屬性列表文件中。在Unix系統上，在沒有標準的情況下，許多應用程序(包括KDE應用程序)使用INI文本文件。
 QSettings是圍繞這些技術的抽象，使能夠以可移植的方式保存和恢復應用程序設置。它還支持自定義存儲格式。
 QSettings的API基于QVariant，允許以最小的工作量保存大多數基于值的類型，如QString、QRect和QImage。
 如果只需要一個基于非持久內存的結構，請考慮使用QMap< QString，QVariant >。
 基本用法
 創建QSettings對象時，必須傳遞公司或組織的名稱以及應用程序的名稱。例如，如果的產品名為Star Runner，而的公司名為MySoft，則可以按照如下方式構造QSettings對象：
 Q設置("MySoft"、"Star Runner")；
 QSettings對象可以在堆棧上或堆上創建(即使用new)。構造和銷毀QSettings對象非?？?。
 如果在應用程序中使用來自多個位置的QSettings，則可能需要使用QCoreApplication:：setOrganizationName()和qCoreApp:：setApplicationName()指定組織名稱和應用程序名稱，然后使用默認的QSetting構造函數：
 QCoreApplication：：setOrganizationName("MySoft")；
 QCoreApplication:：setOrganizationDomain("mysoft.com")；
 QCoreApplication：：setApplicationName("明星跑步者")；
 ...
 Q設置設置；
 (這里，我們還指定了組織的Internet域。當設置Internet域時，它將在macOS和iOS上使用，而不是組織名稱，因為macOS和iOS應用程序通常使用Internet域來標識自己。如果未設置域，則從組織名稱派生假域。有關詳細信息，請參閱下面的平臺特定說明。)
 QSettings存儲設置。每個設置由指定設置名稱(鍵)的QString和存儲與鍵關聯的數據的QVariant組成。要編寫設置，請使用setValue()。例如：
 設置setValue("編輯器/包裝邊緣"，68)；
 如果已經存在具有相同鍵的設置，則現有值將被新值覆蓋。為了提高效率，更改可能不會立即保存到永久存儲中。(可以隨時調用sync()來提交更改。)
 可以使用value()返回設置的值：
 int margin = settings.value("editor/wrapMargin").toInt();
 ?
 如果沒有指定名稱的設置，QSettings將返回空QVariant(可以轉換為整數0)?？梢酝ㄟ^向value()傳遞第二個參數來指定另一個默認值：
  int margin = settings.value("editor/wrapMargin", 80).toInt();
 ?
 要測試給定鍵是否存在，請調用contains()。要刪除與鍵關聯的設置，請調用remove()。要獲取所有鍵的列表，請調用allKeys()。要刪除所有鍵，請調用clear()。

3. 實現代碼Demo

#include "widget.h"
 #include "ui_widget.h"
 ?
 Widget::Widget(QWidget *parent)
     : QWidget(parent)
     , ui(new Ui::Widget)
 {
     ui- >setupUi(this);
 ?
     this- >setWindowTitle("用戶環境變量管理");
 }
 ?
 ?
 Widget::~Widget()
 {
     delete ui;
 }
 ?
 ?
 //打印系統環境變量
 void Widget::on_pushButton_print_env_val_clicked()
 {
     QString env_name=ui- >lineEdit_env_path_name- >text();
     if(env_name.isEmpty())return;
 ?
     //參數解釋
     //【1】. "HKEY_CURRENT_USEREnvironment": 用戶環境變量
     //【2】. QSettings::NativeFormat: 使用最適合平臺的存儲格式存儲設置。
     QSettings seting("HKEY_CURRENT_USEREnvironment", QSettings::NativeFormat);
 ?
     //打印用戶環境變量path的值。
     QString text_val = seting.value(env_name).toString();
     ui- >plainTextEdit- >setPlainText(text_val);
 }
 ?
 ?
 //設置環境變量的值
 void Widget::on_pushButton_set_env_val_clicked()
 {
     QString env_name=ui- >lineEdit_set_env_name- >text();
     if(env_name.isEmpty())return;
 ?
     QString env_val=ui- >lineEdit_env_add_val- >text();
     if(env_val.isEmpty())return;
 ?
     //參數解釋
     //【1】. "HKEY_CURRENT_USEREnvironment": 用戶環境變量
     //【2】. QSettings::NativeFormat: 使用最適合平臺的存儲格式存儲設置。
     QSettings seting("HKEY_CURRENT_USEREnvironment", QSettings::NativeFormat);
 ?
     //獲取原環境變量的值
     QString text_val = seting.value(env_name).toString();
 ?
     //遵循windows下環境變量里的路徑
     env_val = env_val.replace("/", "");
 ?
     //windows環境變量;作為間隔
     text_val.append(";");
 ?
     //添加用戶設置的值
     text_val.append(env_val);
 ?
     //添加新的值
     seting.setValue(env_name,text_val);
 ?
     QMessageBox::about(this,"提示",tr("新值設置成功!"));
 }
 ?
 ?
 //清空環境變量
 void Widget::on_pushButton_clean_env_clicked()
 {
     QString env_name=ui- >lineEdit_clean_env_name- >text();
     if(env_name.isEmpty())return;
 ?
     //參數解釋
     //【1】. "HKEY_CURRENT_USEREnvironment": 用戶環境變量
     //【2】. QSettings::NativeFormat: 使用最適合平臺的存儲格式存儲設置。
     QSettings seting("HKEY_CURRENT_USEREnvironment", QSettings::NativeFormat);
     //清空環境變量
     seting.setValue(env_name,"");
 ?
     QMessageBox::about(this,"提示",tr("清空成功!"));
 }

審核編輯：湯梓紅