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

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

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

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

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

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

odoo的版本

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

Git 存儲庫

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

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

Runbot

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

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

Note

訪問：http://runbot.odoo. com/runbot.

幾個基本的賬戶

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

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

妞妞的app商城

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

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

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

官方的幫助論壇

有問題先上論壇，有很多坑其實大家都在踩。https://help..help..

妞妞的在線學習平臺

官方的視頻教程，訪問地址：https://www./slides.

二、源碼安裝

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

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

準備

Ubuntu 18.04、管理員賬戶

一些配置可能需要賬戶名，可通過whoami命令獲取用戶名。

步驟

1. 安裝依賴

$ 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ù)庫

$ 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)境并激活(個人使用的是pipenv)

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

8. 安裝依賴

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

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

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

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

工作原理

步驟1，安裝核心依賴，用于安裝odoo。
步驟2，安裝wkhtmltopdf。

PostgreSQL配置

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

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

• 默認psycopg2通過當前系統(tǒng)用戶相同的用戶名去連接本地數(shù)據(jù)庫，支持無密碼登錄。
• 本地連接使用的是Unix domain sockets。
• 數(shù)據(jù)庫默認使用5432端口。

因為我們使用的是開發(fā)環(huán)境，因此我們給用戶授予了超級權(quán)限。但在生產(chǎn)環(huán)境下，要使用 --createdb命令替換--superuser。我們可以通過--pwprompt參數(shù)創(chuàng)建密碼。如果用戶已存在，可重置密碼。

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

如果報錯說數(shù)據(jù)庫不存在，是我們再步驟4中沒有創(chuàng)建數(shù)據(jù)庫引起的?？赏ㄟ^在步驟4命令的用戶名后面添加 --dbname db_1。

Git 配置

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

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

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

虛擬環(huán)境

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

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

安裝pyhon包

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

啟動實體

步驟9，啟動實體

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

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

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

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

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

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

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

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

準備

已經(jīng)在運行的odoo實例

步驟

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

訪問數(shù)據(jù)庫接口

1. 進入登錄頁面
2. 點擊Manager Database鏈接。將進入/web/database/manager頁面。
   

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

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

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

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

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

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

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

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

同樣需要管理密碼。

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

按提示操作就行。

原理

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

餐后甜點

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

$ createdb testdb && odoo-bin -d testdb

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

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

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

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

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

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

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

$ pg_dump -Fc -f dbname.dump dbname

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

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

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

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

存儲實例的配置

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

步驟

1. 生成配置文件

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

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

$ ./odoo-bin --help | less

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

$ ./odoo-bin -c odoo.conf

原理

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

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

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

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

激活開發(fā)者模式

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

步驟

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

2. 進入配置。

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

4. 點擊 激活開發(fā)者模式。

5. 等待頁面加載完成。

另外一種激活方式
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.

退出開發(fā)者模式

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

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

原理

在開發(fā)者模式下會有兩個改變

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

注意！
請在非開發(fā)者模式下調(diào)試你的應(yīng)用，否則會可能忽略一些潛在的問題。

更新本地模塊列表

當你新建了一個模塊兒的時候，妞妞其實是不知道的，所以需要你進行手動的刷新。

步驟

這里就放兩張圖

原理

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

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

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