升级实用程序¶
Upgrade utils 是一个包含辅助函数的库，可方便编写升级脚本。 Odoo 使用该库作为标准模块的升级脚本，提供可靠性并有助于加快升级过程：
辅助函数有助于确保数据库中的数据一致。
它负责更新记录的间接引用。
允许调用函数并避免编写代码，节省时间并降低开发风险。
助手可以让您专注于对升级重要的事情，而不用考虑细节。
安装¶
在本地克隆 Upgrade utils repository 并启动 odoo with the src directory prepended to the --upgrade-path 选项。
$ ./odoo-bin --upgrade-path=/path/to/upgrade-util/src,/path/to/other/upgrade/script/directory [...]
在您自己不管理 Odoo 的平台上，您可以通过 pip 安装此库：
$ python3 -m pip install git+https://github.com/odoo/upgrade-util@master
在 Odoo.sh 上，建议将其添加到自定义存储库的 requirements.txt 中。为此，请在文件中添加以下行：
odoo_upgrade @ git+https://github.com/odoo/upgrade-util@master
使用升级实用程序¶
安装后，以下软件包可用于升级脚本：
odoo.upgrade.util：助手本身。odoo.upgrade.testing：测试用例基类。
要在升级脚本中使用它，只需导入它：
from odoo.upgrade import util
def migrate(cr, version):
# Rest of the script
现在，可以通过“util”调用辅助函数。
实用函数¶
Upgrade utils 提供了许多有用的功能来简化升级过程。在这里，我们描述了一些最有用的。有关辅助函数的完整声明，请参阅 util folder。
注解
util 函数中的 cr 参数始终引用数据库游标。将收到的参数作为参数传递到 migrate() 中。并非所有函数都需要此参数。