Description du problème

Sous macOS, lors de la création d'un projet Vue3 via l'interface en ligne de commande (CLI), le packaging pour le client Android génère une erreur indiquant que l'environnement Node.js n'est pas correctement configuré, même si Node.js est installé sur le système.

Analyse des causes

Lorsque des outils de gestion de versions comme Volta ou nvm sont utilisés pour installer Node.js, les chemins d'accès ne sont pas systématiquement ajoutés aux variables d'environnement du shell. HBuilder exige que les variables d'environnement contenant les emplacements de Node.js et npm soient explicitement définies dans le fichier de configuration du shell, tel que .bash_profile pour Bash ou .zshrc pour Zsh.

Solution

Pour résoudre ce problème, il est nécessaire d'ajouter manuellement les chemins vers Node.js et npm dans le fichier de configuration approprié de votre shell. Les étapes suivantes détaillent cette procédure.

Étape 1 : Vérification du fichier de configuration

Premièrement, vérifiez si le fichier de configuration existe et examinez ses permissions. Utilisez la commande suivante :

if [ -e ~/.bash_profile ]; then
    echo "Le fichier .bash_profile existe."
    ls -l ~/.bash_profile
else
    echo "Aucun fichier .bash_profile détecté."
fi

Si le fichier n'existe pas, il peut être créé avec les commandes appropriées. Si les permissions sont incorrectes (par exemple, appartenant à root), l'édition nécessitera des privilèges élevés.

Étape 2 : Ajout des variables d'environnement pour Node.js

Éditez le fichier ~/.bash_profile pour y insérer le chemin vers l'installation de Node.js gérée par Volta. Adaptez le chemin selon votre configuration. Exemple avec sudo pour les fichiers protégés :

sudo bash -c 'cat <<EOF >> ~/.bash_profile
# Configuration des chemins pour Node.js via Volta
export PATH="/home/votre_utilisateur/.volta/bin:\$PATH"
EOF'

Remplacez /home/votre_utilisateur/.volta/bin par le chemin réel de votre répertoire Volta. Pour d'autres gestionnaires de versions, ajustez le chemin en conséquence.

Étape 3 : Application des modifications

Chargez le fichier de configuration mis à jour pour que les changements prennent effet immédiatement dans la session actuelle :

source ~/.bash_profile

Étape 4 : Validation de la configuration

Vérifiez que Node.js et npm sont correctement accessibles en exécutant :

node --version
npm --version

Ces commandes doivent retourner les versions installées sans erreur.

Notes importantes

• Permissions et propriété des fichiers : Si le fichier de configuration appartient à un autre utilisateur, utilisez sudo chown votre_utilisateur ~/.bash_profile pour modifier la propriété avant édition.
• Chemin d'accès : Assurez-vous que le chemin ajouté correspond exactement à l'emplacement de l'exécutable Node.js. Par exemple, avec Volta, il est généralement dans ~/.volta/bin, tandis que nvm utilise un chemin différent.
• Éviter les doublons : Avant d'ajouter des entrées, consultez le contenu du fichier avec cat ~/.bash_profile ou less ~/.bash_profile pour éviter les configurations redondantes.
• Configuration pour différents shells : Selon votre shell, le fichier à modifier peut vareir. Pour Zsh, éditez ~/.zshrc ; pour Fish, utilisez ~/.config/fish/config.fish.