Laravel Maestro Contributor Tutorial

Laravel hutumia Maestro kutengeneza Starter Kits. Maelezo ya jinsi ya kuchangia kwenye starter kits hizi ni machache.

Ikiwa unataka kuongeza vipengele au kurekebisha hitilafu kwenye Starter Kit, unahitaji kuelewa mtiririko wa kazi (workflow). Mwongozo huu unaelezea jinsi ya kutumia Maestro kwa usahihi.

The Directory Structure

Repository ina sehemu tatu kuu:

  • kits/: Hii huhifadhi faili halisi za Starter Kit. Hii ndiyo folda pekee unayopaswa ku-commit.
  • orchestrator/: Hii husimamia mchakato wa build na kuendesha kits.
  • build/: Hii ni eneo la kazi la muda. Maestro hutengeneza folda hii unapofanya build.

The Development Workflow

Usifanye kazi moja kwa moja kwenye folda ya kits/ isipokuwa kama unafanya maboresho kwenye faili nyingi kwa wakati mmoja. Badala yake, fuata hatua hizi:

  1. Sanidi mazingira (Setup the environment) Nenda kwenye folda ya orchestrator/. Run composer install na npm install.

  2. Jenga kit yako unayolenga (Build your target kit) Run php artisan build. Chagua framework, variant, na vipengele (features) vyako. Hii itatengeneza folda ya build/.

  3. Endesha kit (Run the kit) Tumia composer kit:run kutoka kwenye folda ya orchestrator/. Hii itawasha programu kwenye port 8000.

  4. Fanya mabadiliko yako (Make your changes) Fungua folda ya build/. Tafuta faili unazohitaji kubadilisha na uzihariri.

  5. Acha watcher ifanye kazi (Let the watcher work) Maestro hutumia watcher. Unapohifadhi faili kwenye build/, inahuisha faili sahihi kwenye folda ya kits/ kiotomatiki.

  6. Jaribu mabadiliko yako (Test your changes) Kwanza simamisha mchakato wa kit:run. Huwezi kuendesha majaribio (tests) wakati kit ikiwa inafanya kazi. Kutoka kwenye folda ya orchestrator/, run:

  • composer kits:pint (kwa ajili ya formatting)
  • composer kits:check (kwa ajili ya majaribio ya PHP)
  • composer kits:lint (kwa ajili ya majaribio ya JavaScript)
  1. Commit kazi yako (Commit your work) Angalia hali ya git yako (git status). Unapaswa kuona mabadiliko kwenye folda ya kits/. Ongeza folda ya kits/ pekee kwenye commit yako.

Example: Changing text from "Log in" to "Log on"

  • Hariri faili ya blade au component ndani ya build/.
  • Subiri watcher ihuishe kits/.
  • Endesha majaribio ili kuhakikisha hujaingiliana na variant nyingine.
  • Commit faili zilizopo kwenye kits/.

Mchakato huu unahakikisha kuwa mchango wako unabaki kuwa safi na unafuata usanifu (architecture) wa Maestro.

Source: https://dev.to/catatsumuri/laravel-maestro-contributor-tutorial-2p89