package.json என்றால் என்ன?
package.json என்பது உங்கள் Node.js திட்டத்தை விவரிக்கும் ஒரு சிறப்பு கோப்பாகும்.
இது உங்கள் பயன்பாட்டின் பெயர், பதிப்பு, சார்புகள், ஸ்கிரிப்ட்கள் மற்றும் பலவற்றைப் போன்ற தகவல்களைக் கொண்டுள்ளது.
திட்ட மெட்டாடேட்டா
பெயர், பதிப்பு, விவரம் மற்றும் பிற தகவல்கள்
சார்புகள் மேலாண்மை
திட்டத்திற்குத் தேவையான அனைத்து தொகுப்புகளும்
ஸ்கிரிப்ட்கள் வரையறை
திட்டத்தை இயக்குவதற்கான கட்டளைகள்
முக்கிய குறிப்பு:
இந்த கோப்பு Node.js திட்டங்களை நிர்வகித்தல் மற்றும் பகிர்வதற்கு அவசியமானது, குறிப்பாக npm (Node Package Manager) பயன்படுத்தும் போது.
package.json உருவாக்குதல்
உங்கள் திட்ட கோப்புறையில் பின்வரும் கட்டளையை இயக்குவதன் மூலம் package.json கோப்பை உருவாக்கலாம்:
npm init
இந்த கட்டளை உங்கள் திட்டத்தைப் பற்றி தொடர் கேள்விகளைக் கேட்கும் மற்றும் ஒரு package.json கோப்பை உருவாக்கும்.
இயல்புநிலை மதிப்புகளுடன் விரைவான அமைப்பிற்கு, பயன்படுத்தவும்:
npm init -y
package.json எடுத்துக்காட்டு
இங்கே ஒரு package.json கோப்பின் எளிய எடுத்துக்காட்டு உள்ளது:
{
"name": "my-node-app",
"version": "1.0.0",
"description": "A simple Node.js app",
"main": "index.js",
"scripts": {
"start": "node index.js"
},
"author": "Your Name",
"license": "ISC"
}
விளக்கம்:
இந்த கோப்பு பயன்பாட்டை விவரிக்கிறது, முக்கிய கோப்பை index.js ஆக அமைக்கிறது மற்றும் ஒரு தொடக்க ஸ்கிரிப்டை வரையறுக்கிறது.
சார்புகளைச் சேர்த்தல்
நீங்கள் npm உடன் ஒரு தொகுப்பை நிறுவும் போது, அது package.json இன் சார்புகள் பிரிவில் சேர்க்கப்படும்:
npm install express
இந்த கட்டளை Express ஐ உங்கள் திட்டத்தில் சேர்க்கிறது மற்றும் package.json ஐ தானாகவே புதுப்பிக்கிறது.
"dependencies": {
"express": "^5.1.0"
}
பொதுவான package.json புலங்கள்
அடிப்படை மெட்டாடேட்டா
{
"name": "my-package",
"version": "1.0.0",
"description": "A brief description",
"main": "index.js",
"type": "module",
"keywords": ["example", "package"],
"author": "Your Name",
"license": "MIT",
"homepage": "https://example.com"
}
ஸ்கிரிப்ட்கள்
npm run <script-name> உடன் இயக்கக்கூடிய தனிப்பயன் ஸ்கிரிப்ட்களை வரையறுக்கவும்:
"scripts": {
"start": "node index.js",
"dev": "nodemon index.js",
"test": "jest",
"build": "webpack --mode production",
"lint": "eslint .",
"prepare": "husky install"
}
சார்புகள் மற்றும் உருவாக்க சார்புகள்
சார்புகள்
பதிப்பு வரம்புகளுடன் திட்ட சார்புகளைக் குறிப்பிடவும்:
"dependencies": {
"express": "^4.18.2",
"mongoose": "~7.0.0",
"lodash": "4.17.21"
}
உருவாக்க சார்புகள்
உருவாக்கம்-மட்டும் சார்புகள் (உற்பத்தியில் நிறுவப்படவில்லை):
"devDependencies": {
"nodemon": "^2.0.22",
"jest": "^29.5.0",
"eslint": "^8.38.0"
}
பதிப்பு வரம்புகள்
| பதிப்பு | விளக்கம் | எடுத்துக்காட்டு |
|---|---|---|
| ^4.17.21 | 4.x.x உடன் இணக்கமானது (5.0.0 வரை ஆனால் உள்ளடக்காது) | முக்கிய பதிப்பு மாற்றங்கள் இல்லை |
| ~4.17.21 | பேட்ச் புதுப்பிப்புகள் மட்டும் (4.17.x) | சிறிய புதுப்பிப்புகள் மட்டும் |
| 4.17.21 | சரியான பதிப்பு | சரியான பதிப்பு மட்டும் |
| latest | சமீபத்திய நிலையான பதிப்பு | சமீபத்திய பதிப்பு |
| git+https://... | Git களஞ்சியம் | நேரடி Git இணைப்பு |
கூடுதல் புலங்கள்
இயந்திரங்கள்
Node.js மற்றும் npm பதிப்பு தேவைகளைக் குறிப்பிடவும்:
"engines": {
"node": ">=14.0.0 <17.0.0",
"npm": ">=6.0.0"
}
களஞ்சியம் மற்றும் பிழைகள்
"repository": {
"type": "git",
"url": "https://github.com/username/repo.git"
},
"bugs": {
"url": "https://github.com/username/repo/issues"
}
package.json உடன் பணிபுரிதல்
சார்புகளைச் சேர்த்தல்
# Install and save to dependencies
npm install package-name
# Install and save to devDependencies
npm install --save-dev package-name
# Install exact version
npm install package-name@1.2.3
சார்புகளைப் புதுப்பித்தல்
# Update a specific package
npm update package-name
# Update all packages
npm update
# Check for outdated packages
npm outdated
ஸ்கிரிப்ட்களை இயக்குதல்
# Run a script
npm run script-name
# Run start script (can be called with just 'npm start')
npm start
# Run test script (can be called with just 'npm test')
npm test
சிறந்த நடைமுறைகள்
சுருக்கம்
package.json எந்த Node.js திட்டத்தின் இதயமாகும், இது மெட்டாடேட்டா, ஸ்கிரிப்ட்கள் மற்றும் சார்பு தகவல்களைக் கொண்டுள்ளது.
அதன் கட்டமைப்பு மற்றும் புலங்களைப் புரிந்துகொள்வது திறம்பட்ட Node.js உருவாக்கத்திற்கு அவசியமானது.
திட்ட அடையாளம்
பெயர், பதிப்பு, விவரம் மற்றும் பிற மெட்டாடேட்டா
சார்பு மேலாண்மை
அனைத்து தேவையான தொகுப்புகள் மற்றும் பதிப்புகள்
ஸ்கிரிப்ட் வரையறைகள்
திட்ட இயக்கத்திற்கான கட்டளைகள்
திட்டப் பகிர்வு
திட்டத்தைப் பகிர்வதற்கும் நிறுவுவதற்கும் அவசியம்
முக்கிய புள்ளிகள்:
- package.json ஒவ்வொரு Node.js திட்டத்தின் மையமாகும்
- npm init உடன் எளிதாக உருவாக்கலாம்
- சார்புகள் தானாகவே சேர்க்கப்படும் மற்றும் புதுப்பிக்கப்படும்
- ஸ்கிரிப்ட்கள் திட்ட இயக்கத்தை எளிதாக்குகின்றன
- சிறந்த நடைமுறைகளைப் பின்பற்றி பாதுகாப்பை உறுதி செய்யுங்கள்
பயிற்சி
சரியான புலப் பெயரை தேர்ந்தெடுக்கவும்.
package.json இல் உள்ள ______ புலம் உங்கள் பயன்பாட்டின் தொடக்கப் புள்ளியை வரையறுக்கிறது.