Composerontwikkeling

In dit onderwerp wordt de aanbevolen aanpak beschreven voor het op locatie ontwikkelen van Composer-modules (als Git-opslagplaatsen in de vendor/ directory) en het toevoegen van die modules aan uw belangrijkste project van het Git.

NOTE
Deze richtsnoeren zijn in de eerste plaats van toepassing op algemene referentiearchitectuur (GRA) projecten.

Een ontwikkelingsvertakking voorbereiden

  1. Maak of check de ontwikkelingsvertakking uit in uw belangrijkste Git-opslagplaats.

  2. Vereisen ontwikkelingsversies voor elke module die u handhaaft.

    In dit voorbeeld vertegenwoordigt elke vertakking in de Git-hoofdopslagplaats een versie van het Composer-pakket. De aanbevolen naamgevingsconventie voor Composer-versies in dit scenario is dev- gevolgd door de naam van de tak. Bijvoorbeeld:

    • dev-develop
    • dev-qa
    code language-bash
    composer require client/module-example:dev-develop
    
  3. Als een ander Composer-pakket een specifieke versie van een module vereist (bijvoorbeeld client/module-example 1.0.12), installeert u deze met een alias:

    code language-bash
    composer require 'client/module-example:dev-develop as 1.0.12'
    

    Voor de qa vertakking, vervangen dev-develop with dev-qa.

Pakketten omzetten in Git-opslagruimten

Pakketten bevatten standaard geen .git/ directory. Composer kan pakketten uitchecken vanuit Git in plaats van de vooraf gebouwde Composer-pakketten te gebruiken. Het voordeel van deze aanpak is dat u de pakketten tijdens de ontwikkeling eenvoudig kunt wijzigen.

  1. De module verwijderen uit het dialoogvenster vendor/ directory.

    code language-bash
    rm -rf vendor/client/module-example
    
  2. Installeer de module opnieuw met de opgegeven Git-bron.

    code language-bash
    composer install --prefer-source
    
  3. Controleer of het Composer-pakket nu een Git-opslagplaats is:

    code language-bash
    cd vendor/client/module-example
    git remote -v
    
  4. Meerdere modules in Git-opslagruimten (bijvoorbeeld "client"-modules) in batch omzetten:

    code language-bash
    rm -rf vendor/client
    composer install --prefer-source
    

Ontwikkeling starten

  1. Een functie/werkvertakking maken of uitchecken. In het volgende voorbeeld ziet u een vertakking met dezelfde naam als een Jira-ticket.

    code language-bash
    cd vendor/client/module-example
    git checkout master
    git checkout -b JIRA-1200
    
  2. Nadat u vertakkingen in een module hebt gewijzigd, raadpleegt u de wijzigingen door de Adobe Commerce-cache en statische inhoud te leegmaken.

    code language-bash
    bin/magento cache:flush
    bin/magento module:enable --all --clear-static-content
    

Het hoofdproject bijwerken met uw ontwikkeling

Werk uw hoofdopslagplaats voor Git bij door de composer.lock bestand. Als uw module nieuw is, laat het toe.

# to update your packages and all dependencies of the package
composer update --with-all-dependencies client/module-example
# to update just your package
composer update client/module-example

bin/magento module:enable Client_ModuleExample
git add composer.lock app/etc/config.php
git commit
recommendation-more-help
754cbbf3-3a3c-4af3-b6ce-9d34390f3a60