--- title: "Conas Django a uasghrádú go leagan níos nuaí" version: 6.0 locale: ga source: https://docs.djangoproject.com/ga/6.0/howto/upgrade-version/ canonical: https://djangodocs.dev/ga/6.0/howto/upgrade-version/ --- # Conas Django a uasghrádú go leagan níos nuaí Cé gur féidir leis a bheith ina phróiseas casta uaireanta, tá roinnt buntáistí ag uasghrádú chuig an leagan is déanaí Django: - Cuirtear gnéithe agus feabhsuithe nua leis. - Socraítear fabhtanna. - Ní bhfaighidh leagan níos sine de Django nuashonruithe slándála a thuilleadh. (féach:ref: beartas leaganacha tacaíochtaí). - Má dhéantar uasghrádú de réir mar a bhíonn gach scaoileadh Django nua ar fáil ní bheidh sé chomh pianmhar uasghráduithe sa todhchaí trí do bhunachar cód a choinneáil cothrom le dáta. > **Tools to help with version upgrades** > > Django has a vibrant ecosystem. There are automated upgrade helpers > highlighted on the [Community Ecosystem](https://www.djangoproject.com/community/ecosystem/#upgrade-utilities) > page. Seo roinnt rudaí le breithniú chun cabhrú le do phróiseas uasghrádaithe a dhéanamh chomh réidh agus is féidir. ## Léamh Riachtanach Más é do chéad uair a dhéanann uasghrádú, tá sé úsáideach an: doc: treoir maidir leis na próisis scaoilte éagsúla' a léamh \. Ina dhiaidh sin, ba cheart duit eolas a chur ar na hathruithe a rinneadh sna leaganacha nua Django: - Léigh na:doc: nótaí scaoil do gach scaoile\ adh 'deiridh' ón gceann tar éis do leagan reatha Django, suas go dtí agus san áireamh an leagan a bhfuil sé ar intinn agat uasghrádú air. - Féach ar an amlíne dímheasa le haghaidh na leaganacha cuí. Tabhair aird ar leith ar athruithe neamhchomhoiriúnacha ar ais chun tuairim shoiléir a fháil ar cad a bheidh ag teastáil le haghaidh uasghrádú rathúil. Má tá tú ag uasghrádú trí níos mó ná leagan gné amháin (m.sh. 2.0 go 2.2), is gnách go mbíonn sé níos éasca uasghrádú trí gach scaoileadh gné go chéimiúil (2.0 go 2.1 go 2.2) seachas na hathruithe go léir a dhéanamh do gach scaoileadh gné ag an am céanna. Maidir le gach scaoileadh gné, bain úsáid as an scaoileadh paiste is déanaí (m.sh. le haghaidh 2.1, bain úsáid as 2.1.15). Moltar an cur chuige uasghrádaithe incriminteach céanna agus tú ag uasghrádú ó LTS amháin go dtí an chéad cheann eile. ## Spleithiúlachtaí I bhformhór na gcásanna beidh sé riachtanach uasghrádú a dhéanamh go dtí an leagan is déanaí de do spleáchais a bhaineann le Django freisin. Má scaoileadh an leagan Django le déanaí nó mura ndéantar cuid de do spleáchais a chothabháil go maith, b'fhéidir nach dtacaíonn cuid de do spleáchais leis an leagan nua Django fós. Sna cásanna seo b'fhéidir go mbeidh ort fanacht go dtí go scaoilfear leaganacha nua de do spleáchais. ## Rabhadh dífhabhtaithe a réiteach Sula ndéanfar uasghrádú, is smaoineamh maith é aon rabhaidh dímheasa a d’ardaigh do thionscadal a réiteach agus do leagan reatha de Django á úsáid agat. Cinntíonn sé sin go gcuirtear ar an eolas thú faoi réimsí den chód ar gá iad a athrú má cheartaítear na rabhaidh seo roimh uasghrádú. I Python, cuirtear rabhaidh dímheasa ina dtost de réir réamhshocraithe. Ní mór duit iad a chur ar siúl agus úsáid á baint as an rogha líne ordaithe Python `-Wa` nó as an athróg timpeallachta [`PYTHONWARNINGS`](https://docs.python.org/3/using/cmdline.html#envvar-PYTHONWARNINGS). Mar shampla, chun rabhaidh a thaispeáint agus tástálacha á rith: ```console $ python -Wa manage.py test ``` *Windows* ```doscon ...\> py -Wa manage.py test ``` Mura bhfuil tú ag baint úsáide as an rádala tástála Django, b'fhéidir go mbeadh ort a chinntiú freisin nach bhfuil aon aschur consól a gabhadh a cheilt rabhaidh dímheasa. Mar shampla, má úsáideann tú [pytest](https://docs.pytest.org/): ```console $ PYTHONWARNINGS=always pytest tests --capture=no ``` Réiteach aon rabhaidh dífhabhtaithe le do leagan reatha de Django sula leanann tú leis an bpróiseas uasghrádaithe. D'fhéadfadh feidhmchláir tríú páirtí APIs measartha a úsáid d'fhonn tacú le leaganacha iolracha de Django, mar sin ní gá go léiríonn rabhaidh díluasaithe i bpacáistí atá suiteáilte agat fadhb. Mura dtacaíonn pacáiste leis an leagan is déanaí de Django, smaoinigh ar cheist a ardú nó iarratas tarraingthe a sheoladh air. ## Suiteáil Nuair a bheidh tú réidh, tá sé in am: doc: an leagan nua Django a shuiteáil\ . Má tá a:mod: timpeallacht fhíorúil á úsáid agat agus \is uasghrádú mór é, b'fhéidir gur mhaith leat timpeallacht nua a bhunú leis na spleáchais go léir ar dtús. Má shuiteáil tú Django le [pip](https://pip.pypa.io/), is féidir leat an bratach `--upgrade` nó `-U` a úsáid: ```console $ python -m pip install -U Django ``` *Windows* ```doscon ...\> py -m pip install -U Django ``` ## Tástáil Nuair a chuirtear an timpeallacht nua ar bun, :doc: reáchtáil an t-suite tástála iomlán do d'iarratas. \ Arís, tá sé úsáideach rabhaidh díscrúdaithe a chasadh air ionas go dtaispeánfar iad san aschur tástála (is féidir leat an bratach a úsáid freisin má thástáil tú d'aip de láimh ag baint úsáide as manage.py runserver \`): ```console $ python -Wa manage.py test ``` *Windows* ```doscon ...\> py -Wa manage.py test ``` Tar éis duit na tástálacha a reáchtáil, socraigh aon teipeanna. Cé go bhfuil na nótaí scaoilte úr i d'intinn agat, b'fhéidir gur am maith é freisin leas a bhaint as gnéithe nua i Django trí do chód a athfhabhtú chun deireadh a chur le haon rabhaidh díghrádaithe. If you are upgrading to an alpha, beta, or release candidate, please see our guide on [How to test pre-release versions of Django](/ga/6.0/internals/contributing/bugs-and-features/#testing-pre-releases) for more specific tips about catching regressions and reporting bugs. ## Imscaradh Nuair a bhíonn tú sách muiníneach go n-oibríonn d’aip leis an leagan nua de Django, tá tú réidh le dul ar aghaidh agus : doc: do thionscadal Django uasghrádaithe a imscaradh \. Má tá tú ag úsáid caching a sholáthraíonn Django, ba cheart duit smaoineamh ar do thaisce a ghlanadh tar éis uasghrádú. Seachas sin d'fhéadfadh fadhbanna a bheith ort, mar shampla, má tá rudaí picilte á chaitheamh agat mar ní ráthaítear go mbeidh na rudaí seo comhoiriúnach le picilí ar fud leaganacha Django. Cás neamhchomhoiriúnachta a bhí roimhe seo ná rudaí roghnaithe: class: ~django.http.http.httpResponse a chaitheamh, go díreach nó go hindíreach tríd an maisitheoir: :func: ~django.views.decorators.cache.cache\_page.