Próiseas scaoilte DjangoLink to this heading

Eisiúintí OiLink to this heading

Ó leagan 1.0, oibríonn uimhriú scaoilte Django mar seo a leanas:

  • Tá leaganacha uimhrithe sa fhoirm A.B` nó A.B.C.

  • Is é A.B an uimhir leagan*scaoileadh gné*. Beidh gach leagan chomhoiriúnach ar ais den chuid is mó leis an eisiúint roimhe seo. Liostófar eisceachtaí ón riail seo sna nótaí scaoilte.

  • Is é `` C`` an uimhir leagain eisiúint paiste, atá incriminte le haghaidh fuascailtí agus eisiúintí slándála. Beidh na heisiúintí seo 100% ar gcúl-comhoiriúnach leis an scaoileadh paiste roimhe seo. Is é an t-aon eisceacht ná nuair nach féidir ceist um shlándáil nó caillteanas sonraí a réiteach gan comhoiriúnacht ar gcúl a bhriseadh. Má tharlaíonn sé seo, cuirfidh na nótaí scaoileadh treoracha mionsonraithe uasghrádaithe ar fáil.

  • Roimh scaoileadh gné nua, déanfaimid eisiúintí alfa, béite agus iarrthóirí scaoilte. Is iad seo den fhoirm A.B alpha/beta/rc N, rud a chiallaíonn an Nth alpha/beta/iarrthóir scaoilte de leagan A.B.

I git, beidh clib ag gach scaoileadh Django a léiríonn a uimhir leagan, sínithe leis an eochair scaoilte Django. Ina theannta sin, tá a bhrainse féin ag gach sraith scaoilte, ar a dtugtar stable/A.B.X, agus eiseofar eisiúintí bugfix/slándála ó na brainsí sin.

For more information about how the Django project issues new releases for security purposes, please see our security policies.

Scaoileadh gnéLink to this term

Tarlóidh eisiúintí gné (AB, AB+1, srl.) thart ar gach ocht mhí - féach próiseas scaoileacha le haghaidh sonraí. Beidh gnéithe nua, feabhsuithe ar ghnéithe atá ann cheana, agus mar sin sna eisiúintí seo.

Scaoileadh paisteLink to this term

Eisfear eisiúintí paiste (ABC, ABC+1, srl.) De réir mar is gá, chun fabhtanna agus/nó saincheisteanna slándála a shocrú.

Beidh na eisiúintí seo comhoiriúnach 100% leis an scaoileadh gné gaolmhar, mura bhfuil sé seo dodhéanta ar chúiseanna slándála nó chun caillte Mar sin an freagra ar “ar cheart dom uasghrádú a dhéanamh ar an scaoileadh paiste is déanaí?” beidh “tá” i gcónaí.

Scaoileadh tacaíochta fadLink to this term

Ainmneofar eisiúintí gné áirithe mar eisiúintí tacaíochta fadtéarmacha (LTS). Cuirfear socruithe slándála agus caillteanas sonraí i bhfeidhm ar feadh tréimhse ráthaithe, trí bliana de ghnáth, leis na heisiúintí seo.

Féach an leathanach íoslódálaí le haghaidh na n-eisiúintí atá ainmnithe le haghaidh tacaíochta fadtéarmach.

Scaoileadh cadenceLink to this heading

Ag tosú le Django 2.0, úsáidfidh uimhreacha leagan foirm scaoilte de `leagan shéimeantach`_ < https://semver.org/> ionas go dtiocfaidh gach leagan tar éis LTS go dtí an chéad leagan eile “ponc nialas” eile. Mar shampla: 2.0, 2.1, 2.2 (LTS), 3.0, 3.1, 3.2 (LTS), srl.

Déanann SEMver níos éasca sracfhéachaint a fheiceáil cé chomh comhoiriúnach atá eisiúintí lena chéile. Cuidíonn sé freisin le súil a thabhairt ar cathain a bhainfear shims comhoiriúnachta. Ní foirm íon de SEMVer é mar leanfaidh cúpla neamhoiriúnacht doiciméadaithe ar chúl ag gach scaoileadh gné nuair nach féidir cosán díscrúdaithe a dhéanamh nó nach fiú an costas. Chomh maith leis sin, tiocfar díghníomhaíochtaí a thosaíodh i scaoileadh LTS (X.2) i scaoileadh neamh-pointe-nialas (Y.1) chun freastal ar ár mbeartas maidir le himeanna díscrúdaithe a choinneáil le haghaidh dhá eisiúint gné ar a laghad. Léigh ar aghaidh go dtí an chéad chuid eile mar shampla.

Polasaí díghníomhaíochtaLink to this heading

Féadfaidh scaoileadh gné gnéithe áirithe a chur as eisiúintí roimhe seo. Má dhíscrítear gné i scaoileadh gnéa.x, leanfaidh sí ag obair i ngach leagan A.x (do gach leagan de x) ach ardóidh sé rabhaidh. Bainfear gnéithe luasaithe sa scaoileadh B.0, nó B.1 le haghaidh gnéithe atá díluaite sa scaoileadh gnéa.X deireanach chun a chinntiú go ndéantar míshuaimhneas thar 2 eisiúint ghné ar a laghad.

Mar sin, mar shampla, má shocraigh muid tús a chur ar dhíscaoileadh feidhme i Django 4.2:

  • Beidh macasamhail den fheidhm atá comhoiriúnach le cúl i Django 4.2 a ardóidh RemovedIndJango51Warning.

  • Beidh an macasamhail atá comhoiriúnach le cúil fós i Django 5.0 (an leagan a leanann 4.2).

  • Bainfidh Django 5.1 an ghné go díreach.

Tá na rabhaidh ciúin de réir réamhshocraithe. Is féidir leat taispeáint na rabhaidh seo a chasadh air leis an rogha python -Wd.

Sampla níos cineálach:

  • X.0

  • X.1

  • X.2 LTS

  • Y.0: Cuireadh shimí díghníomhaíochta titim i X.0 agus X.1.

  • Y.1: Cuireadh shimí díghníomhaíochta titim i X.2.

  • Y.2 LTS: Níor thit aon shims díghabhála (cé nach dtacaítear le Y.0 a thuilleadh, ní mór d'aipeanna tríú páirtí comhoiriúnacht a choinneáil ar ais go X.2 LTS chun uasghrádú LTS go LTS a mhaolú).

  • Z.0: Cuireadh shimí díghníomhaíochta titim i Y.0 agus Y.1.

Féach freisin an treor:ref: deprecating-a-feature.

Leaganacha tacaitheLink to this heading

Ag nóiméad ar bith in am, tacóidh foireann forbróra Django le sraith eisiúintí go leibhéil éagsúla. Féach `rannán na leaganacha tacaíochtaí`_ den le< https://www.djangoproject.com/download/#supported-versions> athanach íoslódála le haghaidh staid reatha tacaíochta do gach leagan.

  • Gheobhaidh an bhrainse forbartha reatha ``main` gnéithe nua agus socruithe fabhtanna a éilíonn athfhabhtú neamh-thráthach.

  • Ní mór paistí a chuirtear i bhfeidhm ar an bpríomhbhrainse a chur i bhfeidhm freisin ar an mbrainse scaoileadh gné deiridh, le scaoileadh sa chéad eisiúint paiste eile den tsraith gné sin, nuair a shocraíonn siad fadhbanna ríthábhachtacha:

    • Saincheisteanna slándála.

    • Bugs caillteanas sonraí.

    • Fachtanna ag titim.

    • Bugs feidhmiúlachta móra i ngnéithe nua den scaoileadh cobhsaí is déanaí.

    • Aischéimnithe ó leaganacha níos sine de Django a tugadh isteach sa tsraith scaoilte reatha.

    Is é an riail ordóg ná go gcuirfear socruithe ar ais chuig an scaoileadh gné deireanach le haghaidh fabhtanna a chuirfeadh cosc ar scaoileadh sa chéad áit (blocálaithe scaoilte).

  • Cuirfear socruithe slándála agus fabhtanna caillteanas sonraí i bhfeidhm ar an bpríomhbhrainse reatha, ar an dá bhrainse scaoileadh gné dheireanacha, agus ar aon bhrainsí scaoileadh tacaíochta fadtéarmacha eile a dtacaítear leo.

  • De ghnáth déanfar socruithe doiciméadaithe a chur ar ais níos saoirse chuig an mbrainse scaoilte Sin toisc go bhfuil sé an-tairbhiúil go mbeadh na doiciméid don eisiúint deireanach cothrom le dáta agus ceart, agus is lú imní é an riosca go dtabharfar aischéimnithe a thabhairt isteach.

Mar shampla nithiúil, smaoinigh ar nóiméad in am leath beatha idir scaoileadh Django 5.1 agus 5.2. Ag an bpointe seo in am:

  • Cuirfear gnéithe leis an bpríomhbhrainse forbartha, le scaoileadh mar Django 5.2.

  • Cuirfear socruithe fabht criticiúla i bhfeidhm ar an mbrainse stable/5.1.x, agus scaoilfear mar 5.1.1, 5.1.2, srl.

  • Cuirfear socruithe slándála agus socruithe fabht maidir le saincheisteanna caillteanais sonraí i bhfeidhm ar main agus ar na brainsí stable/5.1.x, stable/5.0.x`, agus stable/4.2.x` (LTS). Spreagfaidh siad scaoileadh 5.1.1, 5.0.5`, 4.2.8 `, srl.

  • Cuirfear socruithe doiciméadaithe i bhfeidhm ar an bpríomhbhrainse chobhsaí is déanaí, agus, má dhéantar é a aisghabháil go héasca, “5.1.x”.

Próiseas scaoilteLink to this heading

Úsáideann Django sceideal scaoilte bunaithe ar am, le eisiúintí gné gach ocht mhí nó mar sin.

After each feature release, the release manager will publish a timeline for the next feature release. The timeline for an upcoming feature release can be found in the corresponding wiki roadmap page, e.g. https://code.djangoproject.com/wiki/Version6.0Roadmap.

Feature release schedule and stagesLink to this heading

Active development / Pre-feature freezeLink to this heading

Work begins on the feature release A.B after the feature freeze of the previous release, i.e. when the stable/A.B-1.x branch is forked.

You can find the current branch under active development in the Django release process on Trac.

Feature freeze / Alpha releaseLink to this heading

All major and minor features, including deprecations and breaking changes, must be merged by the feature freeze. Any features not done by this point will be deferred to the next feature release.

At this point, the stable/A.B.x branch will be forked from main.

Non-release blocking bug fix freeze / Beta releaseLink to this heading

After the alpha, all bug fixes merged in main are also backported to stable/A.B.x. Refactors are backported at the discretion of the merger. Mergers will be more and more conservative with backports, to avoid introducing regressions.

In parallel to this phase, main can continue to receive new features, to be released in the A.B+1 cycle.

Translation string freeze / Release candidate releaseLink to this heading

If there is still a consistent stream of release blockers coming in at the planned release candidate date, a beta 2 will be released to encourage further testing and the release candidate date will be pushed out ~1 month.

The release candidate marks the string freeze, and it happens at least two weeks before the final release. Translators can then submit updated translations for inclusion in the final release. After this point, new translatable strings must not be added.

After the release candidate, only release blockers and documentation fixes are backported.

Final releaseLink to this heading

Ideally, the final release will ship two weeks after the last release candidate.

If there are major bugs still being found 2 weeks after the release candidate, there will be a decision on how to proceed (likely another release candidate would be issued and the final release date will be pushed out).

Eisiúintí Bug-fixLink to this heading

Tar éis scaoileadh gné (m.sh. A.B), rachaidh an scaoileadh roimhe seo isteach i mód bugfix.

Cuimsíonn an bhrainse don scaoileadh gné roimhe seo (m.sh. stable/A.B-1.x`) fabhtaithe. Caithfear fabhtanna criticiúla atá socraithe ar an bpríomh freis* a shocrú ar an mbrainse bugfix; ciallaíonn sé seo go gcaithfidh tiomanta socruithe fabhtanna a scaradh go glan ó bhreiseanna gné. Beidh an forbróir a thiomnann socrú go príomh freagrach as an socrú a chur i bhfeidhm ar an mbrainse reatha bugfix.