Laravel Maestro ಕೊಡುಗೆದಾರರ ಟ್ಯುಟೋರಿಯಲ್
Laravel ಸ್ಟಾರ್ಟರ್ ಕಿಟ್ಗಳನ್ನು (Starter Kits) ನಿರ್ಮಿಸಲು Maestro ಅನ್ನು ಬಳಸುತ್ತದೆ. ಈ ಕಿಟ್ಗಳಿಗೆ ಕೊಡುಗೆ ನೀಡಲು ಬೇಕಾದ ದಾಖಲೆಗಳು (Documentation) ಬಹಳ ಕಡಿಮೆ ಇವೆ.
ನೀವು ಸ್ಟಾರ್ಟರ್ ಕಿಟ್ನಲ್ಲಿ ಹೊಸ ಫೀಚರ್ಗಳನ್ನು ಸೇರಿಸಲು ಅಥವಾ ಬಗ್ಗಳನ್ನು ಸರಿಪಡಿಸಲು ಬಯಸಿದರೆ, ನೀವು ವರ್ಕ್ಫ್ಲೋವನ್ನು (workflow) ಅರ್ಥಮಾಡಿಕೊಳ್ಳಬೇಕಾಗುತ್ತದೆ. ಈ ಮಾರ್ಗದರ್ಶಿಯು Maestro ಅನ್ನು ಸರಿಯಾಗಿ ಹೇಗೆ ಬಳಸುವುದು ಎಂಬುದನ್ನು ವಿವರಿಸುತ್ತದೆ.
ಡೈರೆಕ್ಟರಿ ರಚನೆ (The Directory Structure)
ರಿಪೊಸಿಟರಿ (repository) ಮೂರು ಮುಖ್ಯ ಭಾಗಗಳನ್ನು ಹೊಂದಿದೆ:
kits/: ಇದು ನಿಜವಾದ ಸ್ಟಾರ್ಟರ್ ಕಿಟ್ ಫೈಲ್ಗಳನ್ನು ಹೊಂದಿರುತ್ತದೆ. ನೀವು ಕಮಿಟ್ (commit) ಮಾಡಬೇಕಾದ ಏಕೈಕ ಡೈರೆಕ್ಟರಿ ಇದಾಗಿದೆ.orchestrator/: ಇದು ಬಿಲ್ಡ್ ಪ್ರಕ್ರಿಯೆಯನ್ನು ನಿರ್ವಹಿಸುತ್ತದೆ ಮತ್ತು ಕಿಟ್ಗಳನ್ನು ರನ್ ಮಾಡುತ್ತದೆ.build/: ಇದು ತಾತ್ಕಾಲಿಕ ವರ್ಕ್ಸ್ಪೇಸ್ ಆಗಿದೆ. ನೀವು ಬಿಲ್ಡ್ ರನ್ ಮಾಡಿದಾಗ Maestro ಇದನ್ನು ರಚಿಸುತ್ತದೆ.
ಅಭಿವೃದ್ಧಿ ವರ್ಕ್ಫ್ಲೋ (The Development Workflow)
ನೀವು ಏಕಕಾಲದಲ್ಲಿ ಅನೇಕ ಫೈಲ್ಗಳನ್ನು ಅಪ್ಡೇಟ್ ಮಾಡುತ್ತಿಲ್ಲದಿದ್ದರೆ, ನೇರವಾಗಿ kits/ ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ ಕೆಲಸ ಮಾಡಬೇಡಿ. ಬದಲಾಗಿ, ಈ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ:
ಎನ್ವಿರಾನ್ಮೆಂಟ್ (environment) ಸೆಟಪ್ ಮಾಡಿ
orchestrator/ಫೋಲ್ಡರ್ಗೆ ಹೋಗಿ.composer installಮತ್ತುnpm installರನ್ ಮಾಡಿ.ನಿಮ್ಮ ಟಾರ್ಗೆಟ್ ಕಿಟ್ ಅನ್ನು ಬಿಲ್ಡ್ ಮಾಡಿ
php artisan buildರನ್ ಮಾಡಿ. ನಿಮ್ಮ ಫ್ರೇಮ್ವರ್ಕ್, ವೇರಿಯಂಟ್ ಮತ್ತು ಫೀಚರ್ಗಳನ್ನು ಆಯ್ಕೆಮಾಡಿ. ಇದುbuild/ಫೋಲ್ಡರ್ ಅನ್ನು ರಚಿಸುತ್ತದೆ.ಕಿಟ್ ಅನ್ನು ರನ್ ಮಾಡಿ
orchestrator/ಫೋಲ್ಡರ್ನಿಂದcomposer kit:runಬಳಸಿ. ಇದು ಪೋರ್ಟ್ 8000 ರಲ್ಲಿ ಅಪ್ಲಿಕೇಶನ್ ಅನ್ನು ಪ್ರಾರಂಭಿಸುತ್ತದೆ.ನಿಮ್ಮ ಬದಲಾವಣೆಗಳನ್ನು ಮಾಡಿ
build/ಡೈರೆಕ್ಟರಿಯನ್ನು ತೆರೆಯಿರಿ. ನೀವು ಬದಲಾಯಿಸಬೇಕಾದ ಫೈಲ್ಗಳನ್ನು ಹುಡುಕಿ ಮತ್ತು ಅವುಗಳನ್ನು ಎಡಿಟ್ ಮಾಡಿ.ವಾಚರ್ (watcher) ಕೆಲಸ ಮಾಡಲು ಬಿಡಿ Maestro ಒಂದು ವಾಚರ್ ಅನ್ನು ಬಳಸುತ್ತದೆ. ನೀವು
build/ನಲ್ಲಿ ಫೈಲ್ ಅನ್ನು ಸೇವ್ ಮಾಡಿದಾಗ, ಅದುkits/ಡೈರೆಕ್ಟರಿಯಲ್ಲಿನ ಸರಿಯಾದ ಫೈಲ್ ಅನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಅಪ್ಡೇಟ್ ಮಾಡುತ್ತದೆ.ನಿಮ್ಮ ಬದಲಾವಣೆಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ ಮೊದಲು
kit:runಪ್ರಕ್ರಿಯೆಯನ್ನು ನಿಲ್ಲಿಸಿ. ಕಿಟ್ ರನ್ ಆಗುತ್ತಿರುವಾಗ ನೀವು ಪರೀಕ್ಷೆಗಳನ್ನು (tests) ನಡೆಸಲು ಸಾಧ್ಯವಿಲ್ಲ.orchestrator/ಫೋಲ್ಡರ್ನಿಂದ, ಈ ಕೆಳಗಿನವುಗಳನ್ನು ರನ್ ಮಾಡಿ:
composer kits:pint(formatting ಗಾಗಿ)composer kits:check(PHP ಪರೀಕ್ಷೆಗಳಿಗಾಗಿ)composer kits:lint(JavaScript ಪರೀಕ್ಷೆಗಳಿಗಾಗಿ)
- ನಿಮ್ಮ ಕೆಲಸವನ್ನು ಕಮಿಟ್ ಮಾಡಿ
ನಿಮ್ಮ
git statusಅನ್ನು ಪರಿಶೀಲಿಸಿ. ನೀವುkits/ಫೋಲ್ಡರ್ನಲ್ಲಿ ಬದಲಾವಣೆಗಳನ್ನು ನೋಡಬೇಕು. ಕಮಿಟ್ಗೆkits/ಡೈರೆಕ್ಟರಿಯನ್ನು ಮಾತ್ರ ಸೇರಿಸಿ.
ಉದಾಹರಣೆ: "Log in" ನಿಂದ "Log on" ಗೆ ಪಠ್ಯವನ್ನು ಬದಲಾಯಿಸುವುದು
build/ಒಳಗಿರುವ blade ಅಥವಾ component ಫೈಲ್ ಅನ್ನು ಎಡಿಟ್ ಮಾಡಿ.kits/ಅನ್ನು ಅಪ್ಡೇಟ್ ಮಾಡಲು ವಾಚರ್ ಕಾಯುವವರೆಗೆ ಕಾಯಿರಿ.- ನೀವು ಇತರ ವೇರಿಯಂಟ್ಗಳನ್ನು ಹಾಳು ಮಾಡಿಲ್ಲ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಲು ಪರೀಕ್ಷೆಗಳನ್ನು ರನ್ ಮಾಡಿ.
kits/ನಲ್ಲಿರುವ ಫೈಲ್ಗಳನ್ನು ಕಮಿಟ್ ಮಾಡಿ.
ಈ ಪ್ರಕ್ರಿಯೆಯು ನಿಮ್ಮ ಕೊಡುಗೆಯು ಸ್ವಚ್ಛವಾಗಿರಲು ಮತ್ತು Maestro ಆರ್ಕಿಟೆಕ್ಚರ್ ಅನ್ನು ಅನುಸರಿಸುವುದನ್ನು ಖಚಿತಪಡಿಸುತ್ತದೆ.
ಮೂಲ (Source): https://dev.to/catatsumuri/laravel-maestro-contributor-tutorial-2p89