wiki:Documentatie/Ontwikkelaar/Procedures/BroncodeSVN_Upporten_en_Backporten

Version 45 (modified by bob, 9 years ago) (diff)

--

Forward-porten en back-porten van de broncode

Wat betekend forward-porten en back-porten?

  • forward-porten, ook wel up-porten, is het kopieeren van de instellingen van een lagere versie naar alle hogere versies tot aan de development-versie in de SVN broncode tree. De instellingen waar het om gaat zijn functionaliteit instellingen en tekstverwerker sjablonen.
  • back-porten is het kopieeren van de instellingen van een development-versie naar alle relevante lagere versies in de SVN broncode tree.

De AC's beheerders wijzigen in hun eigen productie-versie bepaalde functionele instellingen en tekstverwerker-sjablonen. Deze instellingen moeten worden overgenomen in een hogere versie tot aan de development-versie. Mocht een beheerder er voor kiezen om een hogere versie in een testomgeving te testen dan krijgen ze de instellingen die ze kennen van hun productie-versie terug en eventueel meer. Door een forward-port-actie van een oude versie naar een hogere versie gaan er sjablonen en functionaliteit verloren als men werkt in een nieuwere versie.

Notabene: Het forward-porten en back-porten is niet gerelateerd met het maken van een nieuwe build van OpenAC3. forward-porten en back-porten is van toepassing op de broncode van OpenAC2.

Wanneer?

  • Hier bij development gebeurt dit periodiek, bijvoorbeeld op een bepaalde dag van de week. Bijvoorbeeld vrijdag.
  • Indien er een verzoek is van een AC dat ze binnenkort een hogere versie willen uitproberen of live gaan naar een hogere versie dan moet iemand hier de forward-port/back-port gaan doen.

De procedure forward-porten/back-porten

  1. Open PyCharm?
  2. Klik linksonder de tabblad "Version control"

  1. Tabblad subversion working copies information

  1. Eerste forward-port actie is de doelstelling om de broncode van v2014 te updaten met de code/settings van branche v2012
  1. Kies "2014 Merge from" Indien je de allereerste keer dit merge scherm gebruikt dan zijn de branches niet geconfigureerd. In dat geval krijg je een dialoog scherm om de branche 2014 te configuren.
  • Klik op "Configure branches link 2014"
  • Selecteer plus

Klik op Ok

Indien je de branche niet hoeft te configureren dan kun je in het popupmenu kiezen

  • Merge with trunk "release /2014"

  1. Kies button Quick Manual Select
  2. Je krijgt een overzicht van alle merges van 2012 van adapties eventueel ook in de kern
  1. Pak de Wiki timelijn erbij.
  2. Kijk naar de laatste changeset nummer. Schrijf de datum op die hierbij hoort en vergelijk dit met het Merge overzicht.
  3. Selecteer vanaf deze datum alle AC aanpassingen uitgezonderd de broncode aanpassingen in development.
  1. Vergelijk dit met dialoogscherm "Merge from v2012"

Hier zie je van hoog naar lage changeset

  1. Zet in het Commit commentaar scherm een beschrijving. Dit is meestal een beschrijving zoals Adriaan dit heeft gedaan.

Om een passende bijschrijving te vinden zoek in de tijdlijn de overeenkomstige forward-port. Bijvoorbeeld de beschrijving "Overnemen van 2014->2016"

  1. Klik de button merge.

Mocht je een dialoogscherm krijgen, wil je de vorige commit changelist bewaren dan kies nee. De vorige commit changelist is de vorige commit van 2014 -> 2016 (in dit geval)

  1. Na de merge commit, kan het zijn dat er merge conflicten worden getoond. In dat geval dien je dit i.s.w. met de auteur

dit op te lossen.

  1. Voordat je begint met een nieuwe merge van 2012 naar 2014 doe een update van source en bestemming versie.

Dit is nodig om een commit fout te voorkomen.