[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Configurez NPM pour pouvoir utiliser PWA Studio

Last update: Tue Aug 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Progressive Web Apps (PWA) Studio est un nouveau projet disponible pour Adobe Commerce sur une infrastructure cloud 2.3.x ou ultérieure. Pour pouvoir utiliser et installer PWA Studio, vous devez définir la version du gestionnaire de packages NPM sur 5.x ou une version ultérieure pour obtenir la prise en charge de Node.js 8.x. Cette opération est effectuée dans la section hooks:build du fichier de configuration .magento.app.yaml.

Environnement et technologies

Adobe Commerce sur l’infrastructure cloud 2.3.X
PWA pour Adobe Commerce

Définir la version du NPM : étapes

Pour définir la version NPM nécessaire, spécifiez-la dans le fichier de configuration .magento.app.yaml. Procédez comme suit :

Sur votre environnement de développement local, recherchez le fichier de configuration .magento.app.yaml.
Ouvrez le fichier pour le modifier à l’aide de votre éditeur de texte brut ou IDE.

Définissez la version requise dans la section hooks:build . Dans l’exemple suivant, la configuration est définie pour installer NPM v9.5.0, la plus élevée disponible pour le moment (4 février 2019) :

code language-yaml

code language-yaml
`hooks: build: \| unset NPM_CONFIG_PREFIX curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.8/install.sh \| bash export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" nvm install 9.5.0`

hooks:
    build: |
        unset NPM_CONFIG_PREFIX
        curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.8/install.sh | bash
        export NVM_DIR="$HOME/.nvm"
        [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
        nvm install 9.5.0

note note

NOTE

Si vous souhaitez exécuter Node.JS dans votre application et pas seulement dans votre build, ajoutez les commandes suivantes pour modifier votre hook de build :

code language-none



echo ‘unset NPM_CONFIG_PREFIX’ >> .environment

echo ‘export NO_UPDATE_NOTIFIER=1’ >> .environment

echo ‘export NVM_DIR=“$MAGENTO_CLOUD_DIR/.nvm”’ >> .environment

echo ‘[ -s “$NVM_DIR/nvm.sh” ] && . “$NVM_DIR/nvm.sh”’ >> .environment

Enregistrez les modifications dans le fichier .
Envoyez le fichier modifié par Git à votre environnement d’intégration.

Les modifications prennent effet après que vous avez envoyé le fichier YAML mis à jour dans Git à l’environnement.

Documentation connexe

Configuration de l’application : points d’extension dans notre guide Adobe Commerce sur les infrastructures cloud.

recommendation-more-help

8bd06ef0-b3d5-4137-b74e-d7b00485808a