Aller au contenu principal

Versions et mise à jour CLI

Cette page explique comment vérifier la version installée de ikw, comparer cette version avec les releases publiées et mettre à jour le CLI sans casser un poste de travail.

Vérifier la version installée​

ikw --version

Pour confirmer quel binaire est exécuté par votre terminal :

which ikw

Sur Windows PowerShell :

Get-Command ikw

Vérifier la dernière release disponible​

Les releases npm du CLI sont publiées sous le package @ikawaari/ikw.

Le CLI expose aussi des commandes de release intégrées :

ikw release latest
ikw release dist-tags
ikw release check
npm view @ikawaari/ikw version

Pour voir les canaux publiés :

npm view @ikawaari/ikw dist-tags

Les tags doivent être interprétés comme suit :

TagUsage
latestVersion stable recommandée.
nextPré-release ou candidate de validation. À utiliser seulement pour tester une prochaine version.
beta / rcCanal temporaire lorsque l’équipe prépare une version majeure ou un changement de surface.

Comparer local, npm et exécution ponctuelle​

Utilisez ce bloc pour vérifier rapidement l’état d’un poste :

ikw --version
ikw release check
npm view @ikawaari/ikw version
npm view @ikawaari/ikw dist-tags
npx @ikawaari/ikw@latest --version

Si ikw --version et npx @ikawaari/ikw@latest --version affichent des versions différentes, le binaire installé globalement n’est pas à jour ou votre PATH pointe vers une ancienne installation.

Inspecter une release avant mise à jour​

ikw release inspect latest
npm view @ikawaari/ikw@latest name version dist.tarball dist.integrity engines dependencies

Pour une version précise :

ikw release inspect 0.7.0
npm view @ikawaari/ikw@0.7.0 name version dist.tarball dist.integrity engines dependencies

Vérifiez au minimum :

  • la version publiée ;
  • le tag utilisé (latest, next, beta, rc) ;
  • la version Node requise dans engines ;
  • les dépendances @ikawaari/cli-sdk et @ikawaari/sdk ;
  • l’intégrité npm (dist.integrity).

Les notes de release GitHub suivent le tag ikw/vX.Y.Z quand la version est publiée depuis le dépôt CLI.

Mettre à jour le CLI​

Installation globale npm​

npm install -g @ikawaari/ikw@latest
ikw --version

Pour tester une version sans la conserver :

npx @ikawaari/ikw@latest --version
npx @ikawaari/ikw@latest --help

Utilisation sans installation globale​

npx @ikawaari/ikw@latest --help

Binaire téléchargé​

Si vous utilisez un binaire téléchargé, remplacez l’ancien binaire par la dernière version disponible pour votre plateforme, puis vérifiez :

ikw --version
ikw --help

Vérifier une pré-release​

N’installez pas une pré-release globalement sauf si vous testez explicitement ce canal.

ikw release check-prerelease --tag next
npm view @ikawaari/ikw dist-tags
npx @ikawaari/ikw@next --version
npx @ikawaari/ikw@next --help

Si le test est concluant et que l’équipe vous demande d’utiliser ce canal :

npm install -g @ikawaari/ikw@next
ikw --version

Vérifier que la mise à jour fonctionne​

Après une mise à jour :

ikw --help
ikw login --help
ikw config --help
ikw payments --help

La mise à jour est correcte si :

  • ikw --version affiche la version attendue ;
  • ikw --help affiche la liste des commandes ;
  • les commandes d’aide principales s’exécutent sans erreur ;
  • npx @ikawaari/ikw@latest --help fonctionne si vous utilisez npm.

Résoudre les problèmes courants​

SymptômeAction recommandée
ikw introuvableVérifiez que le répertoire global npm est dans votre PATH.
Ancienne version après updateFermez et rouvrez le terminal, puis relancez ikw --version.
Erreur de permission npmRelancez l’installation avec un répertoire npm global accessible à votre utilisateur.
npx lance une ancienne versionUtilisez npx @ikawaari/ikw@latest --help.
latest ne correspond pas à la version attendueVérifiez npm view @ikawaari/ikw dist-tags ; la release peut être publiée sous next avant promotion.
La commande fonctionne en npx mais pas en globalVérifiez which ikw ou Get-Command ikw, puis corrigez le PATH.

Pages liées​