This is the documentation for older versions of Odoo (formerly OpenERP).

See the new Odoo user documentation.

See the new Odoo technical documentation.

Working with Launchpad

Registration and Configuration

Прежде чем вы сможете работать с launchpad, вам нужно создать учётную запись.

Перейдите на: https://launchpad.net --> "log in / register" вверху справа.

Введите ваш адрес электронной почты и ожидайте письма, в котором будут пошаговые инструкции по созданию учётной записи.

Учётная запись нужна только если вы собираетесь использовать bazaar в команде коммитеров или создать собственную ветвь.

You can refer to this link : https://help.launchpad.net/YourAccount/NewAccount

Каждый волонтёр, заинтересованнный в том, чтобы стать коммиттером, должен проявить свой интерес в работе над проектом OpenERP, и проявить способности делать это правильно, так как отбор в эту группу производиться по уровню навыков. Это может быть предложение исправления ошибки, функционал, запрошенный через нашу систему отслеживания ошибок. Вы можете даже предложить дополнительные модули или функционал, пользуясь системой отслеживания ошибок.

You can contribute or join OpenERP team, : https://help.launchpad.net/Teams/Joining

Волонтёры — это те люди, которые хотят помогать проекту становиться лучше, дополнять функциональность и становиться более стабильным. Каждый может внести свой вклад в проект своими знаниями, формируя отчёты об ошибках, предлагая что-то улучшить и публикуя "заплатки".

Команда сообщества доступна на Launchpad: https://launchpad.net/~openerp-community

Участники команд качества и коммитеров автоматически становятся участниками команды сообщества.

Установка Bazaar

Установите систему контроля версия Bazaar, чтобы получать исходный код из Launchpad.

Чтоб установить bazaar на любой дистрибутив ubuntu, вы можете отредактировать /etc/apt/sources.list с помощью

sudo gedit /etc/apt/sources.list

и добавить в него эти строки:

(for ubuntu intrepid 8.10)
deb http://ppa.launchpad.net/bzr/ubuntu intrepid main
deb-src http://ppa.launchpad.net/bzr/ubuntu intrepid main

or (for ubuntu jaunty 9.04)
deb http://ppa.launchpad.net/bzr/ubuntu jaunty main
deb-src http://ppa.launchpad.net/bzr/ubuntu jaunty main

or (for ubuntu karmic 9.10)
deb http://ppa.launchpad.net/bzr/ubuntu karmic main
deb-src http://ppa.launchpad.net/bzr/ubuntu karmic main

Here, interpid, jaunty and karmic are version names of ubuntu. So, replace it with accourding to your ubuntu version.

Затем, проделайте следующее

sudo apt-get install bzr

Для правильной работы, версия bzr должна быть не ниже 1.3. Проверьте с помощью команды:

bzr --version

Если у вас нет как минимум версии 1.3, можете получить её по этой ссылке: http://bazaar-vcs.org/Download В Debian, в любом дистрибутиве, работает версия 1.5, которую вы можете получить по ссылке: http://backports.org/debian/pool/main/b/bzr/bzr_1.5-1~bpo40+1_i386.deb

Если у вас возникли проблемы с Bazaar, пожалуйста, прочитайте ЧаВо про систему контроля версий Bazaar перед тем как задавать вопросы.

Working with Branch

The combination of Bazaar branch hosting and Launchpad's teams infrastructure gives you a very powerful capability to collaborate on code. Essentially, you can push a branch into a shared space and anyone on that team can then commit to the branch.

This means that you can use Bazaar in the same way that you would use something like SVN, i.e. centrally hosting a branch that many people commit to. You have the added benefit, though, that anyone outside the team can always create their own personal branch of your team branch and, if they choose, upload it back to Launchpad.

Это официальный рекомендуемый путь участия в проектах OpenERP и OpenObject.

Краткие итоги

Чтобы получить последнюю версию исходных кодов, сделайте следующее:

bzr branch lp:openerp
cd openerp
./bzr_set.py

Эта команда скачает все компоненты openerp (сервер, клиент, дополнения) и создаст ссылки на модули в дополнениях вашего сервера, чтобы вы могли использовать их напрямую. Вы можете изменить файл bzr_set.py чтобы более точно указать, что требуется загружать. Теперь вы можете редактировать код и фиксировать изменения в вашей локальной ветви.:

EDIT addons/account/account.py
cd addons
bzr ci -m "Testing Modifications"

Как только ваш код будет в достаточной степени соответствовать документу Руководство по программированию, вы можете опубликовать вашу ветвь на launchpad. Возможно, вам понадобится создать учётную запись на launchpad для начала, зарегистрировать ваш публичный ключ, и вступить в команду openerp-community. Теперь, вы можете опубликовать вашу ветвь. Предположим, вы хотите опубликовать ваши дополнения:

cd addons
bzr push lp:~openerp-community/openobject-addons/YOURLOGIN_YOURBRANCHNAME
bzr bind lp:~openerp-community/openobject-addons/YOURLOGIN_YOURBRANCHNAME

Как только вы всё это проделаете, ваша ветвь будет общедоступна на Launchpad в проекте OpenObject, и коммиттеры смогут работать с ней, проверять её и предлагать к объединению с официальной ветвью.Последняя строчка позволяет вам запомнить расположение вашей ветви на launchpad. После этого действия, ваши команды фиксации будут применяться напрямую к коду, находящемуся на launchpad (если только вы не используете параметр --local):

bzr pull    # Get modifications on your branch from others
EDIT STUFF
bzr ci    # commit your changes on your public branch

Если внесённые вами изменения исправляют общедоступную ошибку, описанную на launchpad, следующей командой можно отметить, что ваша ветвь исправляет эту ошибку:

bzr ci --fixes=lp:453123   # Where 453123 is a bug ID

Как только ваша ветвь "созрела", переведите её в состояние "Mature" в веб-интерфейсе, и направьте запрос на объединение с официальным релизом. Ваша ветвь будет проверена коммиттером и затем командой контроля качества, чтобы объеденить ей с официальным релизом.

[Read more about OpenERP Team]

Pushing a new branch

Если вы хотите внести вклад в развитие OpenERP или OpenObject — вот предполагаемый метод:

  • Вы создаёте ветвь на Launchpad, в проекте, который вам интересен. Важно создать свою ветвь именно на Launchpad, а не на локальном компьютере, чтобы вы могли легко объединяться, делиться кодом с проектами и централизовать ваши будущие разработки.

  • Вы разрабатываете собственный функционал или исправляете ошибки в вашей ветви на Launchpad. Не забывайте установить статус для вашей ветви (новая, экспериментальная, разрабатываемая, зрелая, …) чтобы волонтёры знали, что можно использовать, а что — нет.

  • Как только вы решили, что ваш код достаточно хорош - предложите вашу ветвь к слиянию.

  • Ваша работа будет проверена одним ответственным лицом из команды коммиттеров.

    • Если они примут вашу ветвь к интеграции в официальную версию, они пригласят команду контроля качества, которая проверит ваш код и объеденит его с официальной ветвью.

    • Если команда коммиттеров отклоняет вашу ветвь — они объяснят причину, чтобы вы могли пересмотреть ваш код с точки зрения большего соответствия рекомендациям (проблемы при миграциях в будущем, …)

The extra-addons branch, that stores all extra modules, is directly accessible to all commiters. If you are a commiter, you can work directly on this branch and commit your own work. This branch do not require a validation of the quality team. You should put there your special modules for your own customers.

Если вы хотите предложить или разработать новые модули, мы советуем вам создать свою собственную ветвь в проекте openobject-addons и вести разработку в вашей ветви. Вы можете заполнить отчёт об ошибке, чтобы запросить внедрение ваших модулей в одну из следующих ветвей:

  • extra-addons : if your module touches a few companies

  • addons : if your module will be usefull for most of the companies

"Use Case"-Разработка

Как только вы всё это проделаете, ваша ветвь будет общедоступна на Launchpad в проекте OpenObject, и коммиттеры смогут работать с ней, проверять её и предлагать к объединению с официальной ветвью.Последняя строчка позволяет вам запомнить расположение вашей ветви на launchpad. После этого действия, ваши команды фиксации будут применяться напрямую к коду, находящемуся на launchpad (если только вы не используете параметр --local):

bzr pull    # Get modifications on your branch from others
EDIT STUFF
bzr ci    # commit your changes on your public branch

Если внесённые вами изменения исправляют общедоступную ошибку, описанную на launchpad, следующей командой можно отметить, что ваша ветвь исправляет эту ошибку:

bzr ci --fixes=lp:453123   # Where 453123 is a bug ID

Как только ваша ветвь "созрела", переведите её в состояние "Mature" в веб-интерфейсе, и направьте запрос на объединение с официальным релизом. Ваша ветвь будет проверена коммиттером и затем командой контроля качества, чтобы объеденить ей с официальным релизом.

Как зафиксировать свою работу

Если вы хотите внести вклад в развитие OpenERP или OpenObject — вот предполагаемый метод:

  • Вы создаёте ветвь на Launchpad, в проекте, который вам интересен. Важно создать свою ветвь именно на Launchpad, а не на локальном компьютере, чтобы вы могли легко объединяться, делиться кодом с проектами и централизовать ваши будущие разработки.

  • Вы разрабатываете собственный функционал или исправляете ошибки в вашей ветви на Launchpad. Не забывайте установить статус для вашей ветви (новая, экспериментальная, разрабатываемая, зрелая, …) чтобы волонтёры знали, что можно использовать, а что — нет.

  • Как только вы решили, что ваш код достаточно хорош - предложите вашу ветвь к слиянию.

  • Ваша работа будет проверена одним ответственным лицом из команды коммиттеров.

    • Если они примут вашу ветвь к интеграции в официальную версию, они пригласят команду контроля качества, которая проверит ваш код и объеденит его с официальной ветвью.

    • Если команда коммиттеров отклоняет вашу ветвь — они объяснят причину, чтобы вы могли пересмотреть ваш код с точки зрения большего соответствия рекомендациям (проблемы при миграциях в будущем, …)

Ветвь extra-addons, в которой хранятся все дополнительные модули, доступна напрямую всем коммиттерам. Если вы — коммиттер, вы можете работать с этой веткой напрямую и фиксировать свою работу. Эта ветвь не требует проверки командой контроля качества. Вы можете выкладывать в неё специальные модули для ваших собственных заказчиков.

Если вы хотите предложить или разработать новые модули, мы советуем вам создать свою собственную ветвь в проекте openobject-addons и вести разработку в вашей ветви. Вы можете заполнить отчёт об ошибке, чтобы запросить внедрение ваших модулей в одну из следующих ветвей:

  • addons : если ваш модуль будет полезен большинству организаций

  • Мы приглашаем всех наших партнёров и волонтёров работать именно так, чтобы мы могли легко объединять и разделять работу, проводимую среди разных проектов.

"Use Case"-Разработка

Answer Tracker and Bugs Management

We use launchpad on the openobject project to track all bugs and features request related to openerp and openobject. the bug tracker is available here:

Every contributor can report bug and propose bugfixes for the bugs. The status of the bug is set according to the correction.

When a particular branch fixes the bug, a commiter (member of the Commiter Team) can set the status to "Fix Commited". Only commiters have the right to change the status to "Fix Committed.", after they validated the proposed patch or branch that fixes the bug.

The Quality Team have a look every day to bugs in the status "Fix Commited". They check the quality of the code and merge in the official branch if it's ok. To limit the work of the quality team, it's important that only commiters can set the bug in the status "Fix Commited". Once quality team finish merging, they change the status to "Fix Released".

Translation

Translations are managed by the Launchpad Web interface. Here, you'll find the list of translatable projects.

Please read the FAQ before asking questions.

Blueprints

Blueprint is a lightweight way to manage releases of your software and to track the progress of features and ideas, from initial concept to implementation. Using Blueprint, you can encourage contributions from right across your project's community, while targeting the best ideas to future releases.

Launchpad Blueprint helps you to plan future release with two tools:

  • milestones: points in time, such as a future release or development sprint

  • series goals: a statement of intention to work on the blueprint for a particular series.

Although only drivers can target blueprints to milestones and set them as series goals, anyone can propose a blueprint as a series goal. As a driver or owner, you can review proposed goals by following the Set goals link on your project's Blueprint overview page.

By following the Subscribe yourself link on a blueprint page, you can ask Launchpad to send you email notification of any changes to the blueprint. In most cases, you'll receive notification only of changes made to the blueprint itself in Launchpad and not to any further information, such as in an external wiki.

However, if the wiki software supports email change notifications, Launchpad can even notify you of changes to the wiki page.

If you're a blueprint owner and want Launchpad to know about updates to the related wiki page, ask the wiki admin how to send email notifications. Notifications should go to notifications@specs.launchpad.net.

The Buleprints for OpenERP are listed here: