Zarządzanie wersjami
Podczas tworzenia i aktualizowania wtyczki może być w pewnym momencie konieczne zarządzanie wersjami kodu.
Na przykład interfejsy API programu FormIt mogą się zmieniać w kolejnych wersjach, ale mimo że nowa wersja wtyczki może korzystać z nowych interfejsów API programu FormIt lub WSM, niekiedy warto zachować również możliwość używania wtyczki w starszych klientach.
Od wersji FormIt 18.0 można zaimplementować dla wtyczki zarządzanie wersjami w 3 prostych krokach:
Dodaj plik version.json do katalogu głównego wtyczki.
Określ w pliku version.json poszczególne zgodne wersje programu FormIt oraz katalogi zawierające te pliki wtyczek.
Użyj wewnętrznego numeru wersji programu FormIt, czyli „numeru kompilacji”, który jest podany w programie FormIt w obszarze Informacje > Informacje o programie.
Jak zorganizować zarządzanie wersjami dla wtyczki
Zorganizuj pliki i katalogi wtyczki tak, aby były zgodne z plikiem version.json
Plik version.json powinien wyglądać następująco:
Powyższe ścieżki v18_0 i v19_0 muszą być poprawnymi ścieżkami podrzędnymi z katalogu głównego danego katalogu/repozytorium.
![](https://windows.help.formit.autodesk.com/~gitbook/image?url=https%3A%2F%2F1795299519-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FGqJ6eQNIO6hR4lUfv3kq%252Fuploads%252Fgit-blob-04051fb90ee478939bf170558d20bf280bd4359f%252Fi1.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=7a987509&sv=1)
![](https://windows.help.formit.autodesk.com/~gitbook/image?url=https%3A%2F%2F1795299519-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FGqJ6eQNIO6hR4lUfv3kq%252Fuploads%252Fgit-blob-7c5147b8f4468bf6705dcb05219309f6feb8430a%252Fi3.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=931a4f9f&sv=1)
Dobrym rozwiązaniem jest przeniesienie kodu wtyczki do podkatalogów. W przypadku powyższego pliku version.json struktura katalogów wygląda następująco:
version.json (plik)
v18_0 (katalog)
manifest.json (plik)
plugin.html (plik)
plugin.js (plik)
v19_0 (katalog)
manifest.json (plik)
plugin.html (plik)
plugin.js (plik)
Opcjonalne właściwości wersji to „exactVersion” i „lastVersion”. „exactVersion” wskazuje, że wersja musi być dokładnie zgodna z wersją programu FormIt. „lastVersion” wskazuje ostatnią wersję, którą można uruchomić w programie FormIt.\
Można również używać rozgałęzień/oznaczeń/zatwierdzeń systemu git dla ścieżek.
Jeśli pracujesz z wersją wstępną lub beta programu FormIt i chcesz przetestować zmiany we wtyczce, która współdziała tylko z wersją wstępną:
Wykonaj powyższe czynności, ale użyj nazwy pliku versions_prerelease.json
Jeśli zatwierdzisz w repozytorium wersję versions_prerelease, usuń ją, gdy ta wersja wstępna programu FormIt zostanie opublikowana
W przeciwnym razie przyszłe wersje wstępne programu FormIt będą wczytywać wtyczkę z lokalizacji, która może być przestarzała lub przeznaczona dla starszej wersji.
Last updated