有幾種方式去設(shè)置odoo的開(kāi)發(fā)環(huán)境，我們將逐個(gè)介紹他們。

如果你之前沒(méi)有接觸過(guò)odoo的開(kāi)發(fā)環(huán)境，那么有幾個(gè)必要的概念你是需要了解的。在這一章節(jié)中，我們首先介紹odoo的生態(tài)。然后我們?cè)谶M(jìn)行介紹odoo開(kāi)發(fā)環(huán)境的安裝。

在這一章節(jié)中，我們主要涉及以下內(nèi)容。

• 理解odoo的生態(tài)
• 源碼安裝
• 管理odoo的數(shù)據(jù)庫(kù)
• 存儲(chǔ)實(shí)例配置
• 激活odoo開(kāi)發(fā)環(huán)境
• 更新插件列表

一、理解odoo的生態(tài)

妞妞為開(kāi)發(fā)者提供了開(kāi)箱即用的開(kāi)發(fā)模式。這可以讓開(kāi)發(fā)者很快完成項(xiàng)目建設(shè)。

odoo的版本

妞妞有兩個(gè)版本，第一個(gè)是社區(qū)版，也是開(kāi)源的。第二個(gè)是企業(yè)版。是需要軟件授權(quán)的。企業(yè)班只是在社區(qū)版的基礎(chǔ)上增加了一些新的功能。社區(qū)版基于LGPLv3協(xié)議開(kāi)源，并集成了基礎(chǔ)的ERP應(yīng)用。企業(yè)版是妞妞公司獨(dú)有的協(xié)議。社區(qū)版有更強(qiáng)大的功能。比如全套的記賬，開(kāi)發(fā)，以及網(wǎng)絡(luò)電話(huà)等設(shè)企業(yè)半夜將提供無(wú)限制的bug修復(fù)。下面這張表格說(shuō)明了企業(yè)版于社區(qū)版的關(guān)系。

Git 存儲(chǔ)庫(kù)

妞妞的源碼都是托管在github上。

每年妞妞都會(huì)發(fā)布。一般主要的版本（Long-Term Support LTS）以及一些小版本。小版本主要使用在SaaS服務(wù)上。

Runbot

Runbot是妞妞的自動(dòng)測(cè)試環(huán)境。它可以自動(dòng)拉去github中最新的4次提交，并進(jìn)行構(gòu)建。在這，你可以使用企業(yè)版以及他們的分支。（源碼是看不到的）

每次構(gòu)建有不同的顏色，這代表這測(cè)試用例的情況。綠色代表通過(guò)，紅色代表失敗。你可以查看具體的日志。每次構(gòu)建會(huì)有兩個(gè)數(shù)據(jù)庫(kù)，一個(gè)是安裝了全部模塊的數(shù)據(jù)庫(kù)，一個(gè)是基礎(chǔ)數(shù)據(jù)庫(kù)。每次構(gòu)建都會(huì)安裝一些模擬數(shù)據(jù)。

Note

訪問(wèn)：http://runbot.odoo. com/runbot.

幾個(gè)基本的賬戶(hù)

• admin,admin
• demo,demo
• portal,portal

這是一個(gè)公開(kāi)的測(cè)試環(huán)境，任何人都可以使用。所以說(shuō)在你測(cè)試的時(shí)候也有可能其他人也在測(cè)試相同的分支。

妞妞的app商城

正如其名，商城，大家上去看看就懂了。

妞妞社區(qū)協(xié)會(huì)

**Odoo Community Association (OCA)**非盈利組織，管理者不少好模塊。但是有不少模塊都是老版本的了，跟新的版本不一定兼容。如有需要，需要自己修改。地址如下：https://github.com/OCA

官方的幫助論壇

有問(wèn)題先上論壇，有很多坑其實(shí)大家都在踩。https://help..help..

妞妞的在線學(xué)習(xí)平臺(tái)

官方的視頻教程，訪問(wèn)地址：https://www./slides.

二、源碼安裝

官方推薦ubuntu，這本書(shū)使用的是Ubuntu Server 18.04 LTS版本。

個(gè)人的開(kāi)發(fā)環(huán)境最好跟生產(chǎn)環(huán)境相同，避免不少坑。

準(zhǔn)備

Ubuntu 18.04、管理員賬戶(hù)

一些配置可能需要賬戶(hù)名，可通過(guò)whoami命令獲取用戶(hù)名。

步驟

1. 安裝依賴(lài)

$ sudo apt-get update
$ sudo apt install git python3-pip build-essential wget python3-dev python3-venv python3-wheel libxslt-dev libzip-dev libldap2-dev libsasl2-dev python3-setuptools libpng12-0 libjpeg-dev gdebi -y

2. 下載安裝wkhtmltopdf

$ wget https://github.com/wkhtmltopdf/wkhtmltopdf/ releases/download/0.12.5/wkhtmltox_0.12.5-1.trusty_amd64. deb
$ sudo dpkg -i wkhtmltox_0.12.5-1.trusty_amd64.deb

3. 安裝postgresql數(shù)據(jù)庫(kù)

$ sudo apt install postgresql -y

4. 配置PostgresSQL：

$ sudo -u postgres createuser --superuser $(whoami)

5. 配置git

$ git config --global user.name "Your Name"
$ git config --global user.email youremail@example.com

6. 下載源碼

$ mkdir ~/odoo-dev
$ cd ~/odoo-dev
$ git clone -b 14.0 --single-branch --depth 1 https:// github.com/odoo/odoo.git

7. 安裝odoo14的虛擬環(huán)境并激活(個(gè)人使用的是pipenv)

$ python3 -m venv ~/venv-odoo-14.0
$ source ~/venv-odoo-14.0/bin/activate

8. 安裝依賴(lài)

$ cd ~/odoo-dev/odoo/
$ pip3 install -r requirements.txt

9. 創(chuàng)建odoo實(shí)體

$ createdb odoo-test
$ python3 odoo-bin -d odoo-test –i base --addons- path=addons --db-filter=odoo-test$

10. 登錄系統(tǒng)http://localhost:8069，賬戶(hù)名密碼設(shè)置為admin

工作原理

步驟1，安裝核心依賴(lài)，用于安裝odoo。
步驟2，安裝wkhtmltopdf。

PostgreSQL配置

步驟3，安裝數(shù)據(jù)庫(kù)。

步驟4，創(chuàng)建一個(gè)與當(dāng)前用戶(hù)相同的用戶(hù)。-s 是授予用戶(hù)超級(jí)權(quán)限。odoo通過(guò)psycopg2連接數(shù)據(jù)庫(kù)。為了訪問(wèn)數(shù)據(jù)庫(kù)，odoo使用如下默認(rèn)配置：

• 默認(rèn)psycopg2通過(guò)當(dāng)前系統(tǒng)用戶(hù)相同的用戶(hù)名去連接本地?cái)?shù)據(jù)庫(kù)，支持無(wú)密碼登錄。
• 本地連接使用的是Unix domain sockets。
• 數(shù)據(jù)庫(kù)默認(rèn)使用5432端口。

因?yàn)槲覀兪褂玫氖情_(kāi)發(fā)環(huán)境，因此我們給用戶(hù)授予了超級(jí)權(quán)限。但在生產(chǎn)環(huán)境下，要使用 --createdb命令替換--superuser。我們可以通過(guò)--pwprompt參數(shù)創(chuàng)建密碼。如果用戶(hù)已存在，可重置密碼。

psql -c "alter role $(whoami) with password 'newpassword'"

如果報(bào)錯(cuò)說(shuō)數(shù)據(jù)庫(kù)不存在，是我們?cè)俨襟E4中沒(méi)有創(chuàng)建數(shù)據(jù)庫(kù)引起的。可通過(guò)在步驟4命令的用戶(hù)名后面添加 --dbname db_1。

Git 配置

通過(guò)git，我們可方便的調(diào)整部署的版本。

步驟5，我們創(chuàng)建git用戶(hù)。

步驟6，下載最新的源碼。用到的命令git clone及--depth 1(可下載一層commit)。

虛擬環(huán)境

python虛擬環(huán)境是為了避免環(huán)境污染。

步驟7，我們?cè)趡/venv-odoo-14.0文件夾中創(chuàng)建了python的環(huán)境及安裝所需的包。我們可通過(guò)source ~/venv-odoo-14.0/bin/activate命令激活虛擬環(huán)境。

安裝pyhon包

步驟8，安裝odoo所需的python包。

啟動(dòng)實(shí)體

步驟9，啟動(dòng)實(shí)體

odoo-bin所用到的參數(shù)

• -d 指定數(shù)據(jù)庫(kù)
• --db-filter=database_name$: 僅連接database_name$（正則匹配）的數(shù)據(jù)庫(kù)。一次安裝，可同時(shí)啟動(dòng)多個(gè)實(shí)例（連接不同的數(shù)據(jù)庫(kù)）。這個(gè)參數(shù)可以限制實(shí)體所能使用的數(shù)據(jù)庫(kù)。
• --addons-path=directory1, directory2。這個(gè)參數(shù)是指定實(shí)例所載入的模塊路徑。
• -i base：這是為了安裝base模塊。這是一切的基礎(chǔ)哦。

或使用的數(shù)據(jù)庫(kù)并不是系統(tǒng)登錄賬戶(hù)，可通過(guò)如下參數(shù)進(jìn)行配置。

• --db_host=IP地址：使用TCP連接數(shù)據(jù)庫(kù)服務(wù)器。
• --db_user=database_username：數(shù)據(jù)庫(kù)賬戶(hù)。
• --db_password=database_password：數(shù)據(jù)庫(kù)密碼。

其他的參數(shù)，可通過(guò) odoo-bin --help參數(shù)查看。

當(dāng)odoo啟動(dòng)了一個(gè)空的數(shù)據(jù)庫(kù)，odoo將創(chuàng)建運(yùn)行所需的基礎(chǔ)表結(jié)構(gòu)。同時(shí)將掃描addons-path目錄中可用的模塊，并加載到數(shù)據(jù)庫(kù)中。默認(rèn)的賬戶(hù)密碼是admin。

登錄系統(tǒng)http://localhost:8069/，如下截圖

管理odoo的數(shù)據(jù)庫(kù)

準(zhǔn)備

已經(jīng)在運(yùn)行的odoo實(shí)例

步驟

odoo的數(shù)據(jù)庫(kù)管理工具提供了數(shù)據(jù)庫(kù)的創(chuàng)建、復(fù)制、刪除、備份及恢復(fù)。還可以數(shù)據(jù)庫(kù)管理工具的管理密碼，限制非授權(quán)用戶(hù)對(duì)數(shù)據(jù)庫(kù)的操作。

訪問(wèn)數(shù)據(jù)庫(kù)接口

1. 進(jìn)入登錄頁(yè)面
2. 點(diǎn)擊Manager Database鏈接。將進(jìn)入/web/database/manager頁(yè)面。
   

設(shè)置和修改管理工具密碼

創(chuàng)建新的數(shù)據(jù)庫(kù)

按步驟創(chuàng)建就行，如果點(diǎn)擊Continue之后又進(jìn)入了登錄頁(yè)面?？赡苁莿倓偺顚?xiě)的Database Name不符合之前設(shè)置的--db_filter指定的的數(shù)據(jù)庫(kù)正則。

復(fù)制數(shù)據(jù)庫(kù)

有時(shí)我們需要對(duì)在用的數(shù)據(jù)進(jìn)行測(cè)試，但是又不能操作生產(chǎn)庫(kù)。那么我們可以將數(shù)據(jù)庫(kù)復(fù)制一份，在復(fù)制的數(shù)據(jù)庫(kù)中進(jìn)行操作。

刪除數(shù)據(jù)庫(kù)

慎重操作，需輸入數(shù)據(jù)庫(kù)管理工具的管理密碼。

備份數(shù)據(jù)庫(kù)

同樣需要管理密碼。

恢復(fù)備份的數(shù)據(jù)庫(kù)

按提示操作就行。

原理

管理密碼是存儲(chǔ)在odoo.conf配置文件中的。
odoo使用PostgreSQL的createdb工具創(chuàng)建新的數(shù)據(jù)庫(kù)，并調(diào)用odoo內(nèi)部的函數(shù)初始化數(shù)據(jù)庫(kù)。
如果想復(fù)制數(shù)據(jù)庫(kù)，可通過(guò)createdb --template 數(shù)據(jù)名。通過(guò)這種方式，比通過(guò)頁(yè)面的上的backup、restore要快很多。
備份和恢復(fù)使用的是pg_dump及pg_restore工具。當(dāng)使用zip的格式的數(shù)據(jù)庫(kù)備份時(shí)，備份將包含一些文件的副本（在配置odoo時(shí)用到但并未存儲(chǔ)在數(shù)據(jù)庫(kù)中的文檔）。這些在odoo14中是默認(rèn)選項(xiàng)。這些文件默認(rèn)存儲(chǔ)在~/.local/share/odoo/filestore中。
如果備份太大，可能會(huì)導(dǎo)致下載失敗。odoo無(wú)法在內(nèi)存中處理大文件、http的response設(shè)置的太小等都會(huì)導(dǎo)致這個(gè)問(wèn)題。同樣，restore也一樣。

餐后甜點(diǎn)

直接通過(guò)命令行操作數(shù)據(jù)庫(kù)是非常方便的。
用演示數(shù)據(jù)初始化新的數(shù)據(jù)庫(kù)

$ createdb testdb && odoo-bin -d testdb

我們還可以同時(shí)安裝模塊，-i sale, purchase, stock。
復(fù)制數(shù)據(jù)庫(kù)，停用服務(wù)并啟動(dòng)

$ createdb -T dbname newdbname
$ cd ~/.local/share/Odoo/filestore # adapt if you have changed the data_dir
$ cp -r dbname newdbname
$ cd -

在開(kāi)發(fā)環(huán)境的上下文中，文件存儲(chǔ)經(jīng)常被忽略。

命令行createdb -T操作數(shù)據(jù)庫(kù)需在數(shù)據(jù)庫(kù)沒(méi)有被使用的情況下哦，也就是復(fù)制數(shù)據(jù)庫(kù)需要odoo停用的情況下進(jìn)行。

移除數(shù)據(jù)庫(kù)實(shí)體，可通過(guò)

$ dropdb dbname
$ rm -rf ~/.local/share/Odoo/filestore/dbname

創(chuàng)建備份，假定數(shù)據(jù)庫(kù)在本地

$ pg_dump -Fc -f dbname.dump dbname

$ tar cjf dbname.tgz dbname.dump ~/.local/share/Odoo/filestore/ dbname

恢復(fù)備份，可通過(guò)如下

$ tar xf dbname.tgz
$ pg_restore -C -d dbname dbname.dump

注意!
如果odoo使用不同的用戶(hù)連接數(shù)據(jù)庫(kù)，那么你需要傳參-U username來(lái)為恢復(fù)的數(shù)據(jù)庫(kù)指定擁有者。

存儲(chǔ)實(shí)例的配置

odoo-bin腳本支持幾十個(gè)參數(shù)的配置，我們可通過(guò)配置文件簡(jiǎn)化記憶。默認(rèn)存儲(chǔ)在/etc/odoo/odoo.conf中。

步驟

1. 生成配置文件

$ ./odoo-bin --save --config myodoo.cfg --stop-after-init

2. 我們可以指定參數(shù)，這些參數(shù)的值可以存儲(chǔ)在生成的配置文件中。通過(guò)如下命令獲取參數(shù)可能的值

$ ./odoo-bin --help | less

3. 要從命令行形式轉(zhuǎn)換為配置形式，請(qǐng)使用長(zhǎng)選項(xiàng)名，刪除開(kāi)頭的破折號(hào)，并將中間的破折號(hào)轉(zhuǎn)換為下劃線。--without-demo變成without_demo。這適用于大多數(shù)選項(xiàng)，但也有一些例外情況，將在下面的部分中列出。
4. 通過(guò)配置文件啟動(dòng)實(shí)例

$ ./odoo-bin -c odoo.conf

原理

在實(shí)例啟動(dòng)的時(shí)候，主要經(jīng)歷三個(gè)階段的配置。第一，所有的配置參數(shù)通過(guò)源代碼設(shè)置默認(rèn)值。第二，加載配置文件并覆蓋已有配置。第三，命令行傳參將再次覆蓋已有配置。
大多數(shù)命令行參數(shù)都可按照上面說(shuō)的方式在配置文件中找到。但是如下是不規(guī)則的變化：

下面列出了一些常用的配置：

以下是數(shù)據(jù)庫(kù)相關(guān)的配置

一些配置文件并不會(huì)在配置文件中使用，但在開(kāi)發(fā)模式下廣泛使用。

激活開(kāi)發(fā)者模式

作為odoo的開(kāi)發(fā)者，你需要了解如何激活開(kāi)發(fā)者模式。激活開(kāi)發(fā)者模式之后，可以訪問(wèn)高級(jí)的配置以及相映的字段。這些選項(xiàng)通常是隱藏掉的并且在日常到使用過(guò)程中當(dāng)中并不會(huì)用到。

步驟

1. 用admin賬戶(hù)登陸系統(tǒng)。

2. 進(jìn)入配置。

3. 在最下方可以看到開(kāi)發(fā)者工具。
   

4. 點(diǎn)擊 激活開(kāi)發(fā)者模式。

5. 等待頁(yè)面加載完成。

另外一種激活方式
It is also possible to activate the developer mode by editing the URL. Before the # sign, insert ?debug=1.
For example, if your current URL is http://localhost:8069/ web#menu_id=102&action=94 and you want to enable
developer mode, then you need to change that URL to http:// localhost:8069/web?debug=1#menu_id=102&action=94. Furthermore, if you want debug mode with assets, then change the URL
to http://localhost:8069/web?debug=assets#menu_ id=102&action=94.

退出開(kāi)發(fā)者模式

• 可以直接編輯url，將 ?debug=0。
• 在頁(yè)面上選擇退出激活模式。
• 點(diǎn)擊頁(yè)面上方的bug菜單，點(diǎn)擊離開(kāi)開(kāi)發(fā)者模式。
  還有一種更簡(jiǎn)單的方式是通過(guò)插件
  

小貼士
自odoo13之后，調(diào)試模式有所改變。調(diào)試模式是存儲(chǔ)在sessino中的，即便你移除了url當(dāng)中的?debug，依舊debug模式。

原理

在開(kāi)發(fā)者模式下會(huì)有兩個(gè)改變

• 當(dāng)你把鼠標(biāo)放在form視圖和列表視圖相應(yīng)filed的時(shí)候會(huì)展示這一個(gè)字段的技術(shù)信息。
• 頁(yè)面的上方會(huì)有一個(gè)bug的圖標(biāo)菜單，我們可以訪問(wèn)一些調(diào)試工具。
  還有另外一種開(kāi)發(fā)者模式-。Developer mode(with assets)。這一個(gè)模式下于正常的開(kāi)發(fā)者模式大部分相同，只是多了JavaScript和CSS的相關(guān)內(nèi)容。相應(yīng)的文件不再進(jìn)行壓縮，方便調(diào)試。

注意！
請(qǐng)?jiān)诜情_(kāi)發(fā)者模式下調(diào)試你的應(yīng)用，否則會(huì)可能忽略一些潛在的問(wèn)題。

更新本地模塊列表

當(dāng)你新建了一個(gè)模塊兒的時(shí)候，妞妞其實(shí)是不知道的，所以需要你進(jìn)行手動(dòng)的刷新。

步驟

這里就放兩張圖

原理

當(dāng)我們點(diǎn)擊了更新按鈕的時(shí)候，妞妞會(huì)去讀取add-ons path中配置的路徑中的文件。并查找每一個(gè)__manifest__.py文件，這里包含著模塊的相關(guān)信息。如果在文件當(dāng)中包含installable=False。那么這一個(gè)模塊兒信息將不會(huì)被寫(xiě)入數(shù)據(jù)庫(kù)。如果模塊已經(jīng)存在那么會(huì)更新相關(guān)信息，如果不存在則新建。

小貼士
手動(dòng)更新主要是在完成數(shù)據(jù)庫(kù)初始化之后新增的模塊。

# 數(shù)據(jù)初始化
python3 odoo-bin -d odoo-test -i base --addons-path=addons --db-filter=odoo-test
# 啟動(dòng)
./odoo-bin -c odoo.conf