Uitstekend dat je je workflow wilt optimaliseren met Git submodules in SourceTree! Hier zijn gedetailleerde stappen om je submodules effectief te beheren en automatische synchronisatie te waarborgen: 1. **Submodule toevoegen aan je hoofdrepository** - Open je hoofdrepository in SourceTree. - Ga naar het menu **Repository > Submodules toevoegen** (of gebruik de commandoregel: `git submodule add <repository-URL> <pad/naar/submodule>`). - Voer de URL in van je gedeelde utilities repository. - Kies een geschikte mapnaam voor de submodule, bijvoorbeeld `shared-utils`. - Commit de verandering: `git commit -am "Voeg utilities submodule toe"`. 2. **Submodule initialiseren en updaten** - Wanneer je de repo cloneert, voer uit: ```bash git submodule update --init --recursive ``` - In SourceTree: ga naar **Repository > Submodules** en klik op **Initialiseer** en **Update**. 3. **Automatisch synchroniseren instellen** - **Automatische update bij pull**: - In SourceTree kun je niet direct een automatische submodule update instellen bij elke pull. - Maar je kunt een custom hook of een eenvoudige script maken: - Maak een bestand `.git/hooks/post-merge` in je hoofdrepository met de inhoud: ```bash #!/bin/sh git submodule update --init --recursive ``` - Maak het uitvoerbaar: `chmod +x .git/hooks/post-merge`. - Zo wordt na elke merge automatisch de submodule bijgewerkt. 4. **Submodule dependencies op elkaar afstemmen** - Wanneer je de gedeelde utilities bijwerkt: - Ga naar de submodule directory: ```bash cd shared-utils ``` - Voer de updates door: ```bash git checkout <branch/tag/commit> ``` - Commit de nieuwe submodule pointer in je hoofdrepository: ```bash git add shared-utils git commit -m "Update utilities submodule naar nieuwste commit" ``` - In SourceTree: - Selecteer de submodule directory. - Voer de wijzigingen uit en commit dit in de hoofdrepo. 5. **Werkstroom voor ontwikkelaars stroomlijnen** - **Clonen**: ```bash git clone --recursive <hoofdrepository-URL> ``` of na cloning: ```bash git submodule update --init --recursive ``` - **Bijwerken**: - Pull de hoofdrepo: ```bash git pull ``` - Laat automatisch de hook de submodules bijwerken, of voer: ```bash git submodule update --recursive ``` - **Submodule commit en push**: - Na het aanpassen van de submodule, commit de verandering in de hoofdrepo en push. 6. **Gebruik in SourceTree** - Gebruik de **Submodules**-sectie in SourceTree om submodules te beheren. - Maak gebruik van de mogelijkheid om submodules te bekijken, te updaten en te committen via de GUI. - Zorg dat alle ontwikkelaars de hooks hebben ingesteld voor automatische synchronisatie, of communiceer dat ze handmatig `git submodule update --recursive` moeten uitvoeren na pulls. 7. **Extra tips** - Overweeg het gebruik van scripts of CI/CD-pijplijnen om submodules automatisch bij te werken. - Documenteer je workflow voor teamleden, zodat iedereen consistent werkt met submodules. **Samenvatting:** Door submodules toe te voegen, hooks voor automatische updates te gebruiken, en duidelijke workflow-afspraken te maken, kun je je projectstructuur en afhankelijkheden effectief beheren in SourceTree. Zo blijft je hoofdrepository en de submodules synchroon, wat het ontwikkelproces soepel laat verlopen.

Zeker, hier een gedetailleerde handleiding voor het optimaliseren van je SourceTree workflow met Git submodules: ### 1. Submodule Toevoegen aan je Hoofdproject - Open je hoofdrepository in SourceTree - Klik op "Repository" > "Submodule toevoegen" - Voer de URL in van je gedeelde utilities repository - Kies het gewenste pad (bijv. `shared-utilities/`) - Selecteer de gewenste branch (aanbevolen: specifieke branch of tag i.p.v. HEAD) - Klik op "OK" om de submodule toe te voegen ### 2. Submodule Configuratie Optimaliseren Bewerk het `.gitmodules` bestand in je hoofdproject: ```ini [submodule "shared-utilities"] path = shared-utilities url = https://github.com/jouw-gebruikersnaam/shared-utilities.git branch = main update = rebase ``` ### 3. Automatische Synchronisatie Instellen **Voor ontwikkelaars:** - Zorg dat iedereen deze .gitattributes regels toevoegt: ``` *.sh text eol=lf shared-utilities/** ``` **In SourceTree:** - Ga naar "Settings" > "Git" - Vink aan: "Automatisch submodules bijwerken bij pull" - Vink aan: "Recursive submodule initialisatie" ### 4. Dagelijkse Workflow in SourceTree **Bij het starten:** 1. Pull hoofdrepository (Ctrl+P) 2. Klik rechtermuisknop op submodule > "Submodule bijwerken" 3. Selecteer "Recursive update" **Wijzigingen aanbrengen:** 1. Dubbelklik op submodule in SourceTree om deze te openen 2. Maak je wijzigingen in de submodule 3. Commit en push in de submodule repository 4. Ga terug naar hoofdrepository 5. Je ziet nu de submodule wijziging als gewijzigd bestand 6. Commit deze referentiewijziging in hoofdrepository ### 5. Geavanceerde Automatisering **Git Hooks toevoegen:** Maak een post-merge hook (`.git/hooks/post-merge`): ```bash #!/bin/sh git submodule update --init --recursive --remote ``` **In SourceTree acties:** - Maak een custom actie voor submodule updates: - Naam: "Update All Submodules" - Script: `git submodule update --init --recursive --remote` ### 6. Best Practices voor Teamwerk **Communicatie:** - Stel een regel in: submodule wijzigingen altijd eerst pushen - Gebruik betekenisvolle commit messages bij submodule updates **Versiebeheer:** - Gebruik tags in submodules voor stabiele versies - Update submodule referenties alleen na testing ### 7. Probleemoplossing **Submodule status controleren:** - Klik rechtermuisknop op submodule > "Submodule status" - Controleer of submodule op correcte commit staat **Problemen oplossen:** - Submodule reset: `git submodule update --init --force` - Ontkoppelde submodule: verwijder en voeg opnieuw toe ### 8. SourceTree Specifieke Tips - Gebruik de "Submodules" sectie in de zijbalk voor snel overzicht - Stel sneltoetsen in voor vaak gebruikte submodule acties - Gebruik de "Repository List" voor snel schakelen tussen hoofdproject en submodules Deze workflow zorgt voor: - Automatische synchronisatie tussen teamleden - Duidelijke versie-afhankelijkheden - Eenvoudig terugdraaien van wijzigingen - Transparante ontwikkelprocessen Heb je specifieke vragen over een van deze stappen?