Delta Block 函数参数与访问器/修改器函数

转换函数由 PrgT_Preference_Transform_Function 定义。

系统提供了多个访问器和修改器函数。两个修改器 prg_preference_transform_destination_value_set() 和 prg_preference_transform_destination_value_set() 可用于为转换后的偏好设置指定新的标签和新的值。

注意,该接口的调用方应使用 prg_* 系列内存分配函数,为传递给修改器的任何数据分配内存。此外,调用方应放弃对所分配数据的所有权,即这些数据应由迁移框架销毁。

注意,如果 delta block 未指定 source version 字段,则 prg_preference_transform_source_version_get() 函数返回正在迁移的偏好设置文件的版本,而 prg_preference_transform_destination_version_get() 函数返回当前安装的版本号。

以下是偏好设置迁移函数:

访问器

  • prg_preference_transform_tag_get() – 返回偏好设置的标签(tag),即在 .pref 文件的 Delta block 中给出的偏好设置底层名称。
  • prg_preference_transform_source_version_get() – 返回该偏好设置所来源的源偏好设置文件的版本。
  • prg_preference_transform_destination_version_get() – 返回该偏好设置迁移到的目标版本。
  • prg_preference_transform_arguments_get() – 以字符串列表形式返回在 Delta block 中作为转换一部分指定的参数。
  • prg_preference_transform_source_value_get() – 以字符串列表形式返回该偏好设置在源偏好设置文件中的值。如果该偏好设置是标量,则返回只含一个元素的列表。

修改器

  • prg_preference_transform_destination_tag_set() – 为偏好设置设置新的标签。该新标签将用于在新的偏好设置文件中写出该偏好设置。如果不设置,则使用原来的标签。
  • prg_preference_transform_destination_value_set() – 为偏好设置设置新的值。该新值将用于在新的偏好设置文件中写出该偏好设置。
  • prg_preference_transform_error_message_set() – 如果自定义转换函数返回失败,则设置一条描述失败原因的消息。该消息将显示在“Preferences Migration”日志中该偏好设置的旁边。