Delta Block 语法

delta block 的语法如下:

  start_pref_delta
      [ source_version  : AA.b ]
      preferences       : tag1 [, tag2…]
      transformation    : module_name, func_name [, arg1 [, arg2]]
                             or  special keyword
  end_pref_delta

注意,方括号([])表示可选字段。

下表列出 delta block 的各字段。

表 15:Delta Block 字段

字段 说明
start_pref_delta 指定 delta block 的开始。
source_version : AA.b 指定迁移所基于的版本。例如:12.0。
如果省略此字段,则无论偏好设置来自哪个偏好设置文件,转换都会始终应用于指定的偏好设置。
preferences : tag1 [, tag2...] 指定一个或多个偏好设置标签(tag)。指定多个偏好设置时,每个偏好设置之间用空格和逗号分隔。
transformation : module_name, func_name [, arg1 [arg2]] or special keyword 指定迁移和转换信息。
- module_name – 指定模块名。
- func_name – 指定该模块中某个函数的名称。
- [, arg1 [,arg2]] – 指定转换函数的参数。转换函数接受一个参数,并返回表示转换状态的返回值。更多信息参见 Delta Block 函数参数与访问器/修改器函数。
- special keyword – 指定常用转换。可以使用以下关键字:

do_not_migrate
指定抑制所列偏好设置的迁移。

release_path_convert
将路径转换为升级后软件的 release 目录。例如,从 12.0 迁移到 12.2 时,包含字符串 “12.0” 的路径值会被替换为 “12.2”。
end_pref_delta 指定 delta block 的结束。