Comment mettre à jour les dépendances de Point Rouge

Mettre à jour les dépendances d’un projet peut être fastidieux. Cependant, négliger la mise à jour des dépendances du projet n’est pas non plus une bonne idée 😬. Dans cet article, je partagerai la façon dont je mets habituellement à jour mes projets, en me concentrant sur Point Rouge comme exemple. Néanmoins, ces étapes peuvent également être appliquées à d’autres projets js/node.

Table des matières

Mise à jour des dépendances du package

Il existe plusieurs façons de mettre à jour les dépendances et j’ai essayé différentes méthodes pour trouver le chemin le plus simple. Une façon de procéder consiste à mettre à jour manuellement chaque package à l’aide de npm install package-name@latest. Cette méthode est la manière la plus simple de mettre à jour. Cependant, ce n’est peut-être pas l’option la plus efficace.

Ma méthode recommandée pour mettre à jour les dépendances consiste à utiliser le Paquet npm-check-updates. Il y a un bon article de freeCodeCamp à ce sujet, donc je n’expliquerai pas les détails de ce que c’est et comment utiliser ce package. Au lieu de cela, je vais vous montrer mon approche typique.

Tout d’abord, installez npm-check-updates paquet à l’échelle mondiale.

npm install -g npm-check-updates

Avant d’effectuer des mises à jour, c’est une bonne idée de vérifier toutes les nouvelles dépendances pouvant être mises à jour.

ncu

La plupart du temps, les dépendances des correctifs peuvent être mises à jour sans affecter du tout le projet. Donc, je mets généralement à jour les dépendances des correctifs en exécutant soit ncu -i --target patch ou ncu -u --target patch. La différence est que ncu -u --target patch mettra à jour tous les correctifs, tandis que ncu -i --target patch donnera une option pour basculer le package à mettre à jour. C’est à vous de décider quelle approche adopter.

La partie suivante consiste à mettre à jour les dépendances mineures. Les mises à jour mineures des packages n’interrompront généralement pas le projet, mais il est toujours bon de vérifier les notes de version des packages respectifs. Ces mises à jour mineures incluent souvent des fonctionnalités intéressantes qui peuvent être appliquées à nos projets.

ncu -i --target minor

Enfin et surtout, il peut y avoir des mises à jour majeures de packages dans les dépendances. Alors, vérifiez le reste des mises à jour des dépendances en exécutant

ncu -i

S’il y a des mises à jour majeures (ou des mises à jour que vous devez encore effectuer), la commande ci-dessus affichera les packages restants. Si le package est une mise à jour de version majeure, vous devez être très prudent car cela interrompra probablement l’ensemble du projet. Par conséquent, veuillez lire très attentivement la note de version (ou) la documentation correspondante et apporter les modifications en conséquence.

Si tu cours ncu -i et je n’ai trouvé aucun autre paquet à mettre à jour, Félicitations !!! vous avez mis à jour avec succès toutes les dépendances de votre projet.

Mise à jour du modèle Point Rouge

Comme d’autres projets open source, Point Rouge évolue avec des corrections de bugs, des mises à jour de fonctionnalités, etc. Donc, si vous utilisez Point Rouge comme modèle, vous souhaiterez peut-être également mettre à jour le modèle lorsqu’il y aura une nouvelle version.

Le fait est que vous avez peut-être déjà mis à jour le modèle en fonction de vos goûts. Par conséquent, je ne peux pas montrer exactement “la solution universelle et parfaite” pour mettre à jour le modèle vers la version la plus récente. Cependant, voici quelques conseils pour mettre à jour le modèle sans casser votre dépôt. Gardez à l’esprit que, la plupart du temps, la mise à jour des dépendances du package peut vous suffire.

Fichiers et répertoires à garder à l’esprit

Dans la plupart des cas, les fichiers et répertoires que vous ne souhaitez peut-être pas remplacer (car vous avez probablement mis à jour ces fichiers) sont src/content/blog/, src/config.ts, src/pages/about.md, et d’autres actifs et styles comme public/ et src/styles/base.css.

Si vous êtes quelqu’un qui ne met à jour que le strict minimum du modèle, vous devriez pouvoir tout remplacer par la dernière version de Point Rouge, à l’exception des fichiers et répertoires ci-dessus. C’est comme le système d’exploitation Android pur et d’autres systèmes d’exploitation spécifiques au fournisseur comme OneUI. Moins vous modifiez la base, moins vous devez mettre à jour.

Vous pouvez remplacer manuellement chaque fichier un par un ou utiliser la magie de git pour tout mettre à jour. Je ne vous montrerai pas le processus de remplacement manuel car il est très simple. Si cette méthode simple et inefficace ne vous intéresse pas, soyez patient avec moi 🐻.

Mettre à jour Point Rouge à l’aide de Git

IMPORTANT !!!

Effectuez les opérations suivantes uniquement si vous savez comment résoudre les conflits de fusion. Sinon, vous feriez mieux de remplacer les fichiers manuellement ou de mettre à jour uniquement les dépendances.

Tout d’abord, ajoutez du papier astro comme télécommande dans votre projet.

git remote add astro-paper https://github.com/satnaing/astro-paper.git

Paiement vers une nouvelle succursale afin de mettre à jour le modèle. Si vous savez ce que vous faites et que vous avez confiance en vos compétences Git, vous pouvez omettre cette étape.

git checkout -b build/update-astro-paper

Ensuite, extrayez les modifications d’astro-paper en exécutant

git pull astro-paper main

Si tu fais face fatal: refusing to merge unrelated histories erreur, vous pouvez résoudre ce problème en exécutant la commande suivante

git pull astro-paper main --allow-unrelated-histories

Après avoir exécuté la commande ci-dessus, vous risquez de rencontrer des conflits dans votre projet. Vous devrez résoudre ces conflits manuellement et effectuer les ajustements nécessaires en fonction de vos besoins.

Après avoir résolu les conflits, testez minutieusement votre blog pour vous assurer que tout fonctionne comme prévu. Vérifiez vos articles, composants et toutes les personnalisations que vous avez effectuées.

Une fois que vous êtes satisfait du résultat, il est temps de fusionner la branche de mise à jour dans votre branche principale (uniquement si vous mettez à jour le modèle dans une autre branche). Félicitations! Vous avez mis à jour avec succès votre modèle vers la dernière version. Votre blog est maintenant à jour et prêt à briller ! 🎉

Conclusion

Dans cet article, j’ai partagé certaines de mes idées et processus de mise à jour des dépendances et du modèle Point Rouge. J’espère sincèrement que cet article s’avérera utile et vous aidera à gérer vos projets plus efficacement.

Si vous avez des approches alternatives ou améliorées pour mettre à jour les dépendances/Point Rouge, j’aimerais avoir de vos nouvelles. N’hésitez donc pas à démarrer une discussion dans le référentiel, à m’envoyer un e-mail ou à ouvrir un ticket. Votre contribution et vos idées sont très appréciées !

Veuillez comprendre que mon emploi du temps est assez chargé ces jours-ci et que je ne pourrai peut-être pas répondre rapidement. Cependant, je promets de revenir vers vous dans les plus brefs délais. 😬

Merci d’avoir pris le temps de lire cet article et je vous souhaite tout le meilleur dans vos projets !