GSettings和GSettings-XML的整理记录
Posted flfihpv259
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了GSettings和GSettings-XML的整理记录相关的知识,希望对你有一定的参考价值。
@TOC
概览
- KEY修改:所有经GSettings接口的修改请求都提交给DBus会话服务,DBus会话服务操作后sync到碰盘的数据库文件中。
- KEY检索:on-disk上的dconf database(默认~/.config/dconf/usr)直接以只读的形式映射到当前进程的中,因此读操作的非常快。
- DConf database:由gschemas.compiled文件描述构成的hashTable的二进制的dconf数据库(注:这里也可是其它格式的数据库),用于快速检索操作。
- GSettings:只能修改和检索已有键值key,不能增删。因为数据库的创建是由gschemas.compiled文件形成的。
- dconf工具:可对数据库直接读写的。
- xml:修改过后需要重新编译生成gschemas.compiled才能生效,如果是新增key,可以直接运行看效果,如果是修改默认(缺省)值,因数据库中有值了,需删除数据库文件(eg:~/.config/dconf/usr)才能取到默认(缺省)值。
XML文件说明
<?xml version="1.0" encoding="UTF-8"?>
<schemalist>
<schema path="/io/elementary/switchboard/saved-state/" id="io.elementary.switchboard.saved-state">
<key name="window-maximized" type="b">
<default>false</default>
<summary>Whether the window was maximized on last run</summary>
<description>Whether the window was maximized on last run</description>
</key>
<key name="window-position" type="(ii)">
<default>(-1, -1)</default>
<summary>Window position</summary>
<description>Most recent window position (x, y)</description>
</key>
<key name="window-size" type="(ii)">
<default>(1024, 720)</default>
<summary>Most recent window size</summary>
<description>Most recent window size (width, height)</description>
</key>
</schema>
<schema path="/io/elementary/switchboard/preferences/" id="io.elementary.switchboard.preferences">
<key name="mapping-override" type="as(ss)">
<default></default>
<summary>Override (and extends) the default mapping with plugs</summary>
<description>Contains a dictionary of path and two strings: the plug name and an argument. For example 'wallpaper': ('foo-desktop','wallpaper'), 'display': ('bar-display','')</description>
</key>
</schema>
</schemalist>
-
主要构成元素:
- 一个xml文件可以有多个 每个必须指定path和id, id用作GSettings的参数指向一个schema;
- 每个由一个以上的组成。
- 一个 要指定name和类型。对应子项有缺省值, 摘要,描述
-
注意点:
- id与path同名,只是一个用“. ”,一个用“/”分隔。
- 在用命令时,dconf和dconf-editor都是以path来检索,gsettings以id来检索操作
- path必须以"/"开始和结束, 不能以“/apps/”, “/desktop/” 或 “/system/”开始作为命名起始
- Key名只能取小写字母,数字和"-" , 但不能使用连续的"-"命名
- key的只需填写默认值(缺省值),GSettings从Dconf database里检索到key如果没有值,则使用该值
细则参考gio settings
GSettings
Gio.Settings VS Gtk.Settings
- Gio.Settings /GLib.Settings
The GSettings class provides a convenient API for storing and retrieving application settings.
When creating a GSettings instance, you have to specify a schema that describes the keys in your settings and their types and default values, as well as some other information.
创建时必须指定一个schema ID定位,去gschemas.compiled查找如何没有对应schema则失败。
- Gtk.Settings
GtkSettings provide a mechanism to share global settings between applications.
在X窗口系统中,它由XSettings manager实现,做为窗口环境的一部分,用于用户更改设置。每个screen只有一个Gtk.Settings实例。
本文所说的GSettings是指第一种
数据库文件--dconf database
dconf
- dconf is a simple key/value storage system that is heavily optimised for reading
- All preferences are stored in a single large binary file.
- dconf has a partial client/server architecture. It uses D-Bus. The server is only involved in writes
- Reads are performed by direct access (via mmap) to the on-disk database which is essentially a hashtable 读时直接从映射在内存中的hash表中读值,无需任何系统调用
- /etc/dconf/profile的配置文件中每一行指明了一个dconf database的名字
详情参见man 7 dconf
ann@B460M-d5c6e3b7:~$ cat /etc/dconf/profile/ibus
user-db:user
system-db:ibus
ann@B460M-d5c6e3b7:~$ file /etc/dconf/db/ibus
/etc/dconf/db/ibus: GVariant Database file, version 0
ann@B460M-d5c6e3b7:~$ file ~/.config/dconf/user
/home/ann/.config/dconf/user: GVariant Database file, version 0
存放的缓存位置
见上小节,一般放在/etc/dconf/profile, 用户的数据库位置如下
~/.config/dconf/user
另记下,要是找不到可用此方法gsettings cache文件所在位置的查找方法,lsof
列出某个进程的打开文件。
xml 编译
glib-compile-schemas
将GSettings XML 模式文件编译成二进制格式的文件供GSettings快速检索
ann@B460M-d5c6e3b7:usr$ sudo glib-compile-schemas /usr/share/glib-2.0/schemas/
ann@B460M-d5c6e3b7:usr$ file /usr/share/glib-2.0/schemas/gschemas.compiled
/usr/share/glib-2.0/schemas/gschemas.compiled: GVariant Database file, version 0
将 DIRECTORY 中的所有 GSettings XML schema文件编译成一个名为gschemas.compiled的二进制文件,该文件供GSettings 使用 。XML 架构文件必须具有.gschema.xml的文件扩展名。
在运行时,GSettings 在环境变量XDG_DATA_DIRS 指定的所有目录的子目录 glib-2.0/schemas 中搜索所有schemas。 schemas文件的通常安装位置是 /usr/share/glib-2.0/schemas.
手动修改过的XML文件重新编译后,需删除原数据库才会重新加载默认配置值,新增项直接使用默认值,不用删。
查看和修改工具
- dconf-editor--图形界面,以SCHEMA PATH为查找对象
一个有图形界面的程序,用来编辑其它应用程序调用glib库中的gsettings函数修改或存储在dconf数据库中的设置项
打开后搜索 /io/elementary/switchboard/saved-state/即可
- gsettings --以ID为操作对象
gsettings offers a simple commandline interface to GSettings. It lets you get, set or monitor an individual key for changes.
Note that gsettings needs a D-Bus session bus connection to write changes to the dconf database
- gsettings list-schemas : 列出所有schemas
- gsettings get/set : 获取设置值
- gsettings list-keys : 列出schemas的所有KEY
ann@B460M-d5c6e3b7:icons$ gsettings list-keys io.elementary.switchboard.saved-state
window-size
window-position
window-maximized
ann@B460M-d5c6e3b7:icons$ gsettings get io.elementary.switchboard.saved-state window-size
(1024, 720)
ann@B460M-d5c6e3b7:~$ gsettings list-recursively io.elementary.switchboard.saved-state
io.elementary.switchboard.saved-state window-size (890, 563)
io.elementary.switchboard.saved-state window-position (388, 171)
io.elementary.switchboard.saved-state window-maximized false
- dconf --以PATH为操作对象
Simple tool for manipulating a dconf database, This tool operates on dconf directly
ann@B460M-d5c6e3b7:icons$ dconf list /io/elementary/switchboard/saved-state/
window-maximized
window-position
window-size
ann@B460M-d5c6e3b7:icons$ dconf read /io/elementary/switchboard/saved-state/window-size
(1024, 720)
ann@B460M-d5c6e3b7:~$ dconf watch /io/elementary/switchboard/saved-state/window-size
/io/elementary/switchboard/saved-state/window-size
(905, 620)
/io/elementary/switchboard/saved-state/window-size
(910, 564)
/io/elementary/switchboard/saved-state/window-size
(890, 563)
Meson.build
指定schemas文件的安装目录
schemas_dir = get_option('prefix') / get_option('datadir') / 'glib-2.0' / 'schemas'
settings_schemas = [ 'org.gtk.Test' ]
install_data(settings_schemas, install_dir: schemas_dir)
在当前目录下编译schemas文件,只能临时测试
gnome = import('gnome')
gnome.compile_schemas(depend_files: files(settings_schemas))
如果要在安装过程中时编译schemas文件,需要加入一个post-install 脚本如下:
meson.add_install_script('glib-compile-schemas', schemas_dir)
以上是关于GSettings和GSettings-XML的整理记录的主要内容,如果未能解决你的问题,请参考以下文章
python 转储所有gsettings。它与'gsettings list-recursively'相同