Installation de Node.js

Pour mettre en place Node.js sur une arhcitecture ARM64 (propre à Kylin OS v10), deux méthodes sont envisageables : l'installation manuelle ou l'utilisation d'un gestionnaire de versions.

Méthode 1 : Installation manuelle par binaire

Cette approche consiste à télécharger et lier manuellement les binaires officiels.

# Récupération de l'archive pour architecture ARM64
wget https://nodejs.org/download/release/v18.19.0/node-v18.19.0-linux-arm64.tar.gz

# Extraction des fichiers
tar -zxvf node-v18.19.0-linux-arm64.tar.gz

# Déplacement vers un répertoire système (ex: /usr/local/lib)
sudo mv node-v18.19.0-linux-arm64 /usr/local/lib/nodejs

# Création des liens symboliques pour un accès global
sudo ln -s /usr/local/lib/nodejs/bin/node /usr/local/bin/node
sudo ln -s /usr/local/lib/nodejs/bin/npm /usr/local/bin/npm

Vérifiez l'installation avec node -v et npm -v.

Méthode 2 : Utilisation de NVM (Recommandé)

NVM facilite la gestion de plusieurs versions de Node.js sans conflit de permissions.

# Installation de NVM (via script shell officiel)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Charger NVM dans la session actuelle
source ~/.bashrc

# Installer la version LTS
nvm install 18
nvm use 18

Installation de Visual Studio Code

Pour Kylin OS, il est impératif de télécharger la version Linux ARM64 au format .deb depuis le site officiel de VS Code. Une fois téléchargé, installez-le via le terminal :

sudo dpkg -i code_1.x.x_arm64.deb

Configuration des outils Vue et NPM

L'installation globale de Vue CLI permet d'initialiser rapidement des projets.

# Installation de l'interface de ligne de commande Vue
npm install -g @vue/cli

Pour optimiser la vitesse de téléchargement en fonction de votre région, configurez le registre npm ou utilisez cnpm :

# Définition du miroir npmmirror
npm config set registry https://registry.npmmirror.com

# Installation optionnelle de cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com

Développement avec Electron et Vite

Lors de l'utilisation d'Electron sur une machine ARM64, la récupération automatique des binaires peut parfois échouer. Il est nécessaire de s'assurer que le binaire Electron pour ARM64 est présent dans le cache local.

Le chemin par défaut sur Linux est généralement ~/.cache/electron. Si le projet ne démarre pas, téléchargez manuellement le zip correspondant à la version d'Electron et placez-le dans ce dossier.

Résolution des problèmes de permissions

Si vous utilisez Vue CLI et rancontrez l'erreur vue-cli-service: Permission denied lors du lancement du serveur de développement, ajustez les droits d'exécution sur les binaires du projet :

# Accorder les permissions d'exécution au service Vue CLI
chmod +x node_modules/.bin/vue-cli-service

# Relancer le projet
npm run serve

Pour un projet Vite + Electron, la structure standard de lancement s'appuie sur le script dev définit dans le fichier package.json :

npm run dev