Source¶
源代码 ‘installation’ 并不是安装 Odoo,而是直接从源代码运行。
对于模块开发人员来说,使用 Odoo 源程序可能更方便,因为它比使用打包安装程序更容易访问。
与打包安装程序设置的服务相比,它使 Odoo 的启动和停止更加灵活和明确。此外,它还允许使用 :ref:` 命令行参数 <reference/cmdline>`覆盖设置,而无需编辑配置文件。
最后,它提供对系统设置的更大控制,并且可以更轻松地同时保留(和运行)多个版本的 Odoo。
获取源¶
获取 Odoo 源代码有两种方式:ZIP 压缩包 或通过**Git**。
存档¶
社区版:
企业版
Git¶
注解
需要安装 Git,建议具备 Git 命令的基本知识才能继续。
要克隆一个 Git 存储库,请选择使用 HTTPS 或 SSH 进行克隆。在大多数情况下,最好的选择是HTTPS。然而,如果要为 Odoo 源代码做贡献或者遵循:doc:入门开发者教程</developer/tutorials/getting_started>
,请选择 SSH。
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone git@github.com:odoo/odoo.git
C:\> git clone git@github.com:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
注解
企业 Git 存储库不包含完整的 Odoo 源代码。它只是额外附加组件的集合。主服务器代码位于社区版中。运行企业版意味着从社区版运行服务器,并将组件路径选项设置为具有企业版的文件夹。要进行Odoo 企业版安装,您需要克隆社区版和企业版储存库。
准备¶
Python¶
Odoo requires Python 3.7 or later to run.
使用软件包管理器下载并安装Python 3(如需要)。
下载最新版本 Python 3 <https://www.python.org/downloads/windows/>
并安装。
在安装过程中,选中“ ** Python 3 添加到 PATH**”,然后单击“ 定义安 ”并确保选中“pip”。
注解
如果已经安装了Python 3,请确保版本为3.7或更高版本,因为以前的版本与Odoo不兼容。
$ python3 --version
C:\> python --version
$ python3 --version
确保此版本还安装了 pip。
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo 使用 PostgreSQL 作为其数据库管理系统。
通过使用软件包管理器下载和安装 PostgreSQL(支持版本为 12.0 或更高)。可以通过执行以下命令来实现:
$ sudo apt install postgresql postgresql-client
`下载 PostgreSQL <https://www.postgresql.org/download/windows>`_(支持版本:12.0或更高版本)并安装。</text_to_translate>
使用 `Postgres.app <https://postgresapp.com>`_下载并安装 PostgreSQL(支持版本:12.0或更高版本)。
小技巧
请按照`Postgres.app CLI工具说明<https://postgresapp.com/documentation/cli-tools.html>`_设置`$PATH`变量,以确保与 Postgres.app 捆绑的命令行工具可用。
默认情况下,唯一的用户是 postgres
。由于Odoo禁止以 postgres
的身份连接,因此需要创建一个新的PostgreSQL用户。
$ sudo -u postgres createuser -s $USER
$ createdb $USER
注解
由于 PostgreSQL 用户与 Unix 登录名相同,所以可以在没有密码的情况下连接到数据库。
将 PostgreSQL 的`bin`目录(默认情况下为:
C:\Program Files\PostgreSQL\<version>\bin
)添加到`PATH`中。使用 pg admin gui 创建一个具有密码的 postgres 用户:
打开 pgAdmin。
双击服务器以创建连接。
选择:menuselection:
对象 --> 创建 --> 登录名/组角色
。在**角色名称**字段中输入用户名(例如,
odoo
)。打开**定义**选项卡,输入密码(例如,
odoo
),然后点击**保存**。打开“权限”选项卡,将“可以登录?”切换为“是”,将“创建数据库?”切换为“是”。
$ sudo -u postgres createuser -s $USER
$ createdb $USER
注解
由于 PostgreSQL 用户与 Unix 登录名相同,所以可以在没有密码的情况下连接到数据库。
相关性¶
使用 发行版软件包 是安装依赖包的首选方式。或者,使用 pip 安装 Python 依赖项。
For Debian-based systems, the packages are listed in the debian/control file of the Odoo sources.
在 Debian/Ubuntu 上,使用以下命令即可安装所需的软件包:
$ cd /CommunityPath
$ sed -n -e '/^Depends:/,/^Pre/ s/ python3-\(.*\),/python3-\1/p' debian/control | sudo xargs apt-get install -y
由于某些 Python 软件包需要编译步骤,因此需要安装系统库。
在 Debian/Ubuntu 上,使用以下命令即可安装这些所需的库:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Odoo 依赖项列在位于 Odoo 社区版目录根目录下的 requirements.txt
文件中。
注解
文件:requirements.txt`中的 Python 软件包基于 Odoo 发布时的稳定/LTS Debian/Ubuntu 对应版本。例如,对于 Odoo 15.0,`python3-babel
软件包版本在 Debian Bullseye 中为 2.8.0,在 Ubuntu Focal 中为 2.6.0。然后在 requirements.txt
中选择最低版本。
小技巧
最好不要在 Odoo 的不同实例之间或与系统混合使用 Python 模块包。不过,可以使用 virtualenv 来创建隔离的 Python 环境。
导航至 Odoo 社区版安装路径(CommunityPath
),并在需求文件上运行 pip 为当前用户安装需求。
$ cd /CommunityPath
$ pip install -r requirements.txt
在安装依赖项之前,请下载并安装 “Build Tools for Visual Studio <https://visualstudio.microsoft.com/downloads/>`_”。在 Workloads 选项卡中选择 C++ 编译工具,并按提示安装。
Odoo 依赖项列在位于 Odoo 社区版目录根目录下的`requirements.txt`文件中。
小技巧
最好不要在 Odoo 的不同实例之间或与系统混合使用 Python 模块包。不过,可以使用 virtualenv 来创建隔离的 Python 环境。
导航至 Odoo 社区版安装路径(”CommunityPath”),并在**具有管理员权限**的终端上对需求文件运行 pip:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Odoo 依赖项列在位于 Odoo 社区版目录根目录下的`requirements.txt`文件中。
小技巧
最好不要在 Odoo 的不同实例之间或与系统混合使用 Python 模块包。不过,可以使用 virtualenv 来创建隔离的 Python 环境。
导航至 Odoo 社区版安装路径(”CommunityPath”),并在需求文件上运行 pip:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
注解
对于使用**从右到左界面**的语言(如阿拉伯语或希伯来语),需要使用 rtlcss
软件包。
警告
wkhtmltopdf
is not installed through pip and must be installed manually in version 0.12.5 for it to support headers and
footers. Check out the wkhtmltopdf wiki for
more details on the various versions.
运行 Odoo¶
一旦设置了所有依赖项,就可以通过运行服务器的命令行界面“odoo-bin”来启动Odoo。它位于Odoo社区目录的根目录。
要配置服务器,可指定 :ref:` 命令行参数 <reference/cmdline/server>` 或 :ref:` 配置文件 <reference/cmdline/config>`。
小技巧
对于企业版,请在 addons-path
参数中添加 enterprise
附加组件的路径。请注意,该路径必须位于 addons-path
中其他路径之前,这样才能正确加载附加组件。
常见的必要配置有:
PostgreSQL 用户和密码。
可以在默认路径之外设置自定义插件路径以加载自定义模块。
运行服务器的典型方法是:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
其中,”CommunityPath “是 Odoo 社区版的安装路径,”mydb “是 PostgreSQL 数据库的名称。
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
其中,”CommunityPath “是 Odoo 社区版的安装路径,”dbuser “是 PostgreSQL 登录名,”dbpassword “是 PostgreSQL 密码,”mydb “是 PostgreSQL 数据库名称。
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
其中,”CommunityPath “是 Odoo 社区版的安装路径,”mydb “是 PostgreSQL 数据库的名称。
服务器启动后(打印 INFO 日志 odoo.modules.loading: Modules loaded.
),在网络浏览器中打开 http://localhost:8069,使用基本管理员账户登录 Odoo 数据库:使用 admin
作为电子邮件,同样使用 admin
作为密码。