升级实用工具¶
Upgrade utils 是一个程序库，其中包含便于编写升级脚本的辅助函数。该库被 Odoo 用于标准模块的升级脚本，可提供可靠性并有助于加快升级过程：
这些辅助函数有助于确保数据在数据库中保持一致。
它会处理已更新记录的间接引用。
它允许直接调用函数而无需重复编写代码，节省时间并降低开发风险。
借助这些辅助函数，您可以专注于对升级真正重要的内容，而无需操心细节。
安装¶
在本地克隆 Upgrade utils 代码库 ，并在启动 odoo 时将 src 目录添加到 --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：基础 TestCase 类。
要在升级脚本中使用它，只需导入即可：
from odoo.upgrade import util
def migrate(cr, version):
# Rest of the script
现在，即可通过 util 调用辅助函数。
Util 函数¶
Upgrade utils 提供了许多实用函数，用于简化升级过程。这里我们介绍其中最常用的一些。有关辅助函数的完整声明，请参阅 util 文件夹 。
Note
util 函数中的 cr 参数始终指代数据库游标。请传入在 migrate() 中接收到的那个游标。并非所有函数都需要该参数。
