{"title":"Conas Django a uasghrádú go leagan níos nuaí","version":"6.1","locale":"ga","docname":"howto/upgrade-version","url":"/ga/6.1/howto/upgrade-version/","canonical":"https://djangodocs.dev/ga/6.1/howto/upgrade-version/","summary":"Upgrading Django to the latest version offers several benefits: New features and improvements become available. Socraítear fabhtanna. Older versions of Django…","html":"<h1>Conas Django a uasghrádú go leagan níos nuaí<a class=\"heading-anchor\" href=\"#how-to-upgrade-django-to-a-newer-version\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Upgrading Django to the latest version offers several benefits:</p>\n<ul class=\"simple\">\n<li><p>New features and improvements become available.</p></li>\n<li><p>Socraítear fabhtanna.</p></li>\n<li><p>Older versions of Django eventually stop receiving security updates\n(see <a class=\"reference internal\" href=\"/ga/6.1/internals/release-process/#supported-versions-policy\"><span class=\"std std-ref\">Leaganacha tacaithe</span></a>).</p></li>\n<li><p>Upgrading with each new release helps keep your code base current and makes\nfuture upgrades smoother.</p></li>\n</ul>\n<aside class=\"admonition-tools-to-help-with-version-upgrades admonition\">\n<p class=\"admonition-title\">Tools to help with version upgrades</p>\n<p>Django has a vibrant ecosystem. There are automated upgrade helpers\nhighlighted on the <a class=\"reference external\" href=\"https://www.djangoproject.com/community/ecosystem/#upgrade-utilities\">Community Ecosystem</a>\npage.</p>\n</aside>\n<p>Seo roinnt rudaí le breithniú chun cabhrú le do phróiseas uasghrádaithe a dhéanamh chomh réidh agus is féidir.</p>\n<section id=\"required-reading\">\n<h2>Léamh Riachtanach<a class=\"heading-anchor\" href=\"#required-reading\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Más é do chéad uair a dhéanann uasghrádú, tá sé úsáideach an: doc: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>treoir maidir leis na próisis scaoilte éagsúla' a léamh &lt;/internals/release-process&gt;.</p>\n<p>Ina dhiaidh sin, ba cheart duit eolas a chur ar na hathruithe a rinneadh sna leaganacha nua Django:</p>\n<ul class=\"simple\">\n<li><p>Léigh na:doc: nótaí scaoil do gach scaoile&lt;/releases/index&gt; 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.</p></li>\n<li><p>Féach ar an <span class=\"xref std std-doc\">amlíne dímheasa</span> le haghaidh na leaganacha cuí.</p></li>\n</ul>\n<p>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.</p>\n<p>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).</p>\n<p>Moltar an cur chuige uasghrádaithe incriminteach céanna agus tú ag uasghrádú ó LTS amháin go dtí an chéad cheann eile.</p>\n</section>\n<section id=\"dependencies\">\n<h2>Spleithiúlachtaí<a class=\"heading-anchor\" href=\"#dependencies\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>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.</p>\n</section>\n<section id=\"resolving-deprecation-warnings\">\n<h2>Rabhadh dífhabhtaithe a réiteach<a class=\"heading-anchor\" href=\"#resolving-deprecation-warnings\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>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ú.</p>\n<p>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 <code class=\"docutils literal notranslate\"><span class=\"pre\">-Wa</span></code> nó as an athróg timpeallachta <span class=\"target\" id=\"index-2\"></span><a class=\"reference external\" href=\"https://docs.python.org/3/using/cmdline.html#envvar-PYTHONWARNINGS\" title=\"(in Python v3.14)\"><code class=\"xref std std-envvar docutils literal notranslate\"><span class=\"pre\">PYTHONWARNINGS</span></code></a>. Mar shampla, chun rabhaidh a thaispeáint agus tástálacha á rith:</p>\n<div class=\"console\" data-console><div class=\"console-panel\" data-platform=\"unix\"><p class=\"console-label\" id=\"console-0-unix-label\">Linux / macOS</p><div class=\"code-block\" data-language=\"console\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code><span class=\"gp\">$ </span>python<span class=\"w\"> </span>-Wa<span class=\"w\"> </span>manage.py<span class=\"w\"> </span><span class=\"nb\">test</span>\n</code></pre></div>\n</div><div class=\"console-panel\" data-platform=\"windows\"><p class=\"console-label\" id=\"console-0-windows-label\">Windows</p><div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows shell\"><code><span class=\"gp\">...\\&gt;</span> py -Wa manage.py test\n</code></pre></div></div></div>\n<p>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ú <a class=\"reference external\" href=\"https://docs.pytest.org/\">pytest</a>:</p>\n<div class=\"code-block\" data-language=\"console\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code><span class=\"gp\">$ </span><span class=\"nv\">PYTHONWARNINGS</span><span class=\"o\">=</span>always<span class=\"w\"> </span>pytest<span class=\"w\"> </span>tests<span class=\"w\"> </span>--capture<span class=\"o\">=</span>no\n</code></pre></div>\n<p>Réiteach aon rabhaidh dífhabhtaithe le do leagan reatha de Django sula leanann tú leis an bpróiseas uasghrádaithe.</p>\n<p>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.</p>\n</section>\n<section id=\"installation\">\n<h2>Suiteáil<a class=\"heading-anchor\" href=\"#installation\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Nuair a bheidh tú réidh, tá sé in am: doc: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>an leagan nua Django a shuiteáil&lt;/topics/install&gt; <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>. Má tá a:mod: <a href=\"#id5\"><span class=\"problematic\" id=\"id6\">`</span></a>timpeallacht fhíorúil á úsáid agat agus &lt;venv&gt;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.</p>\n<p>Má shuiteáil tú Django le <a class=\"reference external\" href=\"https://pip.pypa.io/\">pip</a>, is féidir leat an bratach <code class=\"docutils literal notranslate\"><span class=\"pre\">--upgrade</span></code> nó <code class=\"docutils literal notranslate\"><span class=\"pre\">-U</span></code> a úsáid:</p>\n<div class=\"console\" data-console><div class=\"console-panel\" data-platform=\"unix\"><p class=\"console-label\" id=\"console-1-unix-label\">Linux / macOS</p><div class=\"code-block\" data-language=\"console\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code><span class=\"gp\">$ </span>python<span class=\"w\"> </span>-m<span class=\"w\"> </span>pip<span class=\"w\"> </span>install<span class=\"w\"> </span>-U<span class=\"w\"> </span>Django\n</code></pre></div>\n</div><div class=\"console-panel\" data-platform=\"windows\"><p class=\"console-label\" id=\"console-1-windows-label\">Windows</p><div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows shell\"><code><span class=\"gp\">...\\&gt;</span> py -m pip install -U Django\n</code></pre></div></div></div>\n</section>\n<section id=\"testing\">\n<h2>Tástáil<a class=\"heading-anchor\" href=\"#testing\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Nuair a chuirtear an timpeallacht nua ar bun, :doc: reáchtáil an t-suite tástála iomlán do d'iarratas. &lt;/topics/testing/overview&gt; 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 `):</p>\n<div class=\"console\" data-console><div class=\"console-panel\" data-platform=\"unix\"><p class=\"console-label\" id=\"console-2-unix-label\">Linux / macOS</p><div class=\"code-block\" data-language=\"console\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code><span class=\"gp\">$ </span>python<span class=\"w\"> </span>-Wa<span class=\"w\"> </span>manage.py<span class=\"w\"> </span><span class=\"nb\">test</span>\n</code></pre></div>\n</div><div class=\"console-panel\" data-platform=\"windows\"><p class=\"console-label\" id=\"console-2-windows-label\">Windows</p><div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows shell\"><code><span class=\"gp\">...\\&gt;</span> py -Wa manage.py test\n</code></pre></div></div></div>\n<p>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.</p>\n<p>If you are upgrading to an alpha, beta, or release candidate, please see our\nguide on <a class=\"reference internal\" href=\"/ga/6.1/internals/contributing/bugs-and-features/#testing-pre-releases\"><span class=\"std std-ref\">How to test pre-release versions of Django</span></a> for more specific tips about catching\nregressions and reporting bugs.</p>\n</section>\n<section id=\"deployment\">\n<h2>Imscaradh<a class=\"heading-anchor\" href=\"#deployment\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>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 &lt;/howto/deployment/index&gt;.</p>\n<p>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.</p>\n</section>","rootId":"how-to-upgrade-django-to-a-newer-version","toc":[{"title":"Léamh Riachtanach","anchor":"required-reading","children":[]},{"title":"Spleithiúlachtaí","anchor":"dependencies","children":[]},{"title":"Rabhadh dífhabhtaithe a réiteach","anchor":"resolving-deprecation-warnings","children":[]},{"title":"Suiteáil","anchor":"installation","children":[]},{"title":"Tástáil","anchor":"testing","children":[]},{"title":"Imscaradh","anchor":"deployment","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Treoracha conas","url":"/ga/6.1/howto/"}],"prev":{"docname":"howto/delete-app","title":"Conas feidhmchlár Django a scriosadh","url":"/ga/6.1/howto/delete-app/"},"next":{"docname":"howto/windows","title":"Conas Django a shuiteáil ar Windows","url":"/ga/6.1/howto/windows/"},"formats":{"html":"/ga/6.1/howto/upgrade-version/","markdown":"/ga/6.1/howto/upgrade-version.md","json":"/ga/6.1/howto/upgrade-version.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/howto/upgrade-version.txt","official":"https://docs.djangoproject.com/ga/6.1/howto/upgrade-version/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}