有幾種方式去設置odoo的開發環境，我們將逐個介紹他們。
如果你之前沒有接觸過odoo的開發環境，那么有幾個必要的概念你是需要了解的。在這一章節中，我們首先介紹odoo的生態。然后我們在進行介紹odoo開發環境的安裝。
在這一章節中，我們主要涉及以下內容。
- 理解odoo的生態
- 源碼安裝
- 管理odoo的數據庫
- 存儲實例配置
- 激活odoo開發環境
- 更新插件列表
一、理解odoo的生態
妞妞為開發者提供了開箱即用的開發模式。這可以讓開發者很快完成項目建設。
odoo的版本
妞妞有兩個版本，第一個是社區版，也是開源的。第二個是企業版。是需要軟件授權的。企業班只是在社區版的基礎上增加了一些新的功能。社區版基於LGPLv3協議開源，並集成了基礎的ERP應用。企業版是妞妞公司獨有的協議。社區版有更強大的功能。比如全套的記賬，開發，以及網絡電話等設企業半夜將提供無限制的bug修復。下面這張表格說明了企業版於社區版的關系。
Git 存儲庫
妞妞的源碼都是托管在github上。
每年妞妞都會發布。一般主要的版本（Long-Term Support LTS）以及一些小版本。小版本主要使用在SaaS服務上。
Runbot
Runbot是妞妞的自動測試環境。它可以自動拉去github中最新的4次提交，並進行構建。在這，你可以使用企業版以及他們的分支。（源碼是看不到的）
每次構建有不同的顏色，這代表這測試用例的情況。綠色代表通過，紅色代表失敗。你可以查看具體的日志。每次構建會有兩個數據庫，一個是安裝了全部模塊的數據庫，一個是基礎數據庫。每次構建都會安裝一些模擬數據。
Note
訪問：http://runbot.odoo. com/runbot.
幾個基本的賬戶
- admin,admin
- demo,demo
- portal,portal
這是一個公開的測試環境，任何人都可以使用。所以說在你測試的時候也有可能其他人也在測試相同的分支。
妞妞的app商城
正如其名，商城，大家上去看看就懂了。
妞妞社區協會
**Odoo Community Association (OCA)**非盈利組織，管理者不少好模塊。但是有不少模塊都是老版本的了，跟新的版本不一定兼容。如有需要，需要自己修改。地址如下：https://github.com/OCA
官方的幫助論壇
有問題先上論壇，有很多坑其實大家都在踩。https://help.odoo.com.help.odoo.com.
妞妞的在線學習平台
官方的視頻教程，訪問地址：https://www.odoo.com/slides.
二、源碼安裝
官方推薦ubuntu，這本書使用的是Ubuntu Server 18.04 LTS版本。
個人的開發環境最好跟生產環境相同，避免不少坑。
准備
Ubuntu 18.04、管理員賬戶
一些配置可能需要賬戶名，可通過whoami命令獲取用戶名。
步驟
- 安裝依賴
$ 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
- 下載安裝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
- 安裝postgresql數據庫
$ sudo apt install postgresql -y
- 配置PostgresSQL：
$ sudo -u postgres createuser --superuser $(whoami)
- 配置git
$ git config --global user.name "Your Name"
$ git config --global user.email youremail@example.com
- 下載源碼
$ mkdir ~/odoo-dev
$ cd ~/odoo-dev
$ git clone -b 14.0 --single-branch --depth 1 https:// github.com/odoo/odoo.git
- 安裝odoo14的虛擬環境並激活(個人使用的是pipenv)
$ python3 -m venv ~/venv-odoo-14.0
$ source ~/venv-odoo-14.0/bin/activate
- 安裝依賴
$ cd ~/odoo-dev/odoo/
$ pip3 install -r requirements.txt
- 創建odoo實體
$ createdb odoo-test
$ python3 odoo-bin -d odoo-test –i base --addons- path=addons --db-filter=odoo-test$
- 登錄系統http://localhost:8069，賬戶名密碼設置為admin
工作原理
步驟1，安裝核心依賴，用於安裝odoo。
步驟2，安裝wkhtmltopdf。
PostgreSQL配置
步驟3，安裝數據庫。
步驟4，創建一個與當前用戶相同的用戶。-s 是授予用戶超級權限。odoo通過psycopg2連接數據庫。為了訪問數據庫，odoo使用如下默認配置：
- 默認psycopg2通過當前系統用戶相同的用戶名去連接本地數據庫，支持無密碼登錄。
- 本地連接使用的是Unix domain sockets。
- 數據庫默認使用5432端口。
因為我們使用的是開發環境，因此我們給用戶授予了超級權限。但在生產環境下，要使用 --createdb命令替換--superuser。我們可以通過--pwprompt參數創建密碼。如果用戶已存在，可重置密碼。
psql -c "alter role $(whoami) with password 'newpassword'"
如果報錯說數據庫不存在，是我們再步驟4中沒有創建數據庫引起的。可通過在步驟4命令的用戶名后面添加 --dbname db_1。
Git 配置
通過git，我們可方便的調整部署的版本。
步驟5，我們創建git用戶。
步驟6，下載最新的源碼。用到的命令git clone及--depth 1(可下載一層commit)。
虛擬環境
python虛擬環境是為了避免環境污染。
步驟7，我們在~/venv-odoo-14.0文件夾中創建了python的環境及安裝所需的包。我們可通過source ~/venv-odoo-14.0/bin/activate命令激活虛擬環境。
安裝pyhon包
步驟8，安裝odoo所需的python包。
啟動實體
步驟9，啟動實體
odoo-bin所用到的參數
- -d 指定數據庫
- --db-filter=database_name$: 僅連接database_name$（正則匹配）的數據庫。一次安裝，可同時啟動多個實例（連接不同的數據庫）。這個參數可以限制實體所能使用的數據庫。
- --addons-path=directory1, directory2。這個參數是指定實例所載入的模塊路徑。
- -i base：這是為了安裝base模塊。這是一切的基礎哦。
或使用的數據庫並不是系統登錄賬戶，可通過如下參數進行配置。
- --db_host=IP地址：使用TCP連接數據庫服務器。
- --db_user=database_username：數據庫賬戶。
- --db_password=database_password：數據庫密碼。
其他的參數，可通過 odoo-bin --help參數查看。
當odoo啟動了一個空的數據庫，odoo將創建運行所需的基礎表結構。同時將掃描addons-path目錄中可用的模塊，並加載到數據庫中。默認的賬戶密碼是admin。
登錄系統http://localhost:8069/，如下截圖
管理odoo的數據庫
准備
已經在運行的odoo實例
步驟
odoo的數據庫管理工具提供了數據庫的創建、復制、刪除、備份及恢復。還可以數據庫管理工具的管理密碼，限制非授權用戶對數據庫的操作。
訪問數據庫接口
- 進入登錄頁面
- 點擊Manager Database鏈接。將進入/web/database/manager頁面。
設置和修改管理工具密碼
創建新的數據庫
按步驟創建就行，如果點擊Continue之后又進入了登錄頁面。可能是剛剛填寫的Database Name不符合之前設置的--db_filter指定的的數據庫正則。
復制數據庫
有時我們需要對在用的數據進行測試，但是又不能操作生產庫。那么我們可以將數據庫復制一份，在復制的數據庫中進行操作。
刪除數據庫
慎重操作，需輸入數據庫管理工具的管理密碼。
備份數據庫
同樣需要管理密碼。
恢復備份的數據庫
按提示操作就行。
原理
管理密碼是存儲在odoo.conf配置文件中的。
odoo使用PostgreSQL的createdb工具創建新的數據庫，並調用odoo內部的函數初始化數據庫。
如果想復制數據庫，可通過createdb --template 數據名。通過這種方式，比通過頁面的上的backup、restore要快很多。
備份和恢復使用的是pg_dump及pg_restore工具。當使用zip的格式的數據庫備份時，備份將包含一些文件的副本（在配置odoo時用到但並未存儲在數據庫中的文檔）。這些在odoo14中是默認選項。這些文件默認存儲在~/.local/share/odoo/filestore中。
如果備份太大，可能會導致下載失敗。odoo無法在內存中處理大文件、http的response設置的太小等都會導致這個問題。同樣，restore也一樣。
餐后甜點
直接通過命令行操作數據庫是非常方便的。
用演示數據初始化新的數據庫
$ createdb testdb && odoo-bin -d testdb
我們還可以同時安裝模塊，-i sale, purchase, stock。
復制數據庫，停用服務並啟動
$ createdb -T dbname newdbname
$ cd ~/.local/share/Odoo/filestore # adapt if you have changed the data_dir
$ cp -r dbname newdbname
$ cd -
在開發環境的上下文中，文件存儲經常被忽略。
命令行createdb -T操作數據庫需在數據庫沒有被使用的情況下哦，也就是復制數據庫需要odoo停用的情況下進行。
移除數據庫實體，可通過
$ dropdb dbname
$ rm -rf ~/.local/share/Odoo/filestore/dbname
創建備份，假定數據庫在本地
$ pg_dump -Fc -f dbname.dump dbname
$ tar cjf dbname.tgz dbname.dump ~/.local/share/Odoo/filestore/ dbname
恢復備份，可通過如下
$ tar xf dbname.tgz
$ pg_restore -C -d dbname dbname.dump
注意!
如果odoo使用不同的用戶連接數據庫，那么你需要傳參-U username來為恢復的數據庫指定擁有者。
存儲實例的配置
odoo-bin腳本支持幾十個參數的配置，我們可通過配置文件簡化記憶。默認存儲在/etc/odoo/odoo.conf中。
步驟
- 生成配置文件
$ ./odoo-bin --save --config myodoo.cfg --stop-after-init
- 我們可以指定參數，這些參數的值可以存儲在生成的配置文件中。通過如下命令獲取參數可能的值
$ ./odoo-bin --help | less
- 要從命令行形式轉換為配置形式，請使用長選項名，刪除開頭的破折號，並將中間的破折號轉換為下划線。--without-demo變成without_demo。這適用於大多數選項，但也有一些例外情況，將在下面的部分中列出。
- 通過配置文件啟動實例
$ ./odoo-bin -c odoo.conf
原理
在實例啟動的時候，主要經歷三個階段的配置。第一，所有的配置參數通過源代碼設置默認值。第二，加載配置文件並覆蓋已有配置。第三，命令行傳參將再次覆蓋已有配置。
大多數命令行參數都可按照上面說的方式在配置文件中找到。但是如下是不規則的變化：
| 命令行 | 配置文件 |
| --db-filter | dbfilter |
| --no-http | http_enable = True/False |
| --database | db_name |
| --dev | dev_mode |
| --il8n-import/--il8n-export | Unavailabe |
下面列出了一些常用的配置：
| 配置 | 格式 | 說明 |
| without_demo | 模塊名s | 阻止模塊安裝延時數據。 all：全部禁用 False：全部開啟 列表：sale,purchase |
| addons_path | 模塊所在的目錄 | 多個路徑，“,”隔開 |
| admin_passwd | 文本 | 主密碼 |
| data_dir | 數據文件路徑 | 存儲session、網上下載的add-ons以及文檔 |
| http_port longpolling_port |
數字 | 在運行多個odoo服務的使用需要指定兩個port。 longpolling_port是在workers為非0 的指定。 http_port默認8069，longpolling_port為8072. |
| logfile | 文件路徑 | odoo的log文件 |
| log_level | 日志級別 | critical,error,warn,info,debug,debug_rpc, debug_rpc_answer,debug_sql |
| workers | 整數 | worker的進程數量。詳見第三章服務開發 |
| proxy_mode | True/False | 激活反向代理WSGI包裝器。 僅當運行在可信的web代理后時才啟用此功能! |
以下是數據庫相關的配置
| 配置 | 格式 | 說明 |
| db_host | hostname | 數據庫主機ip |
| db_user | 數據庫用戶名 | 若db_host為False，則該項為空。這將使用當前用戶連接數據庫 |
| db_password | 數據庫密碼 | |
| db_name | 數據庫名 | This is used to set the database name on which some commands operate by default. This does not limit the databases on which the server will act. Refer to the following dbfilter option for this. |
| db_sslmode | 數據庫的ssl模式 | 指定數據庫的ssl連接模式 |
| dbfilter | 正則 | 匹配odoo實例可訪問的數據庫，若是運行網站，需精確匹配到一個數據庫如^databasename$ |
| list_db | True/False | 顯示或隱藏數據庫管理頁面。 |
一些配置文件並不會在配置文件中使用，但在開發模式下廣泛使用。
| 配置 | 格式 | 說明 |
| -i or --init | 模塊名s | 使用“模塊”初始化數據庫 |
| -u or --update | 模塊名s | 更新模塊 |
| --dev | all,reload,qweb, werkzeug,xml |
激活開發者模式
作為odoo的開發者，你需要了解如何激活開發者模式。激活開發者模式之后，可以訪問高級的配置以及相映的字段。這些選項通常是隱藏掉的並且在日常到使用過程中當中並不會用到。
步驟
-
用admin賬戶登陸系統。
-
進入配置。
-
在最下方可以看到開發者工具。
-
點擊 激活開發者模式。
-
等待頁面加載完成。
另外一種激活方式
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.
退出開發者模式
- 可以直接編輯url，將 ?debug=0。
- 在頁面上選擇退出激活模式。
- 點擊頁面上方的bug菜單，點擊離開開發者模式。
還有一種更簡單的方式是通過插件
小貼士
自odoo13之后，調試模式有所改變。調試模式是存儲在sessino中的，即便你移除了url當中的?debug，依舊debug模式。
原理
在開發者模式下會有兩個改變
- 當你把鼠標放在form視圖和列表視圖相應filed的時候會展示這一個字段的技術信息。
- 頁面的上方會有一個bug的圖標菜單，我們可以訪問一些調試工具。
還有另外一種開發者模式-。Developer mode(with assets)。這一個模式下於正常的開發者模式大部分相同，只是多了JavaScript和CSS的相關內容。相應的文件不再進行壓縮，方便調試。
注意！
請在非開發者模式下調試你的應用，否則會可能忽略一些潛在的問題。
更新本地模塊列表
當你新建了一個模塊兒的時候，妞妞其實是不知道的，所以需要你進行手動的刷新。
步驟
這里就放兩張圖
原理
當我們點擊了更新按鈕的時候，妞妞會去讀取add-ons path中配置的路徑中的文件。並查找每一個__manifest__.py文件，這里包含着模塊的相關信息。如果在文件當中包含installable=False。那么這一個模塊兒信息將不會被寫入數據庫。如果模塊已經存在那么會更新相關信息，如果不存在則新建。
小貼士
手動更新主要是在完成數據庫初始化之后新增的模塊。
# 數據初始化
python3 odoo-bin -d odoo-test -i base --addons-path=addons --db-filter=odoo-test
# 啟動
./odoo-bin -c odoo.conf