How to Get npm Packages
The npm package management tool
npm is included in the Node.js distribution. It is ready to use after installing Node.js.
To confirm if the installation of
npm was successful issue the following command:
> npm -v # Possible output. # 6.14.9
Installing npm packages
To install an
npm package, execute the following command in the project root directory:
> npm install --save protobufjs
The above command will install the
protobufjs into the
/node_modules directory and write the dependencies for this package to the file
package.json file is an
npm manifest file and needs to be included in version control.
Note: Cocos Creator recommends that the automatically generated
package-lock.jsonbe included in version control to ensure that the same version of the package is installed between multiple developers.
/node_modules directory is generally not included in version control.
Once the dependencies have been written into the
package.json, the following commands can be executed directly to reinstall or install in other environments:
> npm install
Expansion: Using npm mirrors
npm reads and downloads packages from the official npmjs source by default. Some countries or regions may have network issues that cause the installation to fail or install too slowly, it is recommended to fix this by switching mirrors.
First, install the
npm package nrm globally:
> npm install -g nrm
-gmeans global, the npm package will be installed directly on the current computer. Once it is done, there is no need to do it again.
To view valid npm images:
> npx nrm ls # Possible output. # * npm -------- https://registry.npmjs.org/ # yarn ------- https://registry.yarnpkg.com/ # cnpm ------- http://r.cnpmjs.org/ # taobao ----- https://registry.npm.taobao.org/ # nj --------- https://registry.nodejitsu.com/ # npmMirror -- https://skimdb.npmjs.com/registry/ # edunpm ----- http://registry.enpmjs.org/
Choose the appropriate mirror according to the current region. The
taobao mirror is a good choice for users in mainland China. Execute the following command to switch mirrors.
> npx nrm use taobao # or any suitable mirror
Note: this command is also global. Optionally, to switch only the mirror of the current project, see the nrm options documentation.
The mirror name
npm is the name of the official source, and can be switched back to the official source with the following command:
> npx nrm use npm