常见问题-发布流程

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search


简介

本页描述了Dolibarr ERP CRM（法语中的制造流程或供应链）的最新稳定版本的构建与发布流程。

按照不同的时期构建新版本：

开发期 -> 冻结/测试期 -> 最终稳定版本 （有关冻结/测试版本的定义参见页面 Category:RoadMap ）

以下这是对这三个时期的描述。

开发

开发

第一步是软件开发。可以从 GitHub 下载源代码，GitHub网址为 https://github.com/Dolibarr/dolibarr

任何开发者都可以下载源代码和使用 git 为自己工作，并可以提交请求以要求将自己的变更包含在官方源代码中。

有关如何执行这些操作的详细信息，请参见 FAQ Get or update project with GIT 。

Continuous interation

Each time a new request to include a change is submitted, Continuous Integration Tests are done before the change is validated.

Continuous integration Test are included into official sources into directory *tests*. They are run on the Travis platform and can be analyzed here: https://travis-ci.org/Dolibarr/dolibarr/

If a test fails, it will not be validated (see next step).

Validation of new changes

Only people with the grade Dolibarr Yoda can accept to include changes into official development sources. Permissions for this are granted on GitHub

See Dolibarr roles for the list of people with this grade.

Beta period

When enough changes are included into version, and according to planning, the Dolibarr Yoda decide to start the beta. Starting from this point, no new features are added.

See page Category:RoadMap for standard planning of new versions and rules that define what kind of code can be modified or not during a beta period.


Generating the packages is done using the packaging tool makepack_dolibarr.pl. See next chapter for detailed operation done by this tool.

The packaging of final releases

When beta period end (no more serious bugs are reported and opened), the Dolibarr Yoda decide to start the freeze of final version. The name of the version is define to a value X.Y.Z.

Note: Only a Dolibarr Yoda can make this process.

  • Firstly, final Unit Tests are run. If 1 test is wrong, process is stopped here and go back to beta phase.


Once all tests are ok, the following steps are done automatically using the packaging tool makepack_dolibarr.pl :

  • The tool generate (or suggest the command to generate) the ChangeLog file. This file is commited with sources.
  • The tool generates the file filelist-X.Y.Z.xml than contains the list of files of the version with a MD5 signature and value of version. This file is commited with sources.
  • The tool add a Tag that is the name of version (so X.Y.Z) on all files of the official source repository. So starting from now, all files for the dedicated version are known and won't change anymore.
  • The tool build all official distribution packages. Content of such packages match the content of the signature file since it is build during same process. The following packages are built:
    • Package .zip (the main package)
    • Package .tgz
    • Autoinstaller Doliwamp .exe
    • Autoinstaller for Debian/Ubuntu DoliDeb .deb
    • Autoinstaller for Redhat, linuxmint, mandriva DoliRpm .rpm
  • The tool upload the generated signature file filelist-X.Y.Z.xml on the official Dolibarr server. This file can be read by any installed application to check the integrity of the version (even one byte modified will change the signature).
  • The tool upload the generated packaged into the official Dolibarr archive server to have them archived also in a binary form. This archives can be read from page https://www.dolibarr.org/files/stable/
  • The tool upload the generated packaged into the mirror archive servers hosted at https://www.sourceforge.net. This is a mirror hosting, official references remain the Dolibarr archive area and are hosted by the Dolibarr team so at https://www.dolibarr.org/files/stable/.
  • The release is also created on https://GitHub.com/Dolibarr/dolibarr
  • Then people of the Dolibarr community send announcements on different channels (www.dolibarr.org, forums, social networks...).
  • Starting from now, a new cycle can start. A new development period start from sources of the version.

Then a Dolibarr Yoda add 1 page (one page per version) onto the https://wiki.dolibarr.org to describe content of new version. This is the Release announcement. You can look at the page Category:RoadMap for list of past announcements.

At any time, from the menu System Tools / About Dolibarr / Check integrity, an admin user can check and validate integrity of its installed version compared to official reference. The tool calculate signature of each file and compare it with official signature. All removed and modified files are reported.

At any time, a developer can, from Github and using the Tag created at first step of release process, get all files of any stable version.

Retrieved from "https://wiki.dolibarr.org/index.php?title=常见问题-发布流程&oldid=58342"