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”日志中该偏好设置的旁边。