• Guía de configuración rápida:
• El archivo .env
• Preparar entorno de desarrollo
  • Script para preparar entorno de desarrollo automaticamente
  • Forma manual para preparar entorno de desarrollo
    • Instalación de requisitos en maquina local
  • Clonar el repositorios de Odoo
  • Crear un entorno virtual
    • Instalar las dependencias de Odoo
• Extras de Odoo
  • Scaffold
  • Shell
  • Shell para usar IPython como REPL
• Errores comunes
  • OSError: [Errno 24] inotify instance limit reached
• Documentación adicional
• Fuentes
• Contribuciones

Clonar y configurar:

git clone git@github.com:focuzai/odoo_vsc.git
cd odoo_vsc
cp .env.example .env

Las variables de entorno ubicado en .env proporcionan configuraciones dinámicas a Odoo y al proyecto en general.

Archivo de muestra .env

# Odoo
ODOO_TAG=16.0

# Usuario de GitHub y token de acceso para clonar repositorios privados
GITHUB_USER=Hchumpitaz
GITHUB_ACCESS_TOKEN=ghp_token

Ejecutar el script setup_env.sh para preparar el entorno de desarrollo local.

Instalador preparado para Ubuntu 20.04, Ubuntu 22.04 y Ubuntu 24.04.

chmod +x setup_env.sh
./setup_env.sh

Si ha ejecutado el script setup_env.sh ir a Clonar el repositorios de Odoo

Instalación de PostgreSQL

sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install gnupg gnupg2 gnupg1 -y
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
sudo wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo gpg --dearmor -o /usr/share/keyrings/postgresql.gpg
echo "deb [signed-by=/usr/share/keyrings/postgresql.gpg] http://apt.postgresql.org/pub/repos/apt/ $(lsb_release -cs)-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list
sudo apt-get update
sudo apt-get install --no-install-recommends -y postgresql-client

Opcional instalar PostgreSQL completo:

sudo apt-get install postgresql-16 -y

Instalación de dependencias:

Inicia instalando las dependencias de Odoo oficial. Si al instalar las librerias de Odoo ocurre algun problema recien migrar las depedencias de Rafnixg o Yenthe666.

Odoo

sudo apt-get install -y python3 python3-pip -y
sudo apt-get install -y git build-essential libsasl2-dev python3-cffi python3-dev python3-venv python3-wheel libldap2-dev libssl-dev libpq-dev libxml2-dev

Rafnixg

sudo apt install python3-dev python3-pip python3-venv libxml2-dev \
    libxslt1-dev libldap2-dev libsasl2-dev libtiff5-dev \
    libjpeg8-dev libopenjp2-7-dev zlib1g-dev libfreetype6-dev \
    liblcms2-dev libwebp-dev libharfbuzz-dev libfribidi-dev libxcb1-dev libpq-dev libssl-dev

Yenthe666

sudo apt-get install python3 python3-pip -y
sudo apt-get install git python3-cffi build-essential wget python3-dev python3-venv python3-wheel libxslt-dev libzip-dev libldap2-dev libsasl2-dev python3-setuptools node-less libpng-dev libjpeg-dev gdebi -y

Para clonar el repositorio de Odoo Community, Odoo Enterprise y Themes:

chmod +x clone-addons.sh
./clone-addons.sh

Para crear un entorno virtual de Python para Odoo (>= python3.8), ejecute el siguiente comando:

python3 -m venv venv

Este comando creará un entorno virtual para Odoo en la carpeta venv, puede configurar de este modo venv-16, el número 16 hace referencia a la versión de odoo utilizado.

Para instalar las dependencias de python para Odoo, ejecute los siguientes comandos:

Activar entorno virtual venv o el que allá creado, por ejemplo, el mostrado arriba env-16.

source venv/bin/activate

Actualiza las librerias pip, setuptools y wheel:

pip3 install --upgrade pip setuptools wheel --no-cache-dir
pip3 install pydevd-odoo nox

Instalar las librerias de Odoo:

pip3 install -r odoo/requirements.txt --no-cache-dir

Instalas las librerias para la Localización Peruana:

pip3 install -r requirements.txt --no-cache-dir

Si desea desactivar el entorno virtual, ejecuta:

Solo si deseas cambiar de entorno virtual.

deactivate

Ubicarse en la raiz del proyecto y ejecutar:

Para Linux y MAC el comando:

python odoo/odoo-bin scaffold name_module src/addons/

Para Windows el comando:

python.exe odoo/odoo-bin scaffold name_module src/addons/

Para acceder a la shell de Odoo en Linux o Mac:

python odoo/odoo-bin shell -d <nombrebd> -c config/odoo.conf

Si ves “>>>”, entonces ya te encuentras en la línea de comandos de Odoo

Ejemplo de como cambiar la clave del administrador:

>>> self.env[“res.users”].browse(2).password = "admin"
>>> selv.env.cr.commit()

IPython es un shell interactivo de Python que proporciona funciones avanzadas como autocompletado, resaltado de sintaxis, historial de comandos y más. Utilizar IPython como REPL (Read-Eval-Print Loop) en lugar del shell estándar de Python puede mejorar nuestra experiencia de programación en Odoo.

Instala IPython en tu sistema:

pip install ipython

Ahora que IPython está instalado, ejecutar:

odoo/odoo-bin shell -c config/odoo.conf -d <db-name> --xmlrpc-port 8888 --gevent-port 8899 --shell-interface ipython

El parámetro --dev en Odoo se utiliza para habilitar diferentes modos de desarrollo que facilitan la depuración y el desarrollo de módulos. Algunos de los valores comunes que puede tomar son:

• all: Activa todas las opciones de desarrollo.
• assets: Habilita la depuración de archivos estáticos como CSS y JavaScript.
• qweb: Permite la depuración de plantillas QWeb.
• xml: Activa la depuración de vistas XML.
• rpc: Muestra las llamadas RPC (Remote Procedure Call) en la consola.
• pdb: Inicia un depurador interactivo (Python Debugger) en caso de errores.

sudo nano /etc/sysctl.conf
fs.inotify.max_user_instances = 1100000
sudo sysctl -p

Por favor, consulte la sección de documentos.

• Manejo de dependencias con Submódulos
• Git-submodule
• Actualizar los submódulso git de un proyecto
• Atlassian | Submódulos de Git
• Actualización de submódulo en Git
• Creando un entorno de desarrollo para Odoo 14.0 con VSCode en Ubuntu 22.04
• Explorando Odoo a fondo: Cómo trabajar con la shell de la CLI y configurar IPython como REPL
• Archivo de configuración odoo.conf
• How to Install NVM on Ubuntu 22.04

• Harrison Chumpitaz