升级工具库¶
升级工具库 是一个包含辅助函数的库，可简化升级脚本的编写。Odoo 在标准模块的升级脚本中使用该库，它提供了可靠性，并有助于加快升级过程：
辅助函数有助于确保数据库中数据的一致性。
它会处理已更新记录的间接引用。
允许调用函数而无需编写代码，从而节省时间并降低开发风险。
辅助函数让人可以专注于升级中真正重要的部分，而不必考虑细节。
安装¶
在本地克隆 升级工具库仓库，并在启动 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 文件夹。
注解
工具函数中的 cr 参数始终指数据库游标。请传入在 migrate() 中作为参数收到的游标。并非所有函数都需要此参数。