npm: dasar-dasar, manajer paket untuk React Native dan Node.js

Apa itu npm — manajer paket Node.js?

npm dibuat pada tahun 2010 oleh Isaac Schlueter sebagai solusi untuk mengelola dependensi Node.js. Sejak 2014 npm dikelola oleh perusahaan npm, Inc., yang diakuisisi oleh Microsoft/GitHub pada 2020. Alat ini terdiri dari dua bagian: CLI (baris perintah) untuk menginstal dan mengelola paket, dan Registry — repositori pusat dari semua modul yang dipublikasikan di registry.npmjs.org.

npm Registry — repositori paket terbesar: lebih dari 2 juta paket dan lebih dari 10 miliar unduhan setiap bulan. Setiap paket memiliki versi SemVer, deskripsi, dependensi, lisensi, dan kepenulisan. Publikasi paket sendiri dilakukan melalui npm publish. npm mendukung paket scoped untuk organisasi (@scope/package), repositori privat, dan audit keamanan bawaan.

Node.js versi 18+ menyertakan npm 9+ dengan kinerja yang ditingkatkan, workspaces untuk monorepo, dan mekanisme peer dependencies yang dirancang ulang. Ekosistem npm mencakup JavaScript sisi server, frontend (React, Vue, Angular), pengembangan seluler (React Native), alat build (Webpack, Vite), dan utilitas CLI. npm adalah saluran distribusi utama untuk pustaka JavaScript.

Fitur utama npm

npm install — perintah utama yang membaca package.json dan package-lock.json untuk menginstal semua dependensi di node_modules. Pada saat pertama dijalankan, npm menghitung grafik dependensi, menyelesaikan konflik versi, dan menghasilkan package-lock.json. Perintah npm install <package> menginstal paket tertentu; flag --save-dev menambahkan ke devDependencies, --global — secara global.

npx — pelaksana paket, disertakan dalam npm sejak versi 5.2. npx memungkinkan menjalankan utilitas CLI tanpa instalasi global: npx react-native init atau npx create-react-app my-app. npx mengunduh paket ke cache sementara, menjalankannya, dan membersihkannya setelah selesai. npx juga berguna untuk menjalankan versi tertentu dari alat.

npm audit memindai pohon dependensi untuk kerentanan yang diketahui dari basis data npm. Perintah menampilkan laporan dengan tingkat keparahan (critical, high, moderate) dan merekomendasikan npm audit fix untuk pembaruan otomatis paket yang rentan. npm cache menyimpan paket yang diunduh secara lokal. npm cache clean --force membersihkan cache saat ada masalah instalasi. npm outdated menunjukkan paket yang usang.

# Perintah utama npm
$ npm install
$ npm install react-native-webview --save
$ npm install typescript --save-dev
# Menjalankan tanpa instalasi global
$ npx react-native init MyApp
# Audit keamanan
$ npm audit --fix

Struktur package.json dan manajemen dependensi

package.json — adalah file JSON di root proyek yang mendeskripsikan metadata, dependensi, dan konfigurasinya. Bidang wajib: name (nama unik paket) dan version (versi SemVer, misalnya 1.0.0). File dibuat dengan perintah npm init -y untuk inisialisasi cepat atau secara manual.

Semantic Versioning (SemVer) — standar versi MAJOR.MINOR.PATCH. Versi utama berubah saat perubahan API yang tidak kompatibel, versi minor — saat penambahan fungsionalitas (kompatibel mundur), patch — saat perbaikan bug. Simbol ^ sebelum versi mengizinkan pembaruan versi minor dan patch, ~ — hanya patch.

{
  "name": "my-app",
  "version": "1.0.0",
  "private": true,
  "scripts": {
    "start": "expo start",
    "android": "expo start --android",
    "ios": "expo start --ios"
  },
  "dependencies": {
    "react": "^18.3.0",
    "react-native": "^0.76.0"
  },
  "devDependencies": {
    "typescript": "^5.5.0",
    "@types/react": "^18.3.0"
  }
}

npm dalam pengembangan React Native

React Native proyek aktif menggunakan npm untuk mengelola dependensi. Paket standar mencakup react, react-native, pustaka navigasi (React Navigation), permintaan HTTP (axios), manajemen state (Redux, Zustand), dan komponen UI. npm memungkinkan instalasi ribuan paket yang kompatibel dari repositori.

npx pod-install — perintah wajib setelah menginstal modul native di React Native untuk iOS. npm secara otomatis menghasilkan Podfile.lock berdasarkan package-lock.json. Di proyek Expo, expo install digunakan sebagai pengganti npm install, karena memilih versi yang kompatibel dengan versi Expo SDK saat ini.

Konflik versi — masalah umum di React Native: react-native-reanimated, react-native-gesture-handler, dan react-native-safe-area-context memerlukan versi yang selaras. Solusi — perbarui semua paket ke versi kompatibel terbaru atau gunakan --legacy-peer-deps. package-lock.json sangat penting untuk modul native yang dikompilasi melalui CocoaPods dan Gradle.

Perbandingan npm dengan manajer alternatif

npm — manajer paket standar, termasuk dalam Node.js. Alternatif utama: yarn (dibuat oleh Facebook pada 2016) dan pnpm (cepat, dengan tautan keras). Mulai npm 5, perbedaan kecepatan dan fungsionalitas antara npm dan yarn minimal. npm 7+ menambahkan workspaces, membuatnya kompetitif untuk monorepo.

Menurut State of JS 2025: npm digunakan oleh 62% pengembang, yarn — 35% (terutama proyek lama dan penggemar PnP), pnpm — 3%. Untuk proyek React Native, kedua alat setara, tetapi npm lebih sering ditemukan di proyek Expo SDK 50+ dan inisialisasi React Native baru.

yarn mempertahankan keunggulan di monorepo yang sangat besar (100+ paket) berkat implementasi workspaces dan Plug'n'Play yang lebih matang. pnpm unggul dalam penghematan ruang disk melalui tautan keras ke penyimpanan global. Pemilihan manajer tergantung pada preferensi tim dan infrastruktur.